Outbound call events

The outbound webhooks are triggered when a manually dialed or click-to-call voice 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 Outbound Call Answered webhook POSTs the following request when an outbound call is answered. Refer to Webhooks overview for descriptions of the common objects used by this webhook.

 {
  "event": "outbound.call.answered",
  “object: "call",
  "timestamp": "2024-05-24T08:36:39Z",
  “secret”: "45XXYYZZa08",
  "contact_center_id": "187adc75-3008-44t3-8798-aa0bbc12yt999" 
  "data": {
          //call object 
          //agent object 
          }

Example

{
  "event": "outbound.call.answered",
  "object": "call",
  "timestamp": "2024-08-14T09:48:11Z",
  "secret": "htuGG937kQp",
  "contact_center_id": "12348054-2f06-476d-93a1-ae22bd3db4d7",
  "data": {
    "id": "c4d27999-e3f4-4dc8-1234-2cc83644a1b9",
    "type": "outbound",
    "start_time": "2024-08-14T09:48:09Z",
    "duration": {
      "total": 2,
      "dialing_time": 2
    },
    "calling_number": "41106695555",
    "called_number": "31106695555",
    "ext_user_id": "00Q5e00000NslwPEAR",
    "cdr_url": "https://cluster1.voiso.com/cdr/c4d12345-e3f4-4dc8-9723-2cc83644a1b9",
    "agent": {
      "id": 13240,
      "name": "James Smith",
      "email": "jamess@example.com",
      "extension": "3434"
    }
  }
}

Call hangup

The Outbound Call Hangup webhook POSTs the following request when an outbound call is hungup. Refer to Webhooks overview for descriptions of the common objects used by this webhook.

 {
  "event": "outbound.call.hangup",
  “object: "call",
  "timestamp": "2024-05-24T08:36:39Z",
  “secret”: "45XXYYZZa08",
  "contact_center_id": "187adc75-3008-44t3-8798-aa0bbc12yt999" 
  "data": {
          //call object 
          //agent object 
          }

Example

{
  "event": "outbound.call.hangup",
  "object": "call",
  "timestamp": "2024-08-14T09:49:17Z",
  "secret": "yr87ttto9ss",
  "contact_center_id": "12345054-2f06-476d-93a1-ae22bd3db4d7",
  "data": {
    "id": "b44e46eb-71ab-4efc-a694-b123d75a8abc
    "type": "outbound",
    "start_time": "2024-08-14T09:49:06Z",
    "end_time": "2024-08-14T09:49:18Z",
    "duration": {
      "total": 12,
      "dialing_time": 12
    },
    "disposition": "No answer",
    "end_reason": "Agent disconnect",
    "calling_number": 98843885555",
    "called_number": "4352675555",
    "cdr_url": "https://cluster1.voiso.com/cdr/b22e46eb-71eeb-4efc-a694-b210d75a8abc",
    "agent": {
      "id": 13240,
      "name": "James Smith",
      "email": "jamess@example.com",
      "extension": "3434"
    }
  }
}

Call ended

The Outbound Call Ended webhook POSTs the following request when an outbound call is ended. Refer to Webhooks overview for descriptions of the common objects used by this webhook.

 {
  "event": "outbound.call.ended",
  “object: "call",
  "timestamp": "2024-05-24T08:36:39Z",
  “secret”: "45XXYYZZa08",
  "contact_center_id": "187adc75-3008-44t3-8798-aa0bbc12yt999" 
  "data": {
          //call object 
          //agent object 
          }

Example

{
  "event": "outbound.call.ended",
  "object": "call",
  "timestamp": "2024-08-12T06:54:29Z",
  "secret": "ytfg8gh9hnoid7",
  "contact_center_id": "1a234567-b8c9-012a-3456-b7c8de90a1b2",
  "data": {
    "id": "1a234567-b8c9-012a-3456-b7c8de90a1b2",
    "type": "outbound",
    "start_time": "2024-08-12T06:53:50Z",
    "end_time": "2024-08-12T06:54:20Z",
    "duration": {
      "total": 30,
      "dialing_time": 5,
      "talk_time": 20,
      "hold_time": 5,
      "postcall_time": 10
    },
    "disposition": "Answered",
    "end_reason": "Contact disconnect",
    "calling_number": "123456789090",
    "called_number": "909087654321",
    "wrap_up_code": {
      "code": "1234",
      "description": "Send Invoice"
    },
    "notes": "The contact is looking for an updated invoice.",
    "cdr_url": "https://cluster1.voiso.com/cdr/1a234567-3456-012a-b8c9-b7c8de90a1b2",
    "agent": {
      "id": 1,
      "name": "James Carter",
      "email": "jc@example.com",
      "extension": "1234"
    }
  }
}