WhatsApp automations: common issues

Nothing is sent

• “Template … is pending, not approved”: wait for Meta, or pick another template. Only approved templates go out; an auto-reply or sequence that uses a message still waiting for Meta says so and starts by itself once approved.
• “Free text can only be sent within 24 hours of the person’s last message”: the person has not written to you recently; use a template. The same applies to form steps.
• “The number … is paused” or Token refused: resume the number, or paste a fresh permanent token under Replace the access token on its card.
• “This person opted out of WhatsApp messages (Replied STOP). Nothing is sent until they send START.”: the phone replied STOP to one of your numbers; nothing can be sent to it from BMexa until they reply START.
• No WhatsApp number is connected, or the number has no lead-alert template: Lead distribution records the WhatsApp recipient as skipped and says why (“Choose a lead-alert template on +… (Marketing › WhatsApp › Numbers)”).
• Everything failed at once with a token message: Meta rotated or revoked the token; see Replace the access token. Message history under Marketing › WhatsApp lists every attempt with the full reason.

Meta’s delivery errors

• 131026 Message undeliverable: the number is not on WhatsApp, or has blocked you.
• 133010 Account not registered: the sending number is not registered on the Cloud API. On the number’s card, enter a six-digit two-step PIN under Register with Meta (the number’s existing PIN, if it has one) and click Register number.
• 131047 Re-engagement message: more than 24 hours since the person’s last message; a template is required.
• 131049 Per-user marketing limit: Meta decided this person has had enough marketing messages for now. A campaign keeps them as pending and tries again after about a day, up to three times; other sends report it as failed.
• 131050: the person stopped marketing messages on WhatsApp’s side. When Meta also reports it through its Stop promotions event, BMexa treats it as a full opt-out until the person taps Resume or sends START.
• 130429 Rate limit: too many messages too fast; the worker sends in small batches, try again later.
• 190 Invalid OAuth access token: the permanent token was revoked; create a new one in Business Manager and paste it on the number.

Replies and statuses do not arrive

Delivery statuses, inbound messages, template approvals and opt-outs all come through Meta’s webhook. Ask your administrator to set the webhook URL, verify token and app secret as described in Connecting your WhatsApp Business number, and to subscribe to the five webhook fields. Marketing › WhatsApp says when they are not reaching BMexa yet (“statuses stay at sent”).