List WhatsApp events
Returns a paginated list of your account’s WhatsApp events, the same events Wavix posts to your webhooks, oldest first.
Read events here when your server can’t receive webhooks, or to catch up on events your webhooks missed. Events are recorded even when your account has no webhook for their group.
Behavior: Events are ordered by when Wavix recorded them, oldest first, which can differ from timestamp. To read them all, pass next_cursor from each page as after until has_more is false; later, pass the last non-null next_cursor again, or no after if you have none, to get events recorded since. Events are kept for 30 days, and test events never appear. When both type and group are specified, an event must match both filters.
Requires: Your account must have WhatsApp enabled, must have a subscription plan, and must not be blocked or suspended.
Authorizations
Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.
Query Parameters
Filters events by type.
Type of a WhatsApp event. Each type belongs to one webhook group. Wavix can add event types to a group, so ignore an event whose type you don't recognize. Possible values:
whatsapp.message.received— One of your senders received a message.whatsapp.message.sent— A message you sent has thesentstatus: it isn't delivered yet.whatsapp.message.delivered— A message you sent was delivered to the recipient. WhatsApp can skip it when the recipient reads the message right away.whatsapp.message.read— The recipient opened a message you sent. WhatsApp reports it only when the recipient has read receipts turned on.whatsapp.message.failed— A message you sent wasn't delivered.data.errorsays why.whatsapp.contact.marketing_stopped— A contact asked to stop marketing messages from one of your senders. Meta doesn't deliver marketing templates to the contact until they resume them.whatsapp.contact.marketing_resumed— A contact asked to receive marketing messages from one of your senders again.whatsapp.template.approved— The provider approved one of your templates, so you can send it.whatsapp.template.rejected— The provider rejected one of your templates.whatsapp.template.paused— The provider paused one of your templates.whatsapp.template.disabled— One of your templates is disabled and can't be sent.whatsapp.template.flagged— Meta flagged one of your templates because of negative feedback. It can still be sent, but it's at risk of being paused or disabled.whatsapp.template.category_changed— Meta moved one of your templates to another category, which changes the rate of each message sent with it.whatsapp.template.quality_changed— Meta changed the quality rating of one of your templates.whatsapp.template.updated— The status of one of your templates changed to a value that has no event type of its own, such aspending,in_appeal, ordeleted.whatsapp.sender.connected— One of your senders can send messages within its messaging limit, for example after registration or when a restriction ends.whatsapp.sender.restricted— One of your senders reached its messaging limit. It can't start new conversations until the 24-hour window resets, but it can still reply to customers who messaged it.whatsapp.sender.flagged— The quality rating of one of your senders dropped to low. The status returns toconnectedif the rating returns to medium or high within 7 days.whatsapp.sender.banned— The provider banned one of your senders.whatsapp.sender.disconnected— One of your senders is disconnected from the provider.whatsapp.sender.quality_changed— Meta changed the quality rating of one of your senders.whatsapp.sender.updated— The status of one of your senders changed to a value that has no event type of its own, such aspending,migrated, ordeleted.
whatsapp.message.received, whatsapp.message.sent, whatsapp.message.delivered, whatsapp.message.read, whatsapp.message.failed, whatsapp.contact.marketing_stopped, whatsapp.contact.marketing_resumed, whatsapp.template.approved, whatsapp.template.rejected, whatsapp.template.paused, whatsapp.template.disabled, whatsapp.template.flagged, whatsapp.template.category_changed, whatsapp.template.quality_changed, whatsapp.template.updated, whatsapp.sender.connected, whatsapp.sender.restricted, whatsapp.sender.flagged, whatsapp.sender.banned, whatsapp.sender.disconnected, whatsapp.sender.quality_changed, whatsapp.sender.updated "whatsapp.message.received"
Filters events by the webhook group their type belongs to. Group of WhatsApp event types that a webhook receives. Your account can have one webhook per group. Possible values:
messages— Messages your senders receive, the delivery outcome of messages you send, and contacts' marketing preferences.templates— Changes to the status, category, and quality rating of your templates.senders— Changes to the status and quality rating of your senders.
messages, templates, senders "messages"
Response
A paginated list of WhatsApp events, oldest first.
A paginated list of your account's WhatsApp events, returned by List WhatsApp events.