OnCall Platform¶
The RingRx OnCall platform is a powerful, reliable solution for managing complex multi-schedule OnCall teams
How OnCall works¶
The OnCall platform starts from an OnCall group. A group will typically represent a department or team with shared responsibilities inside a clinic or hospital.
An OnCall group will then have one or more shifts, however it is extremely common for a single group to have many of both, often overlapping.
OnCall Call Flow¶
An OnCall group will operate in one of two modes.
Oncall Mode
¶
This mode answers the call, collects a message and utilizes the full platform auditing capabilities. This is most commonly used when the OnCall group will be called by patients or otherwise should be triad.
User dials in to OnCall system and is greeted by the OnCall platform
User is prompted to describe their problem and enter a call-back number
The recorded message is immediately preserved along with the callback number in case the call becomes disconnected from here.
Now we evaluate who is OnCall at the exact moment of the call.
What shift is active
Who is the first provider on that shift
What is that provider contact preference
If the OnCall provider has opted to receive notifications via Email or SMS about new OnCall messages these will be dispatched now only to the first provider in the list for the shift.
- If Patch
We will immediately try to reach the provider by the method specified in their contact preference
When they answer the call to their preferred method, they will be greeted by the OnCall platform
They will be challenged for their OnCall PIN to ensure we are talking to the provider before any PHI is exchanged
Once they have authenticated themselves, we will play the recorded message, and give them options to: #. Connect the held caller #. Hear the users callback number #. End the call (The caller will be informed that a provider will call them back)
- If Relay
We will inform the caller that a provider will call them back, then terminate the call and begin trying to contact the OnCall provider
When they answer the call to their preferred method, they will be greeted by the OnCall platform
They will be challenged for their OnCall PIN to ensure we are talking to the provider before any PHI is exchanged
Once they have authenticated themselves, we will play the recorded message, and give them options to: #. Hear the users callback number #. End the call (The caller will be informed that a provider will call them back) #. Call the caller back at their contact number
If the message has not been marked as read after so many attempts, we will move on to the next provider on shift.
When we run out of providers on shift, we will stop trying.
Router Mode
¶
This mode leverages the multi-tiered scheduling capabilities of the system to just dispatch the call to the scheduled user but otherwise does not get involved in the call.
User dials in to OnCall system
Now we evaluate who is OnCall at the exact moment of the call.
What shift is active
Who are the providers on that shift in order
We will now begin ringing each provider on that shift, in order according to their personal OnCall preferences (which device, how long)
If a provider answers, we are done
if no provider answers, the call goes to the OnCall voicemail box
OnCall Group Settings¶
The OnCall group has global settings that define its behavior
Shift Alarm Minutes
¶
How many minutes to look forward looking for a time where there will not be anyone OnCall. This will dispatch an alarm email
Music On Hold
¶
What media file to play to the caller while the group locates an OnCall provider
Mailbox
¶
What mailbox will be used to store the OnCall messages.
All users on all shifts will be implicitly delegated access to this mailbox
Record Calls
¶
This will cause OnCall calls themselves to be recorded (This includes the outbound relay attempts)
Play Recording Announcement
==============================+
If recording is enabled, this will play a warning to the caller that the call will be recorded.
Repeated Shifts¶
Repeated shifts will occur on the same day, from the same time, to the same time, every single week.
Start Time
¶
The time of day (in your local timezone) that the shift begins
Providers
¶
One or more users that will be on-call when this shift is active. Order matters here as the top one will be called first.
Important
Repeated shifts may not cross midnight. If you want one to go overnight, you must make two, one from midnight to its AM end, and one from its PM start until 11:59
One-Time Shifts¶
One-time shifts have a specific start time (Year, month, day, hour, minute) and a specific end time ((Year, month, day, hour, minute) and once the end time has passed, these will never be valid again.
Start Date Time
¶
The date and time of day (in your local timezone) that the shift begins
End Date Time
¶
The date and time of day (in your local timezone) that the shift ends
Shift selection¶
As you can see, it is possible to build a complex series of overlapping schedules.
RingRx OnCall uses a most-specific-wins algorithm. This means:
When multiple shifts cover the same point in time, we take the shift that covers the smallest portion of time
One-time shifts take precedence over repeated as they are more specific
Provider contact¶
Once a shift has been identified we need to identify how to contact the user that is actually on call. Details on Provider OnCall profiles can be found in that section: OnCall Settings
Users have rules that very closely resemble Repeated Shifts
- Name
A name for the rule
- list of days
These are which days we will apply the rule on.
- start time
The time of day (in your local timezone) that the shift begins
- end time
The time of day (in your local timezone) that the shift ends
- Method
How should the user be called (Ring my phone, Simultaneous, Sequential, Forward) these are the same behaviors for routing your calls under “My Phone”
- Call Handling
Specify if you want OnCall callers to be held on the line during the initial call while you are called, or if you want the call to terminate and just have the message relayed to you
Important
OnCall user rules may not cross midnight. If you want one to go overnight, you must make two, one from midnight to its AM end, and one from its PM start until 11:59