Each webhook category exposes a different set of events. every event and helps you decide which ones to subscribe to based on what you are building.
Event | Fires when |
chat.message.received | A customer sends you a message |
chat.message.edited | A message is edited |
chat.message.deleted | A message is deleted |
chat.message.reacted | A reaction is added to a message |
chat.message.sent | Your message has been accepted and handed to delivery |
chat.message.delivered | Your message reached the recipient's device |
chat.message.failed | Delivery failed and will not be retried further |
user.preference.updated | A customer changed a preference, such as turning off promotional messages |
messagetemplate.approval.updated | A template's approval status changed |
miniapp.closed | A customer closed a mini app |
Running a support desk: Subscribe to chat.message.received at minimum, plus chat.message.edited and chat.message.deleted if you display conversation history.
Confirming delivery: Subscribe to chat.message.delivered and chat.message.failed. These are the two terminal outcomes and are what billing follows.
Sending OTPs: Subscribe to chat.message.failed above all, so you can fall back to another channel quickly.
Sending promotions: Subscribe to user.preference.updated, so your opt-out list stays current.
Watching template reviews: Subscribe to messagetemplate.approval.updated, so your systems learn about an approval or rejection without anyone checking the console.