API, webhooks y conector
Webhooks de Waspy
Waspy avisa a tu URL cuando entra un mensaje, cambia un estado, o se crea un chat o un contacto.
Actualizado el
Qué eventos hay
Los webhooks están en Scale y Enterprise, igual que la API.
En Configuración, junto a las API keys, se cargan los webhooks. Los eventos son:
- Mensaje recibido (
message.received) - Cambio de estado de mensaje (
message.status_changed) - Conversación nueva (
conversation.created) - Contacto nuevo (
contact.created)
Solo un administrador puede crearlos. Si la URL ya existe, Waspy no deja duplicarla.
La firma
Cada pedido trae el encabezado X-Waspy-Signature con la forma t=. La firma es HMAC-SHA256 de la hora, un punto y el cuerpo. Si no cierra, no proceses el pedido.
El detalle, los reintentos y cómo desactivar un endpoint que no responde están en la referencia de webhooks.
Qué no reemplaza
El webhook avisa al momento. El conector MCP no empuja eventos: cada consulta lee la cuenta cuando se la pedís. Si necesitás enterarte de un mensaje nuevo sin preguntar, el webhook es el camino.
La clave para administrar webhooks se crea en Crear una API key.
¿Te sirvió este artículo?