AI Agent Call Webhook Payload - Zeeg Developer Hub

Alpha This payload is delivered to your webhook callback URL when an ai_agent.call_completed event occurs. It fires once when an AI agent call reaches a terminal state. This webhook is in alpha: the payload shape may still change without a deprecation cycle.

Event Info

string

required

Always "ai_agent.call_completed".

string

required

Unique identifier for this call. Use this as the dedup key for idempotent processing — in rare cases the same call may be delivered more than once. A delivery that fails is not retried.

Agent

string

required

UUID of the AI agent that handled the call.

string | null

Display name of the AI agent.

Call

string

required

"inbound" (caller reached the agent) or "outbound" (agent dialled out).

string

required

Terminal outcome of the call attempt: "answered", "voicemail", "not_answered", "busy", or "unknown".

boolean

required

true when the interaction was a real phone call; false for non-call interactions such as chat.

string | null

ISO 8601 UTC timestamp when the call started.

string | null

ISO 8601 UTC timestamp when the call ended.

integer | null

Total call duration in seconds.

string | null

The external party’s (contact/lead) phone number in E.164 format, regardless of call direction. null for test/widget calls or blocked caller ID.

string | null

The contact’s name. It is the name the caller stated on this call, else the full name sent to the outbound call API, else the name of the matched CRM contact. null when none is known.

string | null

The contact’s email address. It is the address the caller stated on this call, else the email sent to the outbound call API, else the email of the matched CRM contact. null when none is known.

string | null

The agent’s phone line that the call used, in E.164 format. If the call never connected, this is the agent’s current provisioned number. null when neither is known.

string | null

The agent’s primary language code, for example de or en.

string | null

The language code the conversation was held in, as detected on the call, for example de. It can differ from agentLanguage on a multilingual agent. null when no language was detected.

Transcript

array

required

Ordered conversation turns. Tool-only turns with no spoken message are omitted — the actions the agent took are in actions.

Show Transcript turn

string

Who spoke the turn. Example: agent, user.

string

The spoken text of the turn.

integer | null

Offset in seconds from the start of the call when the turn occurred.

Conversation Analysis

object

AI-generated analysis of the conversation.

Show Conversation analysis object

string | null

AI-generated narrative summary of the transcript.

object

Map of collected field id to its { value, type } entry. Keys are the data the agent collects — e.g. name, email, phone, message, summary, plus any custom fields. Keys depend on your agent’s configuration.

Show Collected field entry

string | null

The value the agent collected for this field.

string | null

The field’s data type (e.g. string). null when unknown.

System notes

array

required

Notes Zeeg adds about the call, beside what the agent collected. An empty array when there is nothing to note. New notes can be added at any time, so ignore a code you do not recognize rather than failing on it.

Show System note object

string | null

Stable identifier to branch on. null for a note that is informational text only.

caller_phone_not_dialable — the callback number the caller stated is not a dialable phone number. conversationAnalysis.collectedData.phone holds it exactly as the caller gave it.

string

English, human-readable description of the note. The wording can change; branch on code.

Actions

array

required

Ordered list of actions the agent executed during the call.

Show Action object

string

Action identifier. Example: book_event, send_email, send_sms.

string | null

UUID of the route configuration that drove the action, if applicable. null otherwise.

string | null

ISO 8601 timestamp when this action was executed.

Booking

object | null

The scheduled event created during the call, in the same shape as the GET /v2/scheduled-events/{uuid} resource; null if no booking was made. Correlate booking.uuid with invitee.scheduled webhook events for the same booking.

Show Booking object

string

Public API URI of the scheduled event resource.

string

Unique identifier of the scheduled event. Use this to correlate with invitee.scheduled webhook events.

string

Title of the scheduled event.

string

Event type kind. Example: ONE_ON_ONE, GROUP, ROUND_ROBIN.

string

ISO 8601 UTC start time of the booked event.

string

ISO 8601 UTC end time of the booked event.

integer

Event duration in minutes.

string

Booking status. Example: confirmed, cancelled.

string

Public API URI of the event type this booking was made against.

object | null

Meeting location for the booking.

Show Location object

string

Location type. Example: google_meet, zoom, phone, in_person.

string | null

Join URL for the meeting, when applicable.

integer

Maximum number of active invitees the event allows.

integer

Current number of active (non-cancelled) invitees.

array

Invitees booked on the scheduled event.

Show Invitee object

string

Unique identifier of the invitee.

string | null

Salutation for the invitee, if collected.

string | null

Full name of the invitee.

string | null

Email address of the invitee.

array

Additional guest email addresses for this invitee.

string | null

IANA time zone of the invitee.

object

Cancellation details. All fields are null when the invitee is not cancelled.

Show Cancellation object

string | null

ISO 8601 UTC timestamp when the invitee was cancelled.

string | null

Identifier of who cancelled the booking.

string | null

Type of canceller (e.g. host, invitee).

string | null

Reason given for the cancellation.

object | null

Payment details for the booking, or null when no payment applies.

array

Booking questions answered by the invitee.

string | null

ISO 8601 UTC timestamp when the invitee booked.

object

UTM tracking parameters captured at booking time. Holds all five keys (utm_campaign, utm_source, utm_medium, utm_term, utm_content); a key holds null when the booking did not carry a value for it.

object

Custom query parameters captured at booking time. An empty object when the booking captured none.

string | null

Reference code for bookings made via the AI agent; null otherwise.

array

Event-level guest email addresses.

array

Hosts assigned to the scheduled event.

Show Host object

string | null

Host’s first name.

string | null

Host’s last name.

string | null

Host’s email address.

string | null

Host’s public profile slug.

string | null

Host’s public profile URL.

string | null

URL of the host’s avatar image, if set.

string | null

Name of the team that owns the scheduling page the booking was made on, null for a personal scheduling page.

string

ISO 8601 UTC timestamp when the booking was created.

string

ISO 8601 UTC timestamp when the booking was last updated.

string

ISO 8601 UTC server time when the resource was rendered.

CRM

string | null

UUID of the CRM person record linked to this call, if matched.

Outbound Call

object | null

What you sent to the outbound-call API when you started this call. null for an inbound call and for an outbound call that the outbound-call API did not start.

Show Outbound call

string

The id that the outbound-call API returned.

string | null

The contact name you sent.

string | null

The contact email you sent.

string | null

The additional context you sent for the agent.

string | null

ISO 8601 UTC time the call was scheduled for.

Full Payload Example

{
  "event": "ai_agent.call_completed",
  "conversationId": "abc1234-0000-0000-0000-xyz987654321",
  "agentId": "9a39bf60-a6c3-45e7-80cd-2cd36e520861",
  "agentName": "Sales Agent",
  "direction": "inbound",
  "callOutcome": "answered",
  "isCall": true,
  "startedAt": "2026-06-01T10:00:00+00:00",
  "endedAt": "2026-06-01T10:01:30+00:00",
  "durationSeconds": 90,
  "contactPhoneNumber": "+4917612345678",
  "contactName": "Alice Example",
  "contactEmail": "alice@example.com",
  "agentPhoneNumber": "+4989123456789",
  "agentLanguage": "de",
  "conversationLanguage": "de",
  "transcript": [
    { "role": "agent", "message": "Hello, thank you for calling. How can I help you today?", "timeInCallSeconds": 0 },
    { "role": "user", "message": "Hi, I'd like to know more about your pricing.", "timeInCallSeconds": 4 },
    { "role": "agent", "message": "Of course. Our plans start at 12 euros per month. Shall I book a follow-up call?", "timeInCallSeconds": 9 }
  ],
  "conversationAnalysis": {
    "transcriptSummary": "The caller asked about product pricing and requested a follow-up call next week.",
    "collectedData": {
      "name":    { "value": "Alice Müller", "type": "string" },
      "email":   { "value": "alice@example.com", "type": "string" },
      "message": { "value": "Please send me the pricing sheet.", "type": "string" },
      "summary": { "value": "Caller asked about pricing and wants a follow-up.", "type": "string" }
    }
  },
  "systemNotes": [],
  "actions": [
    {
      "type": "book_event",
      "routeId": null,
      "calledAt": "2026-06-01T10:00:45+00:00"
    },
    {
      "type": "send_email",
      "routeId": "9b1c2d3e-4f56-7890-abcd-ef0123456789",
      "calledAt": "2026-06-01T10:01:20+00:00"
    }
  ],
  "booking": {
    "uri": "https://api.zeeg.me/v2/scheduled-events/zg-O69bd55e004c8b",
    "uuid": "zg-O69bd55e004c8b",
    "title": "30-Minute Meeting with Sales Agent",
    "type": "ONE_ON_ONE",
    "startTime": "2026-06-03T14:00:00.000000Z",
    "endTime": "2026-06-03T14:30:00.000000Z",
    "duration": 30,
    "status": "confirmed",
    "eventTypeUri": "https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
    "location": { "type": "google_meet", "joinUrl": "https://meet.google.com/abc-defg-hij" },
    "maxActiveInvitees": 1,
    "activeInviteesCount": 1,
    "invitees": [
      {
        "uuid": "zg-A12cd34ef005a9c",
        "salutation": null,
        "fullName": "Alice Müller",
        "email": "alice@example.com",
        "guests": [],
        "timeZone": "Europe/Berlin",
        "cancellation": { "cancelledAt": null, "cancelledBy": null, "cancellerType": null, "cancellationReason": null },
        "payment": null,
        "questions": [],
        "scheduledAt": "2026-06-01T10:00:50.000000Z",
        "utm": { "utm_campaign": null, "utm_source": null, "utm_medium": null, "utm_content": null, "utm_term": null },
        "customQueryParams": {},
        "agentBookingReference": "123456"
      }
    ],
    "guests": [],
    "hosts": [
      { "firstName": "Lena", "lastName": "Meier", "email": "lena.meier@example.com", "slug": "lena-meier", "url": "https://zeeg.me/lena-meier", "avatarUrl": null }
    ],
    "teamName": null,
    "createdAt": "2026-06-01T10:00:50.000000Z",
    "updatedAt": "2026-06-01T10:00:50.000000Z",
    "currentTime": "2026-06-01T10:01:30.000000Z"
  },
  "crmPersonId": "7f3e2a91-1234-4abc-9012-b3c456d78901",
  "outboundCall": null
}

​Event Info

​Agent

​Call

​Transcript

​Conversation Analysis

​System notes

​Actions

​Booking

​CRM

​Outbound Call

​Full Payload Example

Event Info

Agent

Call

Transcript

Conversation Analysis

System notes

Actions

Booking

CRM

Outbound Call

Full Payload Example