transfer_started - Altur

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": "2024-12-19T15:00:10Z",
  "started_at": "2024-12-19T15:00:12Z",
  "ended_at": null,
  "ended_by": null,
  "ended_reason": null,
  "transfer_initiated_at": "2024-12-19T15:01:00Z",
  "transfer_completed_at": null,
  "duration": null,
  "billed_duration": null,
  "recording_url": "https://api.altur.io/api/v1.0/call/cll_gBoLtd02pUI50QwXkFjB/recording",
  "transcript": [],
  "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`	Normalmente `null` para este evento.

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

Respuesta esperada

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