Skip to main content
WEBHOOK
call.incoming.completed
{
  "id": "evt_4f9a2c…",
  "api_version": "<string>",
  "occurred_at": "2023-11-07T05:31:56Z",
  "business_id": "<string>",
  "data": {
    "call": {
      "id": "<string>",
      "from_number": "<string>",
      "to_number": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z",
      "duration_seconds": 123,
      "recording_url": "<string>",
      "voicemail_url": "<string>",
      "transcript": "<string>"
    },
    "contact": {
      "id": "<string>",
      "name": "<string>",
      "phone_number": "<string>"
    },
    "user": {
      "id": "<string>",
      "name": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.dialbird.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authorization Code flow against Dialbird's OIDC provider. The issued access token is a JWT with aud: "public-api", verified against the issuer JWKS.

Body

application/json

Webhook delivery body. Signed with X-Dialbird-Signature as described for message deliveries.

​
id
string
required

Globally unique event id, prefixed evt_. Use as a dedup key.

Example:

"evt_4f9a2c…"

​
type
enum<string>
required
Available options:
message.incoming.received,
message.outgoing.delivered,
call.incoming.completed,
call.outgoing.completed
​
api_version
string
required
Allowed value: "v1"
​
occurred_at
string<date-time>
required

When the event occurred (not when delivered).

​
business_id
string
required
​
data
object
required

Response

200

Acknowledge receipt with any 2xx.