The inbound webhooks are triggered when an inbound call event occurs.
Subscribe to this webhook on the Administration > Webhooks page. For more information, refer to Webhooks in the Voiso Documentation Portal.
| Event | Description |
|---|---|
| inbound.call.answered | An agent answers an inbound call. |
| inbound.call.hangup | An inbound call ends. |
| inbound.call.ended | An inbound call is completed. |
Call answered
The Inbound Call Answered webhook POSTs the following request when an inbound call is answered. Refer to Webhooks overview for descriptions of the common objects used by this webhook.
{
"event": "inbound.call.answered",
“object: "call",
"timestamp": "2024-05-24T08:36:39Z",
“secret”: "45XXYYZZa08",
"contact_center_id": "187edc75-3008-44e3-8798-aa0bbc12yt703"
"data": {
//call object
//agent object
}
Example
{
"event": "inbound.call.answered",
"object": "call",
"timestamp": "2024-08-14T10:43:54Z",
"secret": "12t78y34uidd33esqsve",
"contact_center_id": "12345054-2f06-476d-93a1-ae22bd3db4d7",
"data": {
"id": "c123b7f3-86c8-4c8c-b671-a857550abc33",
"type": "inbound",
"start_time": "2024-08-14T10:43:38Z",
"agent_start_time": "2024-08-14T10:43:54Z",
"duration": {
"total": 16,
"queue_time": 16
},
"queue": "Sales Queue",
"script": "Sales Script",
"calling_number": "1234567898",
"called_number": "23456957701",
"cdr_url": "https://cluster1.voiso.com/cdr/c436b7f3-86c8-4c8c-b671-a123450ede33",
"agent": {
"id": 13242,
"name": "Mary Louis",
"email": "[email protected]",
"extension": "2584"
}
}
}
Call hangup
The Inbound Call Hangup webhook POSTs the following request when an inbound call is hungup. Refer to Webhooks overview for descriptions of the common objects used by this webhook.
{
"event": "inbound.call.hangup",
“object: "call",
"timestamp": "2024-05-24T08:36:39Z",
“secret”: "45XXYYZZa08",
"contact_center_id": "187edc75-3008-44e3-8798-aa0bbc12yt703"
"data": {
//call object
//agent object
}
Example
{
"event": "inbound.call.hangup",
"object": "call",
"timestamp": "2024-08-14T10:44:17Z",
"secret": "ybtabc12by8yn8",
"contact_center_id": "12345054-2f06-444d-93a1-ae22bd3db4d7",
"data": {
"id": "c123b7f3-86c8-4c8c-b671-a857550abc33",
"type": "inbound",
"start_time": "2024-08-14T10:43:38Z",
"end_time": "2024-08-14T10:44:17Z",
"agent_start_time": "2024-08-14T10:43:54Z",
"duration": {
"total": 39,
"queue_time": 16,
"talk_time": 23
},
"disposition": "Answered",
"queue": "Service Queue",
"end_reason": "Agent disconnect",
"script": "Service Script",
"calling_number": "2345678458",
"called_number": "123482957701",
"cdr_url": "https://cluster1.voiso.com/cdr/c436b7f3-86c8-4c8c-b671-a857550ede33",
"agent": {
"id": 13242,
"name": "Mary Louis",
"email": "[email protected]",
"extension": "2584"
}
}
}
Call ended
The Inbound Call Ended webhook POSTs the following request when an inbound call is ended. Refer to Webhooks overview for descriptions of the common objects used by this webhook.
{
"event": "inbound.call.ended",
“object: "call",
"timestamp": "2024-05-24T08:36:39Z",
“secret”: "45XXYYZZa08",
"contact_center_id": "187edc75-3008-44e3-8798-aa0bbc12yt703"
"data": {
//call object
//agent object
}
Example
{
"event": "inbound.call.ended",
"object": "call",
"timestamp": "2024-08-12T07:05:09Z",
"secret": "sgc2g83gii9",
"contact_center_id": "1a234567-b8c9-012a-3456-b7c8de90a1b2",
"data": {
"id": "1a234567-b8c9-012a-3456-b7c8de90a1b2",
"type": "inbound",
"start_time": "2024-08-12T07:04:26Z",
"end_time": "2024-08-12T07:05:04Z",
"agent_start_time": "2024-08-12T07:04:38Z",
"duration": {
"total": 38,
"queue_time": 5,
"talk_time": 20,
"hold_time": 5,
"postcall_time": 6
},
"disposition": "Answered",
"queue": "Sales",
"end_reason": "Agent disconnect",
"flow": "sales inbound",
"calling_number": "123456789090",
"called_number": "909087654321",
"wrap_up_code": {
"code": "0003",
"description": "Contract updated"
},
"notes": "Contact requested a contract review.",
"cdr_url": "https://cluster1.voiso.com/cdr/1a234567-3456-012a-b8c9-b7c8de90a1b2",
"agent": {
"id": 1,
"name": "Kathy M",
"email": "[email protected]",
"extension": "1234"
}
}
}