Saltar al contenido principal
Acciones

Enviar los datos de la llamada a tu sistema

Después de cada llamada, envía el resumen, la transcripción y los datos recopilados a tu CRM, webhook o base de datos.

Llamada API envía la llamada a tu propio sistema cuando termina: el resumen, la transcripción, el estado de ánimo y todo lo que el agente recopiló. Úsala para crear un lead en tu CRM, iniciar una automatización o llevar tus propios registros. Si tu sistema no está disponible, la petición se reintenta y no se pierde nada.

Configurarlo​

  1. Añade la acción

    Abre el agente → Acciones → Añadir herramienta → Post call → Llamada API.

  2. Apúntala a tu endpoint
    CampoQué introducir
    Nombrep. ej., Sincronización de leads con el CRM
    CondiciónCuándo enviarla, p. ej., si quien llama quiere comprar. Vacío: después de cada llamada
    URL del endpoint APITu endpoint, p. ej., https://hooks.example.com/hanc
    Método HTTPPOST para la mayoría de los sistemas; también funcionan GET, PUT, PATCH y DELETE
    Encabezados, Parámetros de consultaOpcionales, p. ej., una clave API
  3. Da forma a la petición (opcional)
    • Cuerpo (JSON): tus propios campos. Escribe {{ para insertar una variable de la llamada, p. ej., {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Enviar solo mis campos: omite los datos estándar de la llamada, para sistemas que solo aceptan su propia estructura.
  4. Decide qué pasa si falla
    • Reintentos en caso de error: las pausas antes de cada nuevo intento cuando tu endpoint no responde con 2xx. Por defecto: 1 min, 5 min, 30 min, 2 h, 6 h, 24 h, 48 h.
    • Notificación de fallos: un correo después del último intento (por defecto), después de cada intento fallido o nunca. Enviar a: vacío significa el propietario de la cuenta.

¿Qué recibirá mi endpoint? en el editor muestra la petición exacta.

Qué recibe tu endpoint​

Con POST, PUT y PATCH, un cuerpo JSON: tus campos combinados con los campos de la llamada:

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Con GET y DELETE, los mismos campos van en la cadena de consulta, sin los anidados (transcripción, estado de ánimo, datos recopilados).

Cada petición lleva X-Hanc-Delivery-Id —el mismo en todos los intentos de una entrega, para que puedas descartar duplicados— y X-Hanc-Attempt con el número de intento. Cada intento caduca a los 30 segundos. Todos los intentos aparecen en CRM → Comunicaciones, donde puedes volver a enviar una entrega fallida. Más detalles: Webhooks y entrega.

Casos de uso​

  • Crear un lead o un ticket en tu CRM.
  • Iniciar una automatización no-code con los datos de la llamada.
  • Llevar tu propio archivo de llamadas.
En esta página