Event types

Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.

Agntix delivers webhooks via Svix. Configure endpoints from the dashboard’s Developer section — see Webhooks overview. Voice and chat sessions emit two events today: session.created (when the call/conversation starts) and session.ended (when it closes, with the full post-call analysis attached). The other events on this page are on the roadmap — documented so you can design against them, but not delivered as webhooks yet.

Available now: session.created and session.ended. Every event marked Planned below is not emitted to webhook endpoints yet — don’t build hard dependencies on it. session.updated and knowledge_store.updated currently exist only as in-app real-time (SSE) signals, not as webhooks.

Treat the top-level id (session UUID) as the idempotency key. Don’t double-process the same id. Webhooks may be retried on non-2xx responses — respond 2xx once you’ve durably enqueued the event.

`session.created` Available

Fired when a session is initiated — for outbound voice calls, this is before pickup. Use it to lock the originating task as “in-flight”.

string

The session id (UUID). Use as idempotency key.

string

Constant: "session.created".

enum

VOICE, CHAT.

enum

PHONE, WEB, WHATSAPP.

enum

INBOUND, OUTBOUND.

enum

Session state at emission (OPEN for session.created).

string

The agent id (UUID).

string

RFC 3339 UTC timestamp.

object

Channel and session metadata. Includes customerPhoneNumber, roomName, and sessionVariables — see below.

object

The session_variables you passed at trigger time, echoed back verbatim — regardless of whether the prompt referenced them. Use these as your correlation IDs (e.g. crmContactId, taskId, campaignId).

{
  "id": "4981804c-2658-4893-84ff-9c2fa90fb3c2",
  "eventType": "session.created",
  "type": "VOICE",
  "platform": "PHONE",
  "direction": "OUTBOUND",
  "state": "OPEN",
  "agentId": "40235145-aa3d-443e-9d0c-841dd0716a2f",
  "createdAt": "2026-04-08T05:00:01.130Z",
  "metadata": {
    "customerPhoneNumber": "+971501234567",
    "roomName": "outbound_sip_40235145-aa3d-443e-9d0c-841dd0716a2f^__^7yoamyb",
    "sessionVariables": {
      "crmContactId": "CRM-7728",
      "customerName": "Alex Morgan"
    }
  }
}

`session.ended` Available

Fired once when a session closes (manually, via timeout, on call hangup, or on ttl expiry). Carries the full post-call analysis block — see Post-call analysis for what each field means.

string

The session id (UUID). Same as in session.created.

string

Constant: "session.ended".

enum

CLOSED.

string

Session start time.

string

Most recent activity timestamp.

string

When the session closed.

object

Same shape as session.created. metadata.sessionVariables is echoed verbatim.

string

One-paragraph summary of the call.

object

Best-fit intent classification — conversation.intent, confidence, explanation. Present only when Intent Recognition is enabled on the agent.

object

classification (RESOLVED / PARTIALLY_RESOLVED / UNRESOLVED / NOT_APPLICABLE), confidenceScore, satisfiedChecklistItems, evidence, explanation. Present only when Resolution Analysis is enabled.

object

conversation.sentiment (POSITIVE / NEUTRAL / NEGATIVE), score (-1.0 to +1.0), detectedLanguage. Present only when Sentiment is enabled.

object

Map of { <fieldName>: <value> } for every field defined in the agent’s Data Extraction schema.

string

Link into the dashboard to play back the call recording.

{
  "id": "4981804c-2658-4893-84ff-9c2fa90fb3c2",
  "eventType": "session.ended",
  "type": "VOICE",
  "platform": "PHONE",
  "direction": "OUTBOUND",
  "state": "CLOSED",
  "agentId": "40235145-aa3d-443e-9d0c-841dd0716a2f",

  "createdAt": "2026-04-08T05:00:01.130Z",
  "lastActivityAt": "2026-04-08T05:00:01.130Z",
  "endedAt": "2026-04-08T05:00:10.546Z",
  "updatedAt": "2026-04-08T05:00:01.130Z",

  "metadata": {
    "customerPhoneNumber": "+971501234567",
    "roomName": "outbound_sip_40235145-aa3d-443e-9d0c-841dd0716a2f^__^7yoamyb",
    "sessionVariables": {
      "crmContactId": "CRM-7728",
      "customerName": "Alex Morgan"
    }
  },

  "analysis": {
    "summary": "Customer confirmed delivery slot for Wednesday afternoon.",
    "intent": {
      "conversation": { "intent": "Slot-Confirmed", "confidence": 0.92, "explanation": "…" },
      "message":      { "intent": null, "confidence": 0, "explanation": "…" }
    },
    "resolution": {
      "classification": "RESOLVED",
      "confidenceScore": 0.88,
      "status": "Completed",
      "satisfiedChecklistItems": ["delivery_slot_agreed"],
      "evidence": ["Customer: yes Wednesday afternoon works."],
      "explanation": "Customer agreed to a specific slot."
    },
    "sentiment": {
      "conversation": { "sentiment": "POSITIVE", "score": 0.4, "detectedLanguage": "en", "explanation": "…" },
      "message":      { "sentiment": null, "score": 0, "detectedLanguage": "N/A", "explanation": "…" }
    },
    "extractedData": {
      "slotConfirmed": true,
      "preferredDay": "Wednesday",
      "preferredTimeWindow": "Afternoon",
      "callbackRequested": false,
      "callOutcome": "Confirmed"
    }
  },

  "recordingUrl": "https://app.agntix.ai/en/logs-history?opened=4981804c-2658-4893-84ff-9c2fa90fb3c2"
}

