Skip to main content
Con la API usted pregunta; con webhooks Notifique te lo dice. Al igual que una aplicación bancaria empuja cuando llega una transferencia, su backend no necesita hacer sondeo cada segundo.

​
En breve

  • Cada entrega es un POST application/json a la URL que registraste.
  • Los eventos message.* e instance.* son solo WhatsApp (Telegram usa telegram.*).
  • Habilite solo los eventos que su integración necesita.
  • Responda 2xx rápidamente; el trabajo pesado va a una cola de tu lado.
Configuración general: Webhooks. Seguridad (firma HMAC): Seguridad del webhook.

​
Cómo se ve el POST

Sobre estándar para cada evento: Encabezados: X-Notifique-Signature, X-Notifique-Timestamp, X-Workspace-Id.

​
Qué debe devolver tu servidor

¿Procesamiento lento? Devuelva 200 inmediatamente y procese en segundo plano. Tardar más de 10 segundos cuenta como timeout y es posible que el evento se reenvíe.
Valide X-Notifique-Signature y una marca de tiempo reciente. Detalles: Seguridad de webhooks.

​
Referencia de eventos

Use estos eventos al integrar bots, soporte, ERP o automatización en WhatsApp.
Los nombres message.* son solo WhatsApp. Telegram usa telegram.*: Eventos de Telegram.

​
Mensajes que envías

​
Mensajes que recibes

El mensaje entrante solo se activa si está habilitado en Configuración → Mensajes recibidos (almacenamiento y/o webhook). El nombre heredado del panel message.received todavía funciona: el cuerpo usa whatsapp.received.

​
Instancia (conexión del número)

El paso de actualizar código del Inicio rápido puede usar este webhook en lugar de sondeo (instance.qrcode).

​
Carga útil por evento

Cuerpo POST completo. El sobre (event, ids, timestamp) coincide con el ejemplo anterior; abajo cambia lo que va en data.
Se activa en el primer clic en un enlace corto en el envío (espacio de trabajo con enlaces cortos habilitados).
Pueden añadirse campos extra sin romper consumidores.
newContent puede ser null cuando no esté disponible.
phoneNumber puede ser null en algunos casos.

​
Próximos pasos