---
title: "Outbound call events"
slug: "outbound-call-events"
updated: 2024-10-25T15:18:13Z
published: 2024-10-25T15:18:13Z
canonical: "docs.voiso.com/outbound-call-events"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiso.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://docs.voiso.com/docs/webhooks) in the Voiso Documentation Portal.

| Event | Description |
| --- | --- |
| outbound.call.answered | A contact answers an outbound call. |
| outbound.call.hangup | An outbound call ends. |
| outbound.call.ended | Postcall work for an outbound call is completed. |

## Call answered

The Outbound Call Answered webhook POSTs the following request when an outbound call is answered. Refer to [Webhooks overview](/v1-api/apidocs/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](/v1-api/apidocs/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](page:webhooks/web-hooks-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"
    }
  }
}
```