Los webhooks permiten a WaFloW.ai enviar eventos en tiempo real a sistemas externos cada vez que ocurre una acción relevante, como un mensaje entrante o saliente de WhatsApp.
Este documento explica qué son, para qué sirven y cómo crearlos correctamente.
¿Qué es un webhook? #
Un webhook es una URL externa a la que WaFloW.ai envía información automáticamente cuando ocurre un evento.
En lugar de que otro sistema “pregunte” constantemente, WaFloW.ai:
- Detecta el evento.
- Envía los datos al instante.
- Permite reaccionar en tiempo real.
¿Para qué sirven los webhooks en WaFloW.ai? #
Los webhooks permiten:
- Recibir mensajes entrantes en otros sistemas.
- Procesar mensajes salientes.
- Activar flujos externos (Make, n8n, sistemas propios).
- Registrar eventos en bases de datos.
- Integrar WhatsApp fuera de GoHighLevel.
Son ideales para automatizaciones avanzadas.
Requisitos antes de crear un webhook #
Antes de crear un webhook, asegúrate de tener:
- Una API Key activa.
- Un endpoint (URL) preparado para recibir datos.
- Un sistema capaz de aceptar peticiones HTTP.
- Un plan que incluya webhooks.
Dónde se crean los webhooks #
Para crear un webhook:
- Accede a tu cuenta de WaFloW.ai.
- Entra en la subcuenta correspondiente.
- Ve a la sección de API / Webhooks.
- Selecciona la opción Crear webhook.
Cómo crear un webhook paso a paso #
- Haz clic en Crear nuevo webhook.
- Introduce la URL del endpoint que recibirá los datos.
- Selecciona los eventos que deseas escuchar.
- Guarda la configuración.
El webhook quedará activo inmediatamente.
Eventos disponibles (visión general) #
Dependiendo de la configuración, puedes recibir eventos como:
- Mensaje entrante de WhatsApp.
- Mensaje saliente.
- Cambio de estado del dispositivo.
- Otros eventos operativos.
👉 El detalle de eventos se explica en un documento específico.
Pruebas del webhook #
Recomendaciones:
- Usa endpoints de prueba antes de producción.
- Verifica que recibes correctamente los datos.
- Controla errores y reintentos.
- Loggea los eventos recibidos.
Probar bien evita problemas en producción.
Buenas prácticas #
- Usa HTTPS siempre.
- Valida las peticiones recibidas.
- Controla errores en tu endpoint.
- No bloquees la respuesta del webhook.
- Documenta cada webhook creado.
Resumen #
Crear webhooks permite:
- Recibir eventos de WhatsApp en tiempo real.
- Integrar WaFloW.ai con sistemas externos.
- Construir automatizaciones avanzadas.
- Escalar más allá del CRM.