Webhooks allow WaFloW.ai to send real-time events to external systems whenever a relevant action occurs, such as an incoming or outgoing WhatsApp message.
This document explains what they are, what they are used for, and how to create them correctly.
What is a webhook? #
A webhook is an external URL to which WaFloW.ai automatically sends information when an event occurs.
Instead of another system constantly “asking,” WaFloW.ai:
- Detect the event.
- Send the data instantly.
- Allows you to react in real time.
What are webhooks used for in WaFloW.ai? #
Webhooks allow you to:
- Receive incoming messages on other systems.
- Process outgoing messages.
- Activate external flows (Make, n8n, proprietary systems).
- Record events in databases.
- Integrate WhatsApp outside of GoHighLevel.
They are ideal for advanced automation.
Requirements before creating a webhook #
Before creating a webhook, make sure you have:
- An active API Key.
- An endpoint (URL) prepared to receive data.
- A system capable of accepting HTTP requests.
- A plan that includes webhooks.
Where webhooks are created #
To create a webhook:
- Log in to your WaFloW.ai account.
- Log in to the corresponding subaccount.
- Go to the API/Webhooks section.
- Select the Create webhook option.
How to create a webhook step by step #
- Click Create new webhook.
- Enter the URL of the endpoint that will receive the data.
- Select the events you want to listen to.
- Save the settings.
The webhook will be active immediately.
Available events (overview) #
Depending on the configuration, you may receive events such as:
- Incoming WhatsApp message.
- Outgoing message.
- Device status change.
- Other operational events.
👉 Details of events are explained in a separate document.
Webhook testing #
Recommendations:
- Use test endpoints before production.
- Verify that you are receiving the data correctly.
- Controls errors and retries.
- Log the received events.
Thorough testing prevents problems in production.
Best practices #
- Always use HTTPS.
- Validates the requests received.
- Check for errors in your endpoint.
- Do not block the webhook response.
- Document each webhook created.
Summary #
Creating webhooks allows you to:
- Receive WhatsApp events in real time.
- Integrate WaFloW.ai with external systems.
- Build advanced automations.
- Moving beyond CRM.
