Skip to main content
Each WhatsApp error has a page that says what happened, whether to try again, and how to fix it. If you have the error code, search for it, or open the link that comes with the error.

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 a whatsapp.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 the instance 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.