Post-Call Webhook

{
  "id": 12345,
  "customer_phone": "+1234567890",
  "assistant_phone": "+1987654321",
  "duration": 125,
  "status": "completed",
  "extracted_variables": {
    "status": true,
    "summary": "Customer interested in product demo",
    "lead_quality": "high",
    "next_action": "schedule_demo"
  },
  "input_variables": {
    "customer_name": "John Doe",
    "product_interest": "Pro Plan"
  },
  "transcript": [
    {
      "text": "Hello! This is Sarah from HeyFred. How are you today?",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812511.315143
    },
    {
      "text": "Hi, I'm doing well, thanks for calling.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812514.104436
    },
    {
      "text": "I'm calling to tell you about our new product features.",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812522.918859
    },
    {
      "text": "That sounds interesting, tell me more.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812525.234567
    }
  ],
  "formatted_transcript": "AI: Hello! This is Sarah from HeyFred. How are you today?\nCustomer: Hi, I'm doing well, thanks for calling.\nAI: I'm calling to tell you about our new product features.\nCustomer: That sounds interesting, tell me more.",
  "recording_url": "https://app.heyfred.nl/storage/recordings/call-12345.mp4",
  "created_at": "2025-01-15T10:30:00.000000Z",
  "finished_at": "2025-01-15T10:32:05.000000Z",
  "transfers": [
    {
      "id": 12346,
      "status": "completed",
      "transfer_to": "+1555123456",
      "duration": 85,
      "carrier_cost": 0.0156,
      "transcript": null,
      "formatted_transcript": "",
      "created_at": "2025-01-15T10:31:00.000000Z",
      "finished_at": "2025-01-15T10:32:25.000000Z"
    }
  ],
  "lead": {
    "id": 789,
    "phone_number": "+1234567890",
    "variables": {
      "source": "website",
      "interest_level": "high"
    },
    "status": "contacted",
    "call_tries": 2,
    "created_at": "2025-01-15T09:00:00.000000Z",
    "updated_at": "2025-01-15T10:32:05.000000Z",
    "campaign": {
      "id": 456,
      "name": "Product Demo Campaign",
      "status": "active",
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "17:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_calls_in_parallel": 5,
      "max_retries": 3,
      "retry_interval": 60,
      "created_at": "2025-01-15T08:00:00.000000Z",
      "updated_at": "2025-01-15T08:00:00.000000Z"
    }
  }
}

The Post-Call Webhook is automatically sent to your specified webhook URL after each call is completed. This webhook contains call details, extracted variables, transcript, and optionally the recording URL.

Webhook Configuration

To enable post-call webhooks:

Configure your assistant’s webhook URL in the assistant settings
Enable “Post call webhook” in the assistant configuration
Define post-call variables that the AI should extract

Request Format

The webhook is sent as a POST request to your configured URL with the following JSON payload:

Payload Structure

integer

Unique identifier of the call

string

Phone number of the customer in E.164 format (e.g., “+1234567890”) or null if not available

string

Phone number used by the assistant in E.164 format or null if not available

integer

Duration of the call in seconds

string

Final status of the call (e.g., “completed”, “busy”, “failed”)

object

Variables extracted by AI based on your post-call schema configuration

Show Example extracted variables

boolean

Whether the call objective was achieved

string

Call summary in a few words

string|number|boolean

Any custom variables you defined in the assistant configuration

object

Variables that were passed to the assistant before the call started

string

Full transcript of the conversation

string

URL to download the call recording (only included if “Include recording in webhook” is enabled in assistant settings)

string

ISO 8601 timestamp when the call was initiated

string

ISO 8601 timestamp when the call was completed (uses updated_at from the call record)

object

Lead information (only included for campaign calls)

Show Lead properties

integer

Unique identifier of the lead

string

Lead’s phone number

object

Variables associated with the lead

string

Current status of the lead

integer

The number of call attempts made to this lead

string

When the lead was created

string

When the lead was last updated

object

Campaign information (if available)

Show Campaign properties

integer

Campaign ID

string

Campaign name

string

Campaign status

string

Campaign allowed start time

string

Campaign allowed end time

array

Campaign allowed days

integer

Maximum concurrent calls for campaign

integer

Maximum retry attempts for leads

integer

Retry interval in minutes

string

