Whatsapp sender changed
Wavix sends these events to your webhook of the senders group when the registration status or quality rating of one of your senders changes, so you learn that a sender is connected, restricted, or banned without polling it. Wavix reads the status and quality rating of senders from the provider every 15 minutes, so an event can arrive up to 15 minutes after the change. A test event you send to the webhook arrives here too.
Each change is a separate event, and type names it, so your server keeps its copy of a sender’s status and quality rating current.
Behavior: Return a 2xx status within 10 seconds to acknowledge the event; Wavix doesn’t follow redirects, so a 3xx response counts as a failed attempt. After a failed attempt, Wavix retries about 5 seconds, 30 seconds, 2 minutes, 10 minutes, 1 hour, 6 hours, and 24 hours later, up to 8 attempts in total; a test event isn’t retried. Events can arrive more than once and out of order, so discard repeats by id and keep the state from the event with the latest timestamp.
Requires: A webhook of the senders group. A disabled webhook gets only test events. Its URL must use https, have a valid TLS certificate, and resolve only to public addresses that Wavix allows. If the host resolves to another address at send time, Wavix doesn’t send the event and doesn’t retry it. Verify every request as the Standard Webhooks specification describes, with one of its libraries or by hand. The webhook-signature and webhook-timestamp headers give the steps.
Limits: List WhatsApp events keeps each event except test for 30 days, so you can catch up on events your server missed within that time.
Headers
Body
The event Wavix posts to your webhook URL.
- WhatsAppSenderConnectedEvent
- WhatsAppSenderRestrictedEvent
- WhatsAppSenderFlaggedEvent
- WhatsAppSenderBannedEvent
- WhatsAppSenderDisconnectedEvent
- WhatsAppSenderQualityChangedEvent
- WhatsAppSenderUpdatedEvent
- WhatsAppWebhookTestEvent
Event of type whatsapp.sender.connected. One of your senders can send messages within its messaging limit, for example after registration or when a restriction ends. Posted to your webhook and returned by List WhatsApp events.
Response
Your server acknowledges the event. Any 2xx status counts as delivered.