Inbound call events

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.

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": "ml@example.com",
      "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": "ml@example.com",
      "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": "kathy.m@example.com",
      "extension": "1234"
    }
  }
}