WhatsApp Error 131026: Message Undeliverable in Envoy
You're sending messages through Envoy and seeing Error 131026 in your conversation or logs. The API call succeeded, but the message was blocked at delivery time.
Check these in order:
| # | Check | Where in Envoy |
|---|---|---|
| 1 | Is the contact's phone number valid and on WhatsApp? | Contact profile > Phone number |
| 2 | Are you within the 24-hour window? | Check the last inbound message timestamp in the conversation |
| 3 | If outside 24 hours, are you using an approved template? | Message composer will prompt for template selection |
| 4 | Is the template actually approved? | Settings > Templates (check status column) |
| 5 | Is your quality rating Green? | Meta WhatsApp Manager |
24-Hour Window Expired
The contact hasn't messaged you in 24 hours, and you're trying to send a free-form message. Use an approved template instead. Envoy will prompt you when the window has expired.
Template Parameter Mismatch
Your template has placeholder variables but the values passed don't match the expected format. Check the template in Envoy Settings > Templates and compare the parameters.
Recipient Blocked Your Number
The contact blocked your business number on WhatsApp. There's no way to message them through WhatsApp. Use an alternative channel (email, SMS).
Ecosystem Suppression (131049 Related)
If you're seeing 131026 alongside 131049 errors, your account may be quality-restricted. See our quality rating guide.
- Don't retry the same message repeatedly. Each failed retry counts against your quality score
- Don't send the same template to the same contact multiple times. This was the trigger for a customer whose ecosystem errors spiked dramatically after migrating to Envoy
For the complete list of all 10 causes and the debug checklist:
Was this article helpful?
Related Articles
WhatsApp API Permission Error (#3) in Envoy
Messages fail with: "(#3) Application does not have the API granular permission to make this call."
Error CodesWhatsApp Error 131060: Companion Device Issue in Envoy
You see Error 131060 in your Envoy conversation logs: "This message is unavailable" or "This message is currently unavailable."
Error CodesWhatsApp Error #200: No Permission to Send Messages in Envoy
You see: "(#200) You do not have the necessary permissions required to send messages on behalf of this WhatsApp Business Account."