Webhooks

📡 Webhook Events

Your server will receive webhook events when certain WhatsApp actions happen.
Each event includes a structured payload with the event, instance, sender, apikey, data, and date_time.

🔔 Events List

Event	Description
qrcode.updated	Sends the QR code in base64 format for scanning
connection.update	Informs the status of the WhatsApp connection
messages.set	Sends a list of all messages loaded in WhatsApp. This event occurs only once
messages.upsert	Notifies when a message is received
messages.update	Informs when a message is updated
messages.delete	Informs when a message is deleted
send.message	Notifies when a message is sent
contacts.set	Performs the initial loading of all contacts. This event occurs only once
contacts.upsert	Reloads all contacts with additional information. This event occurs only once
contacts.update	Informs when a contact is updated
presence.update	Informs if the user is online, performing an action such as typing or recording, and their last seen status: ‘unavailable’, ‘available’, ‘typing’, ‘recording’, ‘paused’
chats.set	Sends a list of all loaded chats
chats.update	Informs when a chat is updated
chats.upsert	Sends any new chat information
chats.delete	Notifies when a chat is deleted
groups.upsert	Notifies when a group is created
groups.update	Notifies when a group has its information updated
group.participants.update	Notifies when an action occurs involving a participant: ‘add’, ‘remove’, ‘promote’, ‘demote’

---

📦 Example Webhook Payload

{
    "event": "chats.update",
    "instance": "EEVDQRUIAHCLXBFO",
    "data": [],
    "date_time": "2025-06-09T04:06:38.538Z",
    "sender": "[email protected]",
    "apikey": "2A3FAE85-BB80-4BD8-AB44-5000729B4DB3"
}