When the campaign was created

string

When the campaign was last updated

array

List of transfer calls made during this call (only included if the call has transfers)

Show Transfer properties

integer

Unique identifier of the transfer call

string

Final status of the transfer call (e.g., “completed”, “busy”, “failed”)

string

Phone number the call was transferred to in E.164 format

integer

Duration of the transfer call in seconds

number

Carrier cost of the transfer call in USD

array

Raw transcript of the transfer call (null if not available)

string

Human-readable formatted transcript of the transfer call

string

URL to download the transfer call recording (only included if “Include recording in webhook” is enabled and a recording exists)

string

ISO 8601 timestamp when the transfer was initiated

string

ISO 8601 timestamp when the transfer was completed

{
  "id": 12345,
  "customer_phone": "+1234567890",
  "assistant_phone": "+1987654321",
  "duration": 125,
  "status": "completed",
  "extracted_variables": {
    "status": true,
    "summary": "Customer interested in product demo",
    "lead_quality": "high",
    "next_action": "schedule_demo"
  },
  "input_variables": {
    "customer_name": "John Doe",
    "product_interest": "Pro Plan"
  },
  "transcript": [
    {
      "text": "Hello! This is Sarah from HeyFred. How are you today?",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812511.315143
    },
    {
      "text": "Hi, I'm doing well, thanks for calling.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812514.104436
    },
    {
      "text": "I'm calling to tell you about our new product features.",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812522.918859
    },
    {
      "text": "That sounds interesting, tell me more.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812525.234567
    }
  ],
  "formatted_transcript": "AI: Hello! This is Sarah from HeyFred. How are you today?\nCustomer: Hi, I'm doing well, thanks for calling.\nAI: I'm calling to tell you about our new product features.\nCustomer: That sounds interesting, tell me more.",
  "recording_url": "https://app.heyfred.nl/storage/recordings/call-12345.mp4",
  "created_at": "2025-01-15T10:30:00.000000Z",
  "finished_at": "2025-01-15T10:32:05.000000Z",
  "transfers": [
    {
      "id": 12346,
      "status": "completed",
      "transfer_to": "+1555123456",
      "duration": 85,
      "carrier_cost": 0.0156,
      "transcript": null,
      "formatted_transcript": "",
      "created_at": "2025-01-15T10:31:00.000000Z",
      "finished_at": "2025-01-15T10:32:25.000000Z"
    }
  ],
  "lead": {
    "id": 789,
    "phone_number": "+1234567890",
    "variables": {
      "source": "website",
      "interest_level": "high"
    },
    "status": "contacted",
    "call_tries": 2,
    "created_at": "2025-01-15T09:00:00.000000Z",
    "updated_at": "2025-01-15T10:32:05.000000Z",
    "campaign": {
      "id": 456,
      "name": "Product Demo Campaign",
      "status": "active",
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "17:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_calls_in_parallel": 5,
      "max_retries": 3,
      "retry_interval": 60,
      "created_at": "2025-01-15T08:00:00.000000Z",
      "updated_at": "2025-01-15T08:00:00.000000Z"
    }
  }
}

Webhook Settings

You can configure the following options for your post-call webhook:

Send webhook only on completed: Only send the webhook for successfully completed calls
Include recording in webhook: Include the recording_url field in the payload
Custom variables: Define custom variables that the AI should extract from the conversation

Important Notes

The customer_phone and assistant_phone fields can be null if the information is not available
The recording_url field is only included if you have enabled “Include recording in webhook” in your assistant settings
The lead object is only included for calls that are part of a campaign
The transfers array is only included for calls that have transfer calls associated with them
The extracted_variables object will contain the variables you defined in your assistant’s post-call schema configuration

Get Session Status Conversation Ended Webhook

API Reference

Assistants

Folders

Labels

Calls

Conversations

AI

Mid Call Tools

Leads

Campaigns

Phone Numbers

SIP Trunks

Knowledgebases

SMS

WhatsApp

Webhooks

API Keys

Post-Call Webhook

Webhook Configuration

Request Format

Payload Structure

Webhook Settings

Important Notes

​Webhook Configuration

​Request Format

​Payload Structure

​Webhook Settings

​Important Notes

Webhook Configuration

Request Format

Payload Structure

Webhook Settings

Important Notes