WAHA provides comprehensive webhook support for real-time event notifications. Configure your webhook URL to receive events.

Available Webhook Events

Below is a list of all available webhook events in WAHA:

Session Events

EventDescription
session.statusTriggered when the session status changes (STOPPED, STARTING, SCAN_QR_CODE, WORKING, FAILED)

Message Events

EventDescription
messageIncoming message received
message.reactionUser reacts or removes a reaction to a message
message.anyFired on all message creations, including your own
message.ackServer or recipient gets, reads or plays the message
message.revokedMessage is revoked by sender or recipient

Group Events

EventDescription
group.v2.joinYou joined or were added to a group
group.v2.leaveYou left or were removed from a group
group.v2.updateGroup information is updated
group.v2.participantsGroup participants change (join, leave, promote to admin)

Presence Events

EventDescription
presence.updateMost recent presence information for a chat (online, typing, recording)

Poll Events

EventDescription
poll.voteReceive new votes for a poll sent
poll.vote.failedFailed to decrypt a vote from a user

Chat Events

EventDescription
chat.archiveChat is archived or unarchived

Call Events

EventDescription
call.receivedCall is received by the user
call.acceptedCall is accepted by the user
call.rejectedCall is rejected by the user

Label Events

EventDescription
label.upsertLabel is created or updated
label.deletedLabel is deleted
label.chat.addedLabel is added to a chat
label.chat.deletedLabel is deleted from a chat

System Events

EventDescription
event.responseEvent response is received
event.response.failedEvent response failed to decrypt
engine.eventInternal engine event

Webhook Configuration

Configure webhooks when creating or updating a session by providing the webhook URL and events to subscribe to in the session configuration