Errors by cause
Account and access
Senders and WhatsApp Business Accounts
Recipients
Templates
Webhooks
Requests
Temporary and other errors
How delivery errors reach you
A request error comes back in the API response. For its format, see Request errors. A delivery error comes later: the API accepted the message, and it wasn’t delivered. Wavix retries temporary failures itself, so you get a delivery error only after Wavix stops retrying. Wavix sends awhatsapp.message.failed event to your webhook for the messages group, and the event’s data.error says why. Retrieve a WhatsApp message and List WhatsApp messages return the same object in the error field.
To decide what to do about the message, use
action. Every delivery error has it, including codes and subcodes that Wavix adds later. To tell causes apart, use code and subcode, not message. Wavix can add codes and subcodes, so handle a code you don’t recognize as DELIVERY_FAILED, and a subcode you don’t recognize by code alone.
To send a message again, send a new request with a new idempotency_key. A request with the same key returns the original message and sends nothing.
To receive these events, create a webhook for the messages group. To read events you missed, use List WhatsApp events.
Get help
If an error persists, contact support@wavix.com. For a request error, include theinstance value from the response. For a delivery error, include the message_uuid from the event. The Wavix team uses them to find your request or message.