| Event | When it fires |
|---|---|
session.created | A token is created. |
session.deleted | A token is deleted. |
connection.state | Runtime connection changes. |
auth.qr | A new pairing QR is generated. |
auth.paired | WhatsApp credentials are paired. |
message.received | The connected device receives an inbound message. |
message.sent | An outgoing message is accepted by WhatsApp. |
message.receipt | WhatsApp sends a delivery/read receipt. |
message.failed | An outgoing send fails. |
stanza.error | WhatsApp returns a protocol-level error. |
stream.failure | The runtime stream fails. |
API Reference
Event catalog
Webhook and timeline event names.
These event names can appear in the token timeline. The same list is accepted when creating a webhook.