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

event

string

required

Always "ai_agent.call_completed".

conversationId

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

agentId

string

required

UUID of the AI agent that handled the call.

agentName

string | null

Display name of the AI agent.

Call

direction

string

required

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

callOutcome

string

required

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

isCall

boolean

required

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

startedAt

string | null

ISO 8601 UTC timestamp when the call started.

endedAt

string | null

ISO 8601 UTC timestamp when the call ended.

durationSeconds

integer | null

Total call duration in seconds.

contactPhoneNumber

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.

agentPhoneNumber

string | null

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

Transcript

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

role

string

Who spoke the turn. Example: agent, user.

message

string

The spoken text of the turn.

timeInCallSeconds

integer | null

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

Conversation Analysis

conversationAnalysis

object

AI-generated analysis of the conversation.

Show Conversation analysis object

transcriptSummary

string | null

AI-generated narrative summary of the transcript.

collectedData

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

value

string | null

The value the agent collected for this field.

type

string | null

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

Actions

actions

array

required

Ordered list of actions the agent executed during the call.

Show Action object

type

string

Action identifier. Example: book_event, send_email, send_sms.

routeId

string | null

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

calledAt

string | null

ISO 8601 timestamp when this action was executed.

Booking

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

uri

string

Public API URI of the scheduled event resource.

uuid

string

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

title

string

Title of the scheduled event.

type

string

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

startTime

string

ISO 8601 UTC start time of the booked event.

endTime

string

ISO 8601 UTC end time of the booked event.

duration

integer

Event duration in minutes.

status

string

Booking status. Example: confirmed, cancelled.

eventTypeUri

string

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

location

object | null

Meeting location for the booking.

Show Location object

type

string

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

joinUrl

string | null

Join URL for the meeting, when applicable.

maxActiveInvitees

integer

Maximum number of active invitees the event allows.

activeInviteesCount

integer

Current number of active (non-cancelled) invitees.

invitees

array

Invitees booked on the scheduled event.

Show Invitee object

uuid

string

Unique identifier of the invitee.

salutation

string | null

Salutation for the invitee, if collected.

fullName

string | null

Full name of the invitee.

string | null

Email address of the invitee.

guests

array

Additional guest email addresses for this invitee.

timeZone

string | null

IANA time zone of the invitee.

cancellation

object

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

Show Cancellation object

cancelledAt

string | null

ISO 8601 UTC timestamp when the invitee was cancelled.

cancelledBy

string | null

Identifier of who cancelled the booking.

cancellerType

string | null

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

cancellationReason

string | null

Reason given for the cancellation.

payment

object | null

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

questions

array

Booking questions answered by the invitee.

scheduledAt

string | null

ISO 8601 UTC timestamp when the invitee booked.

utm

array

UTM tracking parameters captured at booking time.

customQueryParams

array

Custom query parameters captured at booking time.

agentBookingReference

string | null

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

guests

array

Event-level guest email addresses.

hosts

array

Hosts assigned to the scheduled event.

Show Host object

firstName

string | null

Host’s first name.

lastName

string | null

Host’s last name.

string | null

Host’s email address.

slug

string | null

Host’s public profile slug.

url

string | null

Host’s public profile URL.

avatarUrl

string | null

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

createdAt

string

ISO 8601 UTC timestamp when the booking was created.

updatedAt

string

ISO 8601 UTC timestamp when the booking was last updated.

currentTime

string

ISO 8601 UTC server time when the resource was rendered.

CRM

crmPersonId

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": [],
        "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