WaFloW.ai sends different events via webhooks so you can react in real time to WhatsApp activity.
This document explains what events exist, when they are triggered, and what they are used for.
What is an event in WaFloW.ai? #
An event is an automatic notification that WaFloW.ai sends to a webhook when a specific action occurs, for example:
- A WhatsApp message arrives.
- A message is sent.
- Change the status of a device.
Each event includes structured data for your system to process.
Incoming message events #
📩 Incoming WhatsApp message #
This event is triggered when:
- A contact sends a message to the connected number.
- The message is received correctly by WaFloW.ai.
Common uses:
- Process messages in external systems.
- Sort conversations.
- Enable custom logic.
- Record messages in databases.
Outgoing message events #
WhatsApp outgoing message #
This event is triggered when:
- A message is sent from WaFloW.ai.
- The message is sent to the contact.
Common uses:
- Audit shipments.
- Synchronize messages with other systems.
- Analyze response times.
- Control external automations.
Information included in events #
Although the exact format may vary, events typically include:
- Type of event.
- Device identifier.
- Contact identifier.
- Message content.
- Date and time.
- Address (incoming or outgoing).
This data allows you to build advanced flows.
State events (as planned) #
In addition to messages, there may be events related to:
- Connecting or disconnecting devices.
- Operational status changes.
- Technical alerts.
These events help monitor stability.
How to use events correctly #
Recommendations:
- Filter the events you really need.
- Avoid heavy logic in the webhook.
- Use queues or asynchronous processes.
- Document what each event does.
Good design avoids overload.
Common mistakes #
- ❌ Listen to all events indiscriminately.
- ❌ Process complex logic directly in the webhook.
- ❌ Do not check for errors or retries.
- ❌ Do not record events received.
Summary #
WaFloW.ai events enable:
- React in real time.
- Integrate WhatsApp with external systems.
- Monitor incoming and outgoing messages.
- Scale advanced automations.