Ejemplos de Webhook de finalización de llamada de WhatsApp

Para consultar el catálogo exhaustivo derivado del esquema, consulta todos los ejemplos.

Qué es

Gestiona eventos de finalización de llamadas de WhatsApp.

Antes de empezar

Crea un endpoint HTTPS público en tu aplicación.
Configura un endpoint de Webhook de YCloud para los tipos de eventos que necesites.
Guarda el secreto de firma del endpoint de forma segura.
Haz que el procesamiento de eventos sea idempotente.

Cómo funciona

YCloud envía una solicitud HTTP POST cuando ocurre el evento. Verifica la firma, registra el evento de forma duradera, devuelve una respuesta 2xx y procesa el trabajo lento de manera asíncrona.

Solicitud

Los escenarios a continuación muestran solicitudes enviadas a tu URL de Webhook. Trata el id del evento como el identificador de entrega y usa type para enrutar el payload.

Respuesta

Devuelve un estado 2xx tras aceptar el evento.

HTTP/1.1 200 OK

Para la configuración de endpoints, validación de firmas y comportamiento de reintentos, consulta Configurar webhooks.

Tanto la empresa como el usuario de WhatsApp pueden finalizar la llamada en cualquier momento. Cuando cualquiera de ellos finaliza la llamada, recibes un Webhook de finalización de llamada:

Llamada completada

Solicitud

{
  "id": "evt_6757b889a5a42d369ef48481",
  "type": "whatsapp.call.terminate",
  "apiVersion": "v2",
  "createTime": "2024-12-10T03:42:01.822Z",
  "callingTerminate": {
    "id": "6757b889960b25543b9ecc67",
    "wacid": "wacid.HBgNNjI4MTM2MTkwNTE",
    "phoneId": "461269257068832",
    "from": "+6281361905133",
    "fromUserId": "ID.13491208655302741918",
    "fromParentUserId": "ID.11815799212886844830",
    "to": "+6283138205150",
    "direction": "USER_INITIATED",
    "startTime": 1733734738000,
    "endTime": 1733734771000,
    "duration": 33,
    "status": "COMPLETED"
  }
}

Respuesta

Confirma la entrega tras aceptar el evento de forma duradera.

HTTP/1.1 200 OK

Explicación

Enruta el evento por type, deduplícalo mediante id y traslada el trabajo lento o propenso a errores a un procesador asíncrono.

Llamada fallida

Solicitud

{
  "id": "evt_675907f431c55113a751d0e7",
  "type": "whatsapp.call.terminate",
  "apiVersion": "v2",
  "createTime": "2024-12-11T03:33:08.679Z",
  "callingTerminate": {
    "id": "675907a13ae4a901f05fee95",
    "wacid": "wacid.HBgNODYxNTE1NzEzNzYyM",
    "phoneId": "461269257068832",
    "from": "+6281361905133",
    "fromUserId": "ID.13491208655302741918",
    "fromParentUserId": "ID.11815799212886844830",
    "to": "+6283138205150",
    "direction": "USER_INITIATED",
    "startTime": 1733826484000,
    "endTime": 1733826637000,
    "duration": 30,
    "status": "FAILED",
    "errorCode": "131000"
  }
}

Respuesta

Confirma la entrega tras aceptar el evento de forma duradera.

HTTP/1.1 200 OK

Explicación

Enruta el evento por type, deduplícalo mediante id y traslada el trabajo lento o propenso a errores a un procesador asíncrono.

Primeros pasos

Guías

Endpoints

Webhooks

Ejemplos de Webhook de finalización de llamada de WhatsApp

Qué es

Antes de empezar

Cómo funciona

Solicitud

Respuesta

Llamada completada

Solicitud

Respuesta

Explicación

Llamada fallida

Solicitud

Respuesta

Explicación

​Qué es

​Antes de empezar

​Cómo funciona

​Solicitud

​Respuesta

​Llamada completada

​Solicitud

​Respuesta

​Explicación

​Llamada fallida

​Solicitud

​Respuesta

​Explicación

Qué es

Antes de empezar

Cómo funciona

Solicitud

Respuesta

Llamada completada

Solicitud

Respuesta

Explicación

Llamada fallida

Solicitud

Respuesta

Explicación