Agent call-ended notification

POST

/webhooks/agent/call-ended

Called by the voice agent when a call finishes. Locates the matching call record (by room name, then by recent caller number, otherwise created retroactively), bills the exact duration, persists transcripts, recording and summary metadata, and increments tenant usage.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Call logged. May include a warning when no call record could be created (local transcript saved only).

Bodyapplication/json

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/webhooks/agent/call-ended' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "room_name": "agent-room-abc123",
    "agent_id": "agt_123",
    "tenant_id": "ten_789",
    "phone_number": "+4799999999",
    "duration_seconds": 99,
    "recording_consent": true,
    "recording_started": true,
    "recording_url": "https://storage.example.com/recordings/call_456.mp4",
    "egress_id": "egr_001",
    "transcript_paths": {
        "chat": "transcripts/call_456/chat.json",
        "functions": "transcripts/call_456/functions.json"
    },
    "call_summary": "Caller asked about opening hours.",
    "was_transferred": false
}'

Response Example

200 - Call logged to database

{
    "success": true
}

Modified at 2026-07-08 19:01:40

Get agent avatar preview info

Look up agent by phone number