Session updates
If you hadn't yet read the intro part of this section, please click here to read it first.
The following web hook will receive multiple requests during a single call flow. The number of requests will increase according to the number of call flow interactions you have. A call flow will generate at least 10 session updates during a single session call flow.
Module Usage
Setup Overview
Click the Create a new scenario button to create a new scenario, the following view will appear:
Cloudonix Connection Setup
In the search box write Cloudonix to look for the Cloudonix application you installed. We will now create a
new Call Detail Records trigger:
The following image will appear on your view canvas:
Click the Create a webhook button to create a new CDR webhook.
Give a unique name to your new webhook and click the Add button, to create a new connection to Cloudonix. The following dialog will appear:
Make sure to paste your Domain API Key that you created.
You are now ready to start working on your external voice application.
Webhook Input Parameters
TL;DR Reference
While the complete JSON object input includes multiple parameters, the following table includes that most common parameters used.
| Parameter | Type | Description |
|---|---|---|
| callerId | String | The SIP From Header in human readable form. |
| destination | String | The SIP To Header in human readable form. |
| domain | String | The Cloudonix domain name |
| direction | String | Was the voice application executed by an Inbound Call, Outbound Call or Call from Voice Application |
| callStartTime | Integer | Epoch based timestamp of the call start time. |
| callEndTime | Integer | Epoch based timestamp of the call end time. |
| callAnswerTime | Integer | Epoch based timestamp of the call media establishment time. |
| token | String | A unique identifier for this session. This is important - when reporting an issue to Cloudonix, this token will help identify the problematic session and will enable faster resultion. |
Input Reference
When invoked, a JSON object will be made available to Make.com, that looks like this:
Session Update Parameters
[
{
"id": 9844644,
"domainId": 755,
"domain": "xxxxxxx.yyyyyyyy.com",
"subscriberId": null,
"destination": "iiiiiiii",
"callerId": "jjjjjjjj",
"direction": "application",
"token": "b9ba6902c139480eb729e2fa41aaa5ab",
"createdAt": "2024-05-26T07:30:21Z",
"modifiedAt": "2024-05-26T07:30:25Z",
"timeLimit": null,
"status": "connected",
"vappServer": "172.24.xxx.xxx",
"callStartTime": 1716708621946,
"startTime": "2024-05-26T07:30:21.946Z",
"callAnswerTime": 1716708625343,
"answerTime": "2024-05-26T07:30:25.343Z",
"profile": {
"inbound-trunk-id": 610,
"inbound-trunk-name": "fromTrunk-xxx.xxx",
"callId": [
"7ee13e064200e0c33453b854384fe449@xxx.xxx.xxx.xxx:5060"
],
"qos": {
"CHANNELQOS": "ssrc=1772691093;themssrc=0;lp=0;rxjitter=0.000000;rxcount=0;txjitter=0.000000;txcount=167;rlp=0;rtt=0.000000;rxmes=0.000000;txmes=0.000000",
"ssrc": "1772691093",
"themssrc": "0",
"lp": 0,
"rxjitter": 0,
"rxcount": 0,
"txjitter": 0,
"txcount": 167,
"rlp": 0,
"rtt": 0,
"rxmes": 0,
"txmes": 0,
"rx_mos": "NaN",
"tx_mos": 4.4
},
"application": [
{
"time": "2024-05-26T07:30:25Z",
"url": "https://hook.eu1.make.com/ml2u7j35hid88toh41diir5tnocmj9w7",
"source": "[Your Voice Application CXML document]",
"context": "applicationRequest",
"error": null
}
]
},
"action": "updated",
"reason": "vapp",
"eventId": "9e938c49-6c37-40c7-a6b0-c16a625088f2"
}
]