Webhooks
Receive WhatsApp events in real time by linking webhooks to one or more connections in Pingo Notify.
What are Webhooks?
Webhooks allow Pingo Notify to notify your application whenever something happens on WhatsApp.
Think of webhooks as automatic alerts sent to your system.
Whenever an event occurs, Pingo Notify sends this information to a URL configured by you.
Connections and Webhooks
The relationship between connections and webhooks is flexible.
- A connection can be linked to multiple webhooks
- A webhook can receive events from multiple connections
This allows different integration combinations, depending on your system’s needs.
When should you use Webhooks?
Use webhooks when you want to:
- Receive notifications about sent or received messages
- Automate processes based on WhatsApp
- Update systems in real time
- Integrate WhatsApp with other applications
If you only send messages, using webhooks is optional.
How it works
Basic flow:
WhatsApp → Connection → Pingo Notify → Webhook → Your application
Whenever something happens on any linked connection, the event is sent to the webhook.
Configure a Webhook
Webhook URL
Enter the HTTPS address that will receive the events.
Select events
Choose which types of events your application should receive.
Webhook status
Enable or pause event delivery when needed.
Link connections
Select one or more connections that will trigger events for this webhook.
Available events
The main events that can be sent are:
Message sent
When an unofficial connection sends a message via WhatsApp.
Message received
When a message arrives at the connected WhatsApp.
Message edited or deleted
When a message is changed or removed.
Presence updated
When there is a change in the contact’s presence state.
What Webhooks do and do not do
- Receive events in real time
- Can be linked to multiple connections
- Do not send messages
- Do not create connections
Summary
- Webhooks receive WhatsApp events
- A webhook can listen to multiple connections
- A connection can trigger events to multiple webhooks
Use webhooks when your application needs to automatically react to what happens on one or more connections.