-
Notifications
You must be signed in to change notification settings - Fork 0
Usage
Once logged in, you should can check out your user profile by clicking the "Logged in as ____" link on the top right corner.
To edit your profile, click the Edit link on your profile page.
- Phonetic name - if you plan to use the Twilio VoIP functionality, consider filling out this field if your name is hard to pronounce
- phone number - without a phone number, you can't be assigned to any oncall
- sms email address - for sending sms to your phone (e.g 3109823415@txt.att.net)
- To create a new call list, go to the call lists page and click on New Call List button, or simply browse to : the [https://myserver.com/call_lists/new]
- Give a name and group email for the call list. For example: unix-sa & unix-sa@example.com
- Specify the owners for the call list. Owners will have the ability to add other users to the list. Normal users can always add/remove themselves.
- Specify how you want RingRing to know about the oncall schedule. You can tell RingRing to use its own local calendar (recommended), or give it a remote URL of Confluence Wiki iCal calendar.
- Specify the business hour for your organization. This will be used for the Smart Contact List feature.
Oncall list owners can add users to the list by clicking on the Add Member button.
Normal users can add/remove themselves from lists.
If you're using local oncall calendar, you can add oncall assignments by:
- Clicking on the Add Oncall Assignment
- Click and drag on the calendar for the oncall period
Specify the user you want to assign to be oncall. Edit start and end date if needed. For the retry field, specify the number of time you want Twilio to retry calling the oncall person before escalating to the next person.
You can drag and drop the oncall assignments on the calendar to change the dates. You can also extend or shrink the oncall period by clicking and dragging the tail of the oncall period.
- To enable this feature, click on the Edit Call List button. Select the Automatically assign oncall assignments? option. Specify your oncall assignments cycle. Save your changes.
- With this feature enabled, ringring will run daily and generate oncall assignments for up to 5 weeks in advance. The assignments will be done using a round-robin method and it will only assign oncalls to members who have been specified as oncall candidates.
- Auto-assignments feature will not delete or alter any existing assignments.
- You can change the start date of the oncall auto-assignment anytime and force it to run immediately by clicking on the "Run oncall auto-assignment now" link.
This feature allows you to escalate the oncall if the oncall doesn't pick up the phone. You can add as many escalations as you want. You can drag and drop to order them however you like. It is recommended to have at least 1 oncall escalation entry.
This feature allows you to set up a smart contacts list that can be integrated with other tools such as Sympa. With smart contacts, you can generate a list of contact info based on whether it's business hour or off hour. This functionality allows tools like Sympa to send emails or sms to the oncall list in an efficient manner. Currently, the support contact types are
- group_email - if used, the generated smart contacts list will include the group's email. For example: unix-sa@example.com
- member_emails - if used, the generated smart contacts list will include all the members' emails. For example: ddao@example.com and pobrien@example.com
- member_sms - if used, the generated smart contacts list will include all the members' sms contact. For example: 3108635450@messaging.nextel.com and 3104632155@txt.att.net
- oncall_email - if used, the generated smart contacts list will include the email of the oncall person
- oncall_sms - if used, the generated smart contacts list will include the sms contact of the oncall person
Note: This feature is only for oncall list that uses local calendar.
On the calendar, click on the Export iCal button. This will take you to a URL that you can put into your favorite iCal calendar client.
Want it to support a different calendar format? Send us a request, or better yet, open up the source code and add it yourself!