Call Transferred

The call.transferred webhook event is triggered whenever a call is transferred from the Apten assistant to another agent or system. This can be used to track call handoffs and monitor transfer patterns.

This event fires at transfer initiation, when Apten begins the transfer attempt and the lead begins waiting. It is not an outcome.After a warm transfer, the outcome is exactly one of call.transfer.connected or call.transfer.failed. Cold transfers do not emit call.transfer.connected. transferFallbackTriggered means a fallback number is still being dialed. Do not treat a missing connected event as failure.

Payload

{
  "event": "call.transferred",
  "data": {
    "leadId": "c4f23a1b-d8e5-4f67-90c1-2a5b8d3e9x7y",
    "externalLeadId": "003XX000004DHPY",
    "phone": "+12025550189",
    "profile": "Default Profile",
    "callId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "transferType": "WARM",
    "transferTo": "+12025550100",
    "transferInitiatedAt": "2024-01-15T14:30:00Z",
    "summary": "Jordan confirmed interest in the premium plan and asked to speak with a specialist about pricing. Apten initiated a warm transfer to the sales team."
  },
  "timestamp": "2024-01-15T14:30:00Z"
}

Properties

Property	Type	Description
`event`	string	The webhook event type (`call.transferred`).
`data.leadId`	string	The unique identifier for the lead.
`data.externalLeadId`	string	The CRM lead ID (Salesforce, HubSpot, or Close CRM).
`data.phone`	string	The phone number of the lead.
`data.profile`	string	The customer profile assigned to the lead.
`data.callId`	string	The unique identifier for the call being transferred.
`data.transferType`	string	The type of transfer: `WARM` (with introduction) or `COLD` (direct).
`data.transferTo`	string	The phone number or identifier of the transfer destination.
`data.transferInitiatedAt`	string \| undefined	When Apten began the transfer attempt and the lead began waiting.
`data.summary`	string \| null	Summary of the lead’s interaction generated at transfer time, covering the current call and any prior conversation context. `null` when the transfer call had no AI conversation to summarize (for example, a call placed solely to connect the lead with an agent).
`timestamp`	string	The ISO 8601 timestamp when the webhook event was emitted. Use `data.transferInitiatedAt` for transfer timing.

Get Started

Account & Security

Tutorials

Compliance

Webhooks

Integrations

Webchat

Automations

Call Transferred

Payload

Properties

​Payload

​Properties

Payload

Properties