Webhook

Webhooks en tiempo real para cada evento

Recibe confirmaciones de entrega, mensajes entrantes y cambios de estado al instante. Un solo endpoint para WhatsApp, SMS y Email.

Empieza gratis Documentación de la API

Webhook Manager: recibe cada evento en tiempo real

El Webhook Manager de Chat API te permite registrar un endpoint HTTPS en tu servidor y recibir notificaciones instantáneas para cada evento generado por tus canales de mensajería: mensajes entrantes de WhatsApp, confirmaciones de entrega, lecturas, actualizaciones de estado de SMS, aperturas de email y mucho más.

A diferencia del polling tradicional, con los webhooks no necesitas consultar continuamente las API para saber si ha ocurrido algo. El evento llega directamente a tu servidor en milisegundos, con un payload JSON estructurado y una firma HMAC SHA-256 para verificar la autenticidad de cada solicitud.

El sistema está diseñado para máxima fiabilidad: si tu endpoint no está disponible, el Webhook Manager reintenta automáticamente la entrega con backoff exponencial, garantizando que ningún evento se pierda. Cada intento queda registrado en el log con el payload, el código de estado y el tiempo de respuesta, haciendo que la depuración sea sencilla y rápida.

Funcionalidades

Todo lo que necesitas para gestionar webhooks

Un sistema robusto y fiable para recibir eventos en tiempo real de todos tus canales.

Entrega en tiempo real

Eventos entregados instantáneamente a tu endpoint en cuanto ocurren. Sin polling, sin retrasos.

Lógica de reintentos

Reintentos automáticos con backoff exponencial en caso de fallo. Ningún evento se pierde, nunca.

Filtrado de eventos

Suscríbete solo a los eventos que necesitas. Reduce el ruido y optimiza tu servidor.

Firma HMAC

Cada webhook está firmado con HMAC SHA-256. Verifica la autenticidad de cada solicitud entrante.

Registros y depuración

Registros detallados de cada evento enviado. Consulta el payload, el código de estado y los tiempos de respuesta.

Multicanal

Eventos unificados de WhatsApp, SMS y Email en un solo endpoint. Un formato, tres canales.

Cómo funciona

Configuración en 3 pasos

Desde el endpoint hasta la recepción de eventos en minutos.

1

Configuración

Configura el endpoint

Registra la URL de tu servidor que recibirá los eventos. Compatible con HTTPS con verificación de certificado.

2

Filtrar

Selecciona los tipos de eventos

Elige qué tipos de eventos recibir: mensajes entrantes, confirmaciones de entrega, cambios de estado y más.

3

En vivo

Recibe en tiempo real

Los eventos llegan a tu endpoint en milisegundos con el payload JSON completo y la firma HMAC.

Ejemplo de payload

Payload JSON estructurado

Cada evento de webhook se entrega con un payload JSON claro y consistente. Fácil de analizar, fácil de integrar.

message.receivedmessage.deliveredmessage.readmessage.failedtemplate.approved
POST → your-server.com/webhook 
{
  "event": "message.received",
  "channel": "whatsapp",
  "timestamp": "2026-03-14T10:30:00Z",
  "data": {
    "from": "+39123456789",
    "message": "Hello!",
    "type": "text"
  }
}

99.99%

Disponibilidad

<200ms

Entrega

50M+

Eventos / mes

3

Canales

Preguntas frecuentes sobre el Webhook Manager

¿Qué es un webhook y cómo funciona?
Un webhook es una notificación HTTP que el servidor de Chat API envía a tu endpoint cada vez que ocurre un evento (ej. mensaje recibido, entrega confirmada). Tu servidor no necesita hacer nada especial: simplemente expone una URL HTTPS que acepte solicitudes POST en formato JSON.
¿Cómo puedo verificar que las solicitudes webhook son auténticas?
Cada solicitud webhook incluye un encabezado de firma calculado con HMAC SHA-256 usando la clave secreta de tu cuenta. Compara la firma recibida con la que calculas en tu lado: si coinciden, la solicitud es auténtica y no ha sido alterada en tránsito.
¿Qué ocurre si mi endpoint no está disponible?
El Webhook Manager reintenta automáticamente la entrega hasta 5 veces con backoff exponencial (5s, 25s, 125s, 625s, 3125s). Si todos los intentos fallan, el evento se registra como no entregado en el log del sistema, donde puedes analizarlo y activar una reentrega manual.
¿Puedo filtrar eventos para recibir solo los que necesito?
Sí. Al configurar tu webhook puedes seleccionar exactamente qué tipos de eventos quieres recibir: message.received, message.delivered, message.read, message.failed, template.approved y otros. Esto reduce el tráfico a tu servidor y simplifica tu lógica de procesamiento.
¿El Webhook Manager funciona con todos los canales?
Sí. Un único endpoint recibe eventos de los tres canales: WhatsApp, SMS y email. El payload JSON siempre incluye un campo 'channel' que identifica la fuente del evento, permitiéndote gestionar todos los canales con una única lógica de aplicación.
Webhook Manager

¿Listo para recibir eventos en tiempo real?

Configura tu primer webhook en minutos. Sin tarjeta de crédito.

Empieza gratis Hablar con ventas