WhatsApp API Error Reference

Solution:

Your WhatsApp Business account permissions were revoked. Reconnect your account through the Zernio dashboard to re-authorize access.

Solution:

The access token is no longer valid. This can happen after token expiration or a password change. Reconnect your WhatsApp Business account.

Solution:

Your account was locked by Meta, usually due to policy violations. Check your account status in Meta Business Suite and appeal if necessary.

Solution:

You can only send free-form messages within 24 hours of the customer's last message. After that, use an approved template message to re-initiate the conversation.

Solution:

Send an approved template message to re-engage. Free-form messages are only allowed within the 24-hour customer service window.

Solution:

You've exceeded your phone number's messaging tier limit. Zernio handles this automatically with retries and exponential backoff. Your tier increases as your quality rating improves.

Solution:

The phone number is not valid or doesn't have WhatsApp. Ensure the number is in E.164 format (e.g., +14155552671) and the recipient has an active WhatsApp account.

Solution:

In Meta's sandbox/test mode, you can only message pre-registered numbers. Add this number to your WhatsApp test recipients in the Meta Developer Dashboard, or switch to production mode.

Solution:

The recipient's phone number is not registered on WhatsApp or their account cannot receive messages. Verify the number and try a different contact method.

Solution:

The template name or language code doesn't match any approved template. Double-check the exact template name and use the full language code (e.g., "en_US" not "en").

Solution:

Meta paused this template due to low quality or policy violations. Use a different template, or fix the issue and submit it for re-approval.

Solution:

The parameters you provided don't match the template's expected format. Ensure all required parameters are included and match the placeholder types (text, currency, date, etc.).

Solution:

WhatsApp couldn't fetch the media file. Ensure the URL is publicly accessible, returns the correct Content-Type header, and the file is not behind authentication.

Solution:

The media format is not supported. WhatsApp supports: images (JPEG, PNG), videos (MP4 with H.264), audio (AAC, MP3, OGG), and documents (PDF, DOC, XLS, etc.).

Solution:

WhatsApp's spam detection flagged your message. Review your content and messaging practices. Avoid sending identical messages to many recipients in quick succession.

Solution:

Meta's WhatsApp Cloud API is experiencing issues. Zernio automatically retries with exponential backoff. If the issue persists, check Meta's status page.