Troubleshooting
Fixes for the problems that actually come up: the AI not replying, template rejections, broadcast failures, verification issues, wrong answers and messaging limits.
The problems that actually come up, and what fixes them.
The AI is not replying
Work down this list:
- Is AI enabled? Settings → AI enabled.
- Has someone taken over that conversation? A thread under human takeover gets no AI replies until released. Check for the takeover state in the inbox.
- Is the account paused? Settings → Account. A paused account ignores inbound messages entirely.
- Is the number still connected? Settings should show it as connected.
- Was it a form submission? The agent deliberately does not chat back at a submitted form.
If all of those are fine and messages are arriving in the inbox but going unanswered, contact us — that is a fault, not a setting.
The AI gave a wrong answer
Almost always a knowledge base problem, not a model problem.
- Missing fact → add it, in a clearly labelled block
- Outdated fact → the agent has no way to know; update it
- Invented detail → make the boundary explicit in the persona: "Never quote prices. Say the team will confirm."
- Too long or too formal → set it in the persona: "One or two sentences. Never a paragraph."
Read your transcripts. They tell you exactly which questions your knowledge base does not answer.
Template rejected by Meta
| Reason | Fix |
|---|---|
| Looks like test content | Write the real message you intend to send |
| Promotional content marked UTILITY | Resubmit as MARKETING |
| Variable at the start or end of the body | Add wording around it |
| Unrealistic sample values | Use values a real message would contain |
| Spelling or grammar errors | Meta rejects sloppy copy |
| Display name issue | See Connecting your number |
Edit and resubmit. Rejections do not harm the account, though repeated careless ones attract scrutiny.
Template stuck on PENDING
Click Sync templates — status is pulled from Meta on demand, so the dashboard may simply be showing a stale value.
Most clear in minutes. Meta's stated ceiling is 24 hours.
Broadcast failed for everyone
Usually no payment method on the WhatsApp account. See Billing setup.
Other causes: the template was paused by Meta for quality, or you hit your daily messaging limit.
Broadcast failed for some recipients
Open the campaign for the per-recipient reason.
| Reason | Meaning |
|---|---|
| Not on WhatsApp | No WhatsApp account on that number |
| Invalid number | Wrong format or wrong digits |
| Blocked business | They blocked you |
| Limit reached | Daily cap hit; the rest send tomorrow |
Retry failed re-sends only to the failures.
Number verification failing
| Symptom | Cause |
|---|---|
| Code never arrives | The number already has a WhatsApp account — delete it first |
| Business verification rejected | Name or address does not match your registration documents |
| Display name rejected | Promotional wording or unrelated to the registered name |
| Number rejected | Virtual or VoIP number Meta will not accept |
Cannot send a free-form message
The customer has not messaged you in over 24 hours. Meta only allows an approved template outside that window. The inbox tells you when this applies.
API returning 422
Read the message — it names the exact problem.
- Template not found → create it, then Sync templates after approval
- Not approved → wait for
APPROVED - Variable count mismatch → supply exactly what the template expects
- No media header → remove
header_document_urlor use a template that has one
See the API reference.
Messaging limit reached
New numbers start around 250 business-initiated conversations a day. Tiers rise automatically with consistent good-quality sending. It cannot be bought.
Still stuck
karthik@skandaai.in or WhatsApp +91 98665 17854. You reach the engineers who built it, not a ticket queue.
Need it to work differently?
The platform is the starting point, not the ceiling. Tell us what your process needs and we will build it — at a price we will negotiate.