question

Nanda Mangati avatar image
Nanda Mangati asked Phong Vu answered

Warm transfer and Conference calls - detect them and get all the related call recordings.

We subscribe to webhooks for each extension and log all incoming/outgoing calls along with the call recording.

In case of warm transfer/conference calls, each call is treated as a separate call as the session ids are different, but logically from the customer perspective, it is just one call. Based on the webhook data and also from the call log API, I could not find a reliable way to link these calls.

We are currently subscribed to the below webhook event:

/restapi/v1.0/account/~/extension/~/presence?detailedTelephonyState=true

and using the below API endpoint to fetch call log

/restapi/v1.0/account/~/call-log?sessionId={1}&view=Detailed

Please let us know if there is a way to acheive this.

rest apiwebhooks
1 comment
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Nanda Mangati avatar image Nanda Mangati commented ·

@Phong Vu I have seen you mentioning telephony session event here. Is there a document explaining how we can do this?

0 Likes 0 ·

1 Answer

Phong Vu avatar image
Phong Vu answered

The '/presence?detailedTelephonyState=true' event filter won't give you all details of a call session. Use the /telephony/sessions/ event filter instead.

Look for an event like this to determine a warm transfer event and map the session ids or telephony session ids.

Remember that a call recording is not automatically continued (if auto-recording feature is not enabled) after the call is transferred to a new agent.

{
  "body":{"sequence":9,
    "sessionId":"600398999016", // origin session id
    "telephonySessionId":"s-6885fcf7ff48428db455027955a59901", // origin tel session id
    "parties":[
      {
        "accountId":"80964xxxx","extensionId":"59586xxxx",
        "id":"p-6885fcf7ff48428db455027955a59901-2",
        "direction":"Inbound",
        "to":{"phoneNumber":"+1209248xxxx","name":"Agent 120","extensionId":"59586xxxx"},
        "from":{"phoneNumber":"+1650513xxxx","name":"Phong Vu"},
        "status":{
          "code":"Gone",
          "reason":"AttendedTransfer",
          "peerId":{
            "telephonySessionId":"s-5e9ea55d51ca43c5b555093b98e6be64", // new tel session id
            "sessionId":"600400135016", // new session id
            "partyId":"p-5e9ea55d51ca43c5b555093b98e6be64-1" // new party id
            },
          "rcc":false
        },
        "park":{},"missedCall":false,"standAlone":false,"muted":false}],"origin":{"type":"Call"}}
}
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys