RingOut Click-to-Call with Status Tracking
A 3-step recipe with RingCentral. We can help you get access.
Recipe · 3 steps
RingOut Click-to-Call with Status Tracking
with RingCentral
Place a RingOut call, track it to connected, and cancel it if it fails to connect.
- Create the RingOut. RingCentral immediately returns a RingOut resource with an id and an initial status for the overall call and for each leg.
- Poll the RingOut status resource. `callStatus` reports "InProgress" while the legs are being connected, "Success" once both parties are bridged, and a failure value when the call cannot be completed.
- Cancel the RingOut so no leg is left ringing after the call failed to connect. This is the cleanup an integrator must run to avoid orphaned 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 placing the call. Use "~" for the extension associated with the current authorization session.
- fromPhoneNumber: The agent's phone number in E.164 format. This leg is called first.
- toPhoneNumber: The destination phone number in E.164 format. This leg is dialed once the agent's leg answers.
- callerIdPhoneNumber: The RingCentral number presented as caller ID to the destination party.
- playPrompt: Whether to play the "press 1 to connect" prompt to the agent's leg before bridging.
For your developer
Arazzo workflow ringcentral:ringout-click-to-call, 3 operations: createRingOutCall → readRingOutCallStatus → deleteRingOutCall. Specs on APIs.io.