The webhook is summary-grade, not transcript-grade. The full message-by-message transcript is not included, and some long-call fields may be truncated. For the complete picture, pull from GET /api/v1/chat/sessions/{id}/messages.

`session.updated` Planned chat

Emitted for chat sessions when state, agent assignment, intelligence summary, or analytics records change mid-session. Voice/outbound calls do not emit this event — they go straight from session.created to session.ended.

Today this fires only as an in-app real-time (SSE) signal for live dashboards. It is not yet delivered to webhook endpoints.

string

Session id (UUID).

string

Constant: "session.updated".

string[]

Which fields changed (e.g. ["state", "intelligence"]).

enum

OPEN, CLOSED, EXPIRED.

{
  "id": "ses_01J2K…",
  "eventType": "session.updated",
  "createdAt": "2026-04-28T11:43:00Z",
  "changedFields": ["intelligence"],
  "state": "OPEN"
}

`message.added` Planned

A user, assistant, or tool message was appended to a session.

Not emitted to webhook endpoints yet. Until it ships, poll GET /api/v1/chat/sessions/{id}/messages or consume the in-app real-time stream.

string

The message id (msg_…).

enum

USER, ASSISTANT, TOOL, SYSTEM.

string

The text content (may be empty for tool calls).

object

Present only for TOOL role.

{
  "id": "evt_2dQs…",
  "type": "message.added",
  "createdAt": "2026-04-28T11:42:13Z",
  "data": {
    "sessionId": "ses_01J2K…",
    "messageId": "msg_01J2L…",
    "role": "ASSISTANT",
    "content": "Your order 1234 shipped this morning."
  }
}

`usage.updated` Planned

Aggregate usage metrics for the org changed (rolled up every 60s).

Not emitted to webhook endpoints yet.

object

{ "start": ISO, "end": ISO }.

object

{ "chat_messages": number, "voice_seconds": number, "knowledge_chunks": number }.

`subscription.updated` Planned

Plan change, payment method update, cancel, or resume.

Not emitted to webhook endpoints yet.

string

enum

active, past_due, canceled, paused.

string

e.g. growth.

`knowledge_store.updated` Planned

A document finished processing (chunked + embedded + indexed).

Today this fires only as an in-app real-time (SSE) signal (named knowledge.store.updated). It is not yet delivered to webhook endpoints.

string

enum

UPSERTED, FAILED.

Delivery semantics

At-least-once. Always idempotent on the top-level id.
Order is not guaranteed. Use createdAt if you need to sort.
Retries: exponential backoff up to 24h. After 24h the event is dead-lettered (visible in the dashboard).
Timeout: your endpoint must respond 2xx within 15 seconds.

See Verifying signatures for how to authenticate incoming requests.

Getting Started

Build

Real-time

SDKs & Examples

Operate

`session.created` Available

`session.ended` Available

`session.updated` Planned chat

`message.added` Planned

`usage.updated` Planned

`subscription.updated` Planned

`knowledge_store.updated` Planned

Delivery semantics

​session.created Available

​session.ended Available

​session.updated Planned chat

​message.added Planned

​usage.updated Planned

​subscription.updated Planned

​knowledge_store.updated Planned

​Delivery semantics

`session.created` Available

`session.ended` Available

`session.updated` Planned chat

`message.added` Planned

`usage.updated` Planned

`subscription.updated` Planned

`knowledge_store.updated` Planned

Delivery semantics