transfer_completed

Acerca de este evento

El webhook transfer_completed se activa cuando Altur registra que conectó la llamada transferida. Úsalo para mostrar contexto en tiempo real al agente humano que recibe la transferencia.

Detalles del evento

Trigger: Se activa automáticamente cuando conecta la llamada transferida.
Propósito: Notificar a tu backend o CRM que conectó una transferencia a 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_completed",
  "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": "2026-09-30T21:08:20.771205+00:00",
  "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_completed`.
`transfer_initiated_at`	`datetime`	Timestamp ISO de cuando Altur registró el inicio de transferencia.
`transfer_completed_at`	`datetime`	Timestamp ISO de cuando Altur registró conexión de transferencia.
`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_completed

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