100%
Integrations › WhatsApp

WhatsApp troubleshooting

What the connection errors, failed messages and held templates mean, and how to fix them.

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 cardWhat to do
The server has no credential keyContact AmigoPOS support: the server is not yet set up to store WhatsApp connections.
Error validating access token, or Invalid OAuth access tokenThe 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_proofThe App Secret is not this app’s. Copy it again from App settings › Basic.
That phone number ID is not on that WhatsApp Business AccountThe 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 errorThe 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 merchantEach number can be connected to one merchant only.
Image needed · wa-20
Capture: The WhatsApp Number card showing the Connection Problem badge and Meta's error message.

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.

CodeMeaningWhat to do
131047More than 24 hours since the customer last wrote, and the message had no templateGet a template approved for that message.
131026The number can’t receive WhatsApp messages: not on WhatsApp, or a very old appCheck the number, or use text.
131042Meta has a payment problem with the accountCheck the card in WhatsApp Manager.
132001The template doesn’t exist in that language on this accountChoose Refresh From Meta; submit the template again if it is missing.
133010The phone number isn’t registered for the APIRegister the number (Setting up the store’s Meta app, step 7), then Test Connection.
131049Meta held back a marketing message to limit how many a customer receivesRewrite the template as a plain transactional message.
Image needed · wa-21
Capture: The SMS Log filtered to WhatsApp messages, with a failed row showing WhatsApp's error code.

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.