Ejemplos de Webhook de Calling Connect de WhatsApp

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

Qué es

Gestione eventos de conexión de llamadas de WhatsApp.

Antes de comenzar

Cree un endpoint HTTPS público en su aplicación.
Configure un endpoint de webhook de YCloud para los tipos de eventos que necesite.
Guarde el secreto de firma del endpoint de forma segura.
Haga que el procesamiento de eventos sea idempotente.

Cómo funciona

YCloud envía una solicitud HTTP POST cuando ocurre el evento. Verifique la firma, registre el evento de forma duradera, devuelva una respuesta 2xx y procese el trabajo lento de forma asíncrona.

Solicitud

Los escenarios a continuación muestran solicitudes entregadas a su URL de webhook. Trate el id del evento como el identificador de entrega y utilice type para enrutar el payload.

Respuesta

Devuelva un estado 2xx después de aceptar el evento.

HTTP/1.1 200 OK

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

Calling Connect iniciado por el usuario

Cuando un usuario de WhatsApp llama a su empresa, se activará un webhook de Call Connect con una oferta SDP:

Solicitud

{
  "id": "evt_6757b723a5a42d369ef48480",
  "type": "whatsapp.call.connect",
  "apiVersion": "v2",
  "createTime": "2024-12-10T03:36:03.749Z",
  "callingConnect": {
    "id": "6757b723960b25543b9ecc66",
    "wacid": "wacid.HBgNNjI4MTM2MTkwNTEzMxrtLopSdPMwd",
    "phoneId": "461269257068832",
    "from": "+6281361905133",
    "fromUserId": "ID.13491208655302741918",
    "fromParentUserId": "ID.11815799212886844830",
    "to": "+6283138205150",
    "direction": "USER_INITIATED",
    "sdpType": "offer",
    "sdp": "<<RFC 4566 SDP>>"
  }
}

Respuesta

Confirme la entrega tras aceptar el evento de forma duradera.

HTTP/1.1 200 OK

Explicación

Enrute el evento por type, elimine duplicados mediante id y traslade el trabajo lento o propenso a errores a un procesador asíncrono.

Calling Connect iniciado por la empresa

Cuando la empresa inicia una nueva llamada hacia el usuario de WhatsApp, se activará un webhook de Call Connect con una respuesta SDP:

Solicitud

{
  "id": "evt_676e5a0d7a9cb742d02d7645",
  "type": "whatsapp.call.connect",
  "apiVersion": "v2",
  "createTime": "2024-12-27T07:41:01.554Z",
  "callingConnect": {
    "id": "676e5a0d94c533526d3c5ad5",
    "wacid": "wacid.HBgNNjI4MTM2MTkwNTEzMxUCABE",
    "phoneId": "461269257068832",
    "from": "+6283138205150",
    "to": "+6281361905133",
    "toUserId": "ID.13491208655302741918",
    "toParentUserId": "ID.11815799212886844830",
    "direction": "BUSINESS_INITIATED",
    "sdpType": "answer",
    "sdp": "<<RFC 4566 SDP>>",
    "dialTime": 1735283452000
  }
}

Respuesta

Confirme la entrega tras aceptar el evento de forma duradera.

HTTP/1.1 200 OK

Explicación

Enrute el evento por type, elimine duplicados mediante id y traslade el trabajo lento o propenso a errores a un procesador asíncrono.

Primeros pasos

Guías

Endpoints

Webhooks

Ejemplos de Webhook de Calling Connect de WhatsApp

Qué es

Antes de comenzar

Cómo funciona

Solicitud

Respuesta

Calling Connect iniciado por el usuario

Solicitud

Respuesta

Explicación

Calling Connect iniciado por la empresa

Solicitud

Respuesta

Explicación

​Qué es

​Antes de comenzar

​Cómo funciona

​Solicitud

​Respuesta

​Calling Connect iniciado por el usuario

​Solicitud

​Respuesta

​Explicación

​Calling Connect iniciado por la empresa

​Solicitud

​Respuesta

​Explicación

Qué es

Antes de comenzar

Cómo funciona

Solicitud

Respuesta

Calling Connect iniciado por el usuario

Solicitud

Respuesta

Explicación

Calling Connect iniciado por la empresa

Solicitud

Respuesta

Explicación