⚡Quick answer -
Failures stem from Meta marketing limits, recipient issues (blocked, opted out, invalid), template rejections, or account service issues. Run the utility-template test, alternate-number test, and review dashboard error codes to isolate the cause.
1. Core failure categories
• Marketing message daily limit reached
• Recipient blocked/opted-out/invalid
• Template unapproved, paused, or rejected
• Account billing issue or rare WhatsApp outage
2. Diagnostic test flow
Test | What to do |
Utility template | Send a utility template (order confirmation) to the same number. |
Alternate number | Send the original template to your own WhatsApp. |
Dashboard errors | Check provider logs for error code. |
3. Error-cause matrix
Error message/code | Likely cause | Remedy |
“Marketing limit reached” | Daily cap hit | Wait 24 h or switch to utility template. |
“Template rejected” | Unapproved or edited post-approval | Re-submit template for approval. |
“Number not found” | Invalid / deleted WhatsApp | Verify recipient number. |
“Unverified account billing” | Payment lapse | Clear dues in FBM. |
4. Issues outside Heyo
• Global WhatsApp outages (check @WhatsApp status feed).
• Recipient device offline > 30 days (messages expire).
5. Troubleshooting & support
• Still failing? Capture error codes & screenshots.
• Contact your API provider or Heyo support (in-app chat / connect@heyophone.com).