Read and Update User Presence
A 2-step recipe with RingCentral. We can help you get access.
Recipe · 2 steps
Read and Update User Presence
with RingCentral
Inspect an extension's presence and telephony state, then set status and DND.
- Read the extension's current presence. detailedTelephonyState and sipData are requested so the caller can see whether the user is actually on a call before overwriting their status.
- Apply the new presence. userStatus drives what colleagues see, while dndStatus controls whether the extension keeps receiving direct and department calls.
What you'll need to have ready
- accountId: Internal identifier of the RingCentral account. Use "~" for the account associated with the current authorization session.
- extensionId: Internal identifier of the extension whose presence is being managed. Use "~" for the extension associated with the current authorization session.
- userStatus: The presence status to set. One of Offline, Busy, Available.
- dndStatus: Do-not-disturb policy to set. One of TakeAllCalls, DoNotAcceptDepartmentCalls, TakeDepartmentCallsOnly, DoNotAcceptAnyCalls, Unknown.
- message: Free-text status message shown alongside the presence status.
For your developer
Arazzo workflow ringcentral:read-and-update-presence, 2 operations: readUserPresenceStatus → updateUserPresenceStatus. Specs on APIs.io.