Webhook
Un webhook es un mecanismo de notificación HTTP que permite a una aplicación enviar datos en tiempo real a otra cuando ocurre un evento. En mensajería empresarial, los webhooks notifican al sistema externo sobre mensajes recibidos, entregas confirmadas o cambios de estado de conversación.
¿Qué es un webhook?
Un webhook es una llamada HTTP inversa: en lugar de que su aplicación consulte periódicamente una API para conocer novedades (polling), el servicio externo le notifica automáticamente en tiempo real cuando ocurre un evento relevante. Este enfoque es mucho más eficiente y reduce la latencia de las notificaciones a milisegundos.
En el contexto de la mensajería empresarial, los webhooks son fundamentales para integrar plataformas de mensajería como WhatsApp, Telegram o SMS con sistemas CRM, ERP o aplicaciones propias. Sin webhooks, sería imposible reaccionar en tiempo real a los mensajes de los clientes.
Cómo funcionan los webhooks
El funcionamiento es sencillo: el desarrollador registra una URL (endpoint) en la plataforma de mensajería. Cuando ocurre un evento (mensaje recibido, entrega confirmada, etc.), la plataforma realiza una petición HTTP POST a esa URL con los datos del evento en formato JSON. El sistema receptor procesa el payload y responde con un código HTTP 200 para confirmar la recepción.
Eventos comunes en mensajería
- Mensaje recibido – Notifica cuando un cliente envía un mensaje
- Confirmación de entrega – Confirma que el mensaje llegó al dispositivo del destinatario
- Confirmación de lectura – Notifica cuando el destinatario abre el mensaje
- Cambio de estado – Actualiza cuando una conversación se abre, se cierra o se reasigna
- Opt-out – Notifica cuando un contacto cancela su suscripción
Seguridad en webhooks
Los webhooks deben protegerse adecuadamente: verificación de firma digital (HMAC-SHA256) para garantizar la autenticidad del payload, uso exclusivo de HTTPS, validación del IP de origen donde sea posible, y tiempo de respuesta inferior a 10 segundos para evitar reintentos.
Webhooks con SendSeven
SendSeven ofrece webhooks para todos los canales soportados: mensajes entrantes, confirmaciones de entrega, cambios de estado de conversación y eventos de opt-out. La configuración se realiza desde el panel de control sin necesidad de código – consulte la guía de configuración de webhooks. Cada webhook incluye verificación de firma y reintentos automáticos en caso de error. Los webhooks son un componente esencial de cualquier plataforma CEP moderna.