Troubleshooting (WhatsApp)
This guide compiles the most common WhatsApp Business API errors and how to resolve them. Use this reference when messages are not being delivered or when there are failures in the integration with the Patagon AI Agent.
Common Errors and Solutions
100
Invalid parameter
Attempt to send a message outside the 24h window without using an approved template
Use an approved template or wait for the customer to reply to reopen the window
131009
Parameter value is not valid
Invalid parameter or newly approved template not yet synchronized
Check the template parameters. Wait up to 10 minutes after approval
131026
Message Undeliverable
Invalid destination number, user blocked the company, or user is not on WhatsApp
Verify that the number is valid. If it persists, the user may have blocked your company
131030
Payment Required
Payment method not configured or billing failure
Set up a valid credit card in Meta Business Suite
131047
Rate limit hit
Excessive API calls in a short period
Reduce sending frequency. Implement retry with progressive intervals
131051
Phone number is not registered
Number was deregistered or there is a problem with two-factor verification
Check the number status in WABA. Reconfigure verification if necessary
How to Identify the Error
On the Patagon AI platform, you can check the message delivery status on the Conversations page. Failed messages will display the corresponding error code.
If you need more details, access the WhatsApp Manager in Meta Business Suite to check logs and number status.
Frequent Issues
Messages are not being sent
Check if there is a valid payment method configured (error 131030)
Confirm that you are using an approved template for messages outside the 24h window (error 100)
Check if the company number is active in WABA (error 131051)
Template was rejected by Meta
Review whether there is a clear company identification
Check spelling and grammar
Confirm that variables are well structured
See the guide Create message templates
Number quality has dropped
Pause sending for 1-2 days
Review recent templates
Clean the contact list
See the guide Monitor your number's health
When to Contact Support?
If the issue persists after following the guidelines above, contact the Patagon AI team providing:
The error code displayed
The phone number affected
The approximate date and time of the issue
The template used (if applicable)
Our team will support you throughout the entire resolution process.
Last updated