Inbound missing
Check the Meta account is connected and the webhook/subscription is active for the intended business number. Check whether you are viewing the correct SHVYA WhatsApp inbox, not another tenant's connected account.
Manual/AI send failed
Verify that the lead is in a pipeline bound to this sender. Check account registration, current health, recipient phone formatting and the Meta service window. Do not fall back to an unrelated connected number.
Error groups
- 401/403 or OAuth/permission: verify provider app/account access and registration.
- Invalid template: ensure Meta approved the correct language, body variables, header media and buttons.
- Billing-related Meta errors (including code 131042): review WhatsApp Business billing/payment status in Meta; SHVYA cannot fix a provider funding block with a different prompt.
- Rate limit (429): respect provider retry/backoff and account pacing. Do not flood retries.
- 400 or missing media: validate the template variable set, accessible file and supported content type.
- Queued/uncertain: check the original outbound receipt before trying again to avoid duplicate messages.
Campaign failures
Inspect the failed recipient and template setup, not only the campaign summary. Correct invalid rows or account issues first and retry only confirmed failures.
Evidence checklist
Account type (API/Coexistence/Hosted), masked sender/recipient numbers, lead, template name, provider code, request time, and statuses visible in SHVYA. Never share access tokens.