transfer_started

About This Event

The transfer_started webhook is triggered when Altur records that a call transfer handoff has started. Use it to prepare real-time context for the human agent who may receive the transferred call.

Event Details

Trigger: Automatically triggered when the transfer handoff starts.
Purpose: To notify your backend or CRM before the human transfer leg connects.

Request Details

HTTP Method: POST
Content Type: application/json
Endpoint: The URL you configure in your webhook integration settings.
Authentication: Includes the X-Altur-Signature header for HMAC verification.

Payload Example

{
  "event_type": "transfer_started",
  "id": "cll_gBoLtd02pUI50QwXkFjB",
  "thread_id": "thr_Kp7mQz3XvNb8LcRt2sYw",
  "type": "outbound",
  "status": "in-progress",
  "phone_number_from": "+000000000000",
  "phone_number_to": "+000000000000",
  "answered_by": "human",
  "created_at": "2026-09-30T21:07:09.184530+00:00",
  "started_at": "2026-09-30T21:07:12+00:00",
  "ended_at": null,
  "ended_by": null,
  "ended_reason": null,
  "transfer_initiated_at": "2026-09-30T21:08:12.340917+00:00",
  "transfer_completed_at": null,
  "duration": null,
  "billed_duration": null,
  "recording_url": "https://api.altur.io/api/v1.0/call/cll_gBoLtd02pUI50QwXkFjB/recording",
  "transcript": [
    {
      "sequence": 0,
      "sent_by": "assistant",
      "sent_at": "2026-09-30T21:07:13.402156+00:00",
      "content": "Hello am I speaking with Sofía?"
    }
  ],
  "extracted_data": {},
  "assistant": {
    "id": "6cy951e6-9877-4d7c-88d7-56b4948d3cce",
    "nickname": "DebtCollectorBot",
    "name": "Diana Arroyo"
  },
  "end_user": {
    "id": "2be951e6-7798-47cd-878d-49b2918a3bba",
    "status": "converted",
    "display_name": "John Doe",
    "phone_number": "+521234567890",
    "context": "Customer data...",
    "extracted_data": {},
    "tags": ["call_later"]
  },
  "campaign_user": {
    "f_id": "user_12345",
    "name": "John Doe",
    "contact": "+521234567890",
    "context": "Customer data for campaign...",
    "status": "converted",
    "failed_retries": 0,
    "voicemail_retries": 1,
    "extracted_data": {},
    "tags": ["call_later"]
  }
}

Transfer Fields

Field	Type	Description
`event_type`	`string`	`transfer_started`.
`transfer_initiated_at`	`datetime`	ISO timestamp when Altur recorded the transfer handoff starting.
`transfer_completed_at`	`datetime`	Always `null` for this event.
`extracted_data`	`object`	Key-value pairs of the data extracted in this call. Usually `{}`, because extraction runs when the call ends; use `on_call_end` for it.

All other fields match the on_call_end call payload.

The payload describes the call at the moment of the transfer: status is in-progress, answered_by is human, and ended_at, ended_by, ended_reason, duration and billed_duration are null. The transcript contains the messages Altur has received up to the transfer; the last few lines spoken right before the transfer may occasionally be missing. Use on_call_end for the full transcript. The end_user and campaign_user objects reflect their values when the event is sent.

Transfer webhooks apply the integration’s status and answered_by filters, evaluated against the call state at the moment of the transfer (status: in-progress, answered_by: human), not the final call state. For example, a filter of status: ["ended"] blocks every transfer webhook for that integration. Timestamps use the same format as on_call_end: ISO 8601 with a +00:00 offset and optional fractional seconds (e.g. 2026-09-30T21:08:12.340917+00:00).

Response Expectations

Your endpoint should return a 200 OK status code to confirm receipt. For retry behavior, see the Retry Policy.

Getting Started

API Endpoints

Webhooks

transfer_started

About This Event

Event Details

Request Details

Payload Example

Transfer Fields

Response Expectations

​About This Event

​Event Details

​Request Details

​Payload Example

​Transfer Fields

​Response Expectations

About This Event

Event Details

Request Details

Payload Example

Transfer Fields

Response Expectations