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.

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

Your agent’s own provisioned phone number (DID) in E.164 format. null when the agent has no provisioned number.

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, 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.

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.

array

UTM tracking parameters captured at booking time.

array

Custom query parameters captured at booking time.

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

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.

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",
  "agentPhoneNumber": "+4989123456789",
  "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" }
    }
  },
  "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 }
    ],
    "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"
}

​Event Info

​Agent

​Call

​Transcript

​Conversation Analysis

​Actions

​Booking

​CRM

​Full Payload Example

Event Info

Agent

Call

Transcript

Conversation Analysis

Actions

Booking

CRM

Full Payload Example