WaFloW.ai envía distintos eventos a través de webhooks para que puedas reaccionar en tiempo real ante la actividad de WhatsApp.
Este documento explica qué eventos existen, cuándo se disparan y para qué sirven.
Qué es un evento en WaFloW.ai #
Un evento es una notificación automática que WaFloW.ai envía a un webhook cuando ocurre una acción concreta, por ejemplo:
- Llega un mensaje de WhatsApp.
- Se envía un mensaje.
- Cambia el estado de un dispositivo.
Cada evento incluye datos estructurados para que tu sistema los procese.
Eventos de mensajes entrantes #
📩 Mensaje entrante de WhatsApp #
Este evento se dispara cuando:
- Un contacto envía un mensaje al número conectado.
- El mensaje es recibido correctamente por WaFloW.ai.
Usos habituales:
- Procesar mensajes en sistemas externos.
- Clasificar conversaciones.
- Activar lógica personalizada.
- Registrar mensajes en bases de datos.
Eventos de mensajes salientes #
Mensaje saliente de WhatsApp #
Este evento se dispara cuando:
- Se envía un mensaje desde WaFloW.ai.
- El mensaje sale hacia el contacto.
Usos habituales:
- Auditar envíos.
- Sincronizar mensajes con otros sistemas.
- Analizar tiempos de respuesta.
- Controlar automatizaciones externas.
Información incluida en los eventos #
Aunque el formato exacto puede variar, los eventos suelen incluir:
- Tipo de evento.
- Identificador del dispositivo.
- Identificador del contacto.
- Contenido del mensaje.
- Fecha y hora.
- Dirección (entrante o saliente).
Estos datos permiten construir flujos avanzados.
Eventos de estado (según plan) #
Además de mensajes, pueden existir eventos relacionados con:
- Conexión o desconexión de dispositivos.
- Cambios de estado operativos.
- Alertas técnicas.
Estos eventos ayudan a monitorizar la estabilidad.
Cómo usar los eventos correctamente #
Recomendaciones:
- Filtra los eventos que realmente necesitas.
- Evita lógica pesada en el webhook.
- Usa colas o procesos asíncronos.
- Documenta qué hace cada evento.
Un buen diseño evita sobrecarga.
Errores comunes #
- ❌ Escuchar todos los eventos sin criterio.
- ❌ Procesar lógica compleja directamente en el webhook.
- ❌ No controlar errores o reintentos.
- ❌ No registrar los eventos recibidos.
Resumen #
Los eventos de WaFloW.ai permiten:
- Reaccionar en tiempo real.
- Integrar WhatsApp con sistemas externos.
- Controlar mensajes entrantes y salientes.
- Escalar automatizaciones avanzadas.