transfer_started

Acerca de este evento

El webhook transfer_started se activa cuando Altur registra que inició la transferencia de una llamada. Úsalo para preparar contexto en tiempo real para el agente humano que podría recibir la llamada transferida.

Detalles del evento

Trigger: Se activa automáticamente cuando inicia la transferencia.
Propósito: Notificar a tu backend o CRM antes de que conecte la llamada con el agente humano.

Detalles de la solicitud

Método HTTP: POST
Content Type: application/json
Endpoint: La URL que configures en tu integración de webhook.
Autenticación: Incluye el header X-Altur-Signature para verificación HMAC.

Ejemplo de payload

{
  "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"]
  }
}

Campos de transferencia

Campo	Tipo	Descripción
`event_type`	`string`	`transfer_started`.
`transfer_initiated_at`	`datetime`	Timestamp ISO de cuando Altur registró el inicio de transferencia.
`transfer_completed_at`	`datetime`	Siempre `null` para este evento.
`extracted_data`	`object`	Pares clave-valor de los datos extraídos en esta llamada. Normalmente `{}`, porque la extracción ocurre al terminar la llamada; usa `on_call_end` para obtenerlos.

Los demás campos coinciden con el payload de llamada de on_call_end.

El payload describe la llamada en el momento de la transferencia: status es in-progress, answered_by es human, y ended_at, ended_by, ended_reason, duration y billed_duration son null. El transcript contiene los mensajes que Altur ha recibido hasta la transferencia; ocasionalmente pueden faltar las últimas líneas dichas justo antes de transferir. Usa on_call_end para el transcript completo. Los objetos end_user y campaign_user reflejan sus valores al momento de enviar el evento.

Los webhooks de transferencia aplican los filtros status y answered_by de la integración, evaluados contra el estado de la llamada al momento de la transferencia (status: in-progress, answered_by: human), no contra su estado final. Por ejemplo, un filtro status: ["ended"] bloquea todos los webhooks de transferencia de esa integración. Los timestamps usan el mismo formato que on_call_end: ISO 8601 con offset +00:00 y fracciones de segundo opcionales (p. ej. 2026-09-30T21:08:12.340917+00:00).

Respuesta esperada

Tu endpoint debe responder con 200 OK para confirmar recepción. Para el comportamiento de reintentos, consulta la Retry Policy.

Introducción

Endpoints de API

Webhooks

transfer_started

Acerca de este evento

Detalles del evento

Detalles de la solicitud

Ejemplo de payload

Campos de transferencia

Respuesta esperada

​Acerca de este evento

​Detalles del evento

​Detalles de la solicitud

​Ejemplo de payload

​Campos de transferencia

​Respuesta esperada

Acerca de este evento

Detalles del evento

Detalles de la solicitud

Ejemplo de payload

Campos de transferencia

Respuesta esperada