Most problems show up in one of two places: the badge on the WhatsApp Number card, and the status of a message in the SMS Log. A message WhatsApp could not send has already gone by text wherever the store allows it.
Connecting
| Message on the card | What to do |
|---|---|
| The server has no credential key | Contact AmigoPOS support: the server is not yet set up to store WhatsApp connections. |
| Error validating access token, or Invalid OAuth access token | The token has expired, was revoked, or was copied incompletely. Generate a new one with expiration Never (Setting up the store’s Meta app, step 6) and enter it with Change. |
| Invalid appsecret_proof | The App Secret is not this app’s. Copy it again from App settings › Basic. |
| That phone number ID is not on that WhatsApp Business Account | The two IDs don’t belong together. Copy both again from API Setup (Setting up the store’s Meta app, step 3) with the right number selected in From. |
| A permissions error | The system user isn’t assigned the app or the WhatsApp account, or the token is missing one of the two WhatsApp permissions. |
| This phone number is already connected to another merchant | Each number can be connected to one merchant only. |
Image needed · wa-20
No webhook received yet
- The Callback URL and Verify token in the Meta app must match the card exactly: use the Copy buttons.
- The three webhook fields — messages, message_template_status_update and template_category_update — must be subscribed.
- The app must be published (Setting up the store’s Meta app, step 8).
- If several stores share the app, it has one webhook, set to any one of those stores’ Callback URL.
A message shows failed
Find it in the SMS Log: a failed WhatsApp message carries WhatsApp’s own error code.
| Code | Meaning | What to do |
|---|---|---|
| 131047 | More than 24 hours since the customer last wrote, and the message had no template | Get a template approved for that message. |
| 131026 | The number can’t receive WhatsApp messages: not on WhatsApp, or a very old app | Check the number, or use text. |
| 131042 | Meta has a payment problem with the account | Check the card in WhatsApp Manager. |
| 132001 | The template doesn’t exist in that language on this account | Choose Refresh From Meta; submit the template again if it is missing. |
| 133010 | The phone number isn’t registered for the API | Register the number (Setting up the store’s Meta app, step 7), then Test Connection. |
| 131049 | Meta held back a marketing message to limit how many a customer receives | Rewrite the template as a plain transactional message. |
Image needed · wa-21
Templates
- Rejected — Meta’s reason is shown on the row; fix the wording and submit it again.
- Paused or Disabled — Meta stopped it after customers blocked or reported it. Improve it, or write a new one.
- Flagged as marketing — see WhatsApp message templates.
Blocked
A WhatsApp message recorded as blocked was not sent: the customer had replied STOP, or the only template for that message is held as marketing. Nothing was charged for it.