Skip to main content

Resolving 'Message Undeliverable' when Sending Template Messages

Updated this week

Summary

When sending template messages through Wati, you may encounter the error "Message Undeliverable" or error code #131026. This article explains the possible reasons behind this error and provides step-by-step solutions to resolve it.

Instructions

Here’s what the error looks like:

Possible Reasons for the Error

This error can occur due to one or more of the following reasons:

  1. The recipient's phone number is not linked to WhatsApp.

    • Ensure that the number you are messaging is registered on WhatsApp.

  2. The recipient has blocked your business.

    • If a user has blocked your number, messages cannot be delivered.

  3. The recipient has not accepted WhatsApp’s latest Terms of Service and Privacy Policy.

    • Users must accept the latest policies to receive messages.

  4. The recipient is using an outdated version of WhatsApp.

    • The user must update WhatsApp to a compatible version:

      • Android: 2.21.15.15 or later

      • SMBA (Small Business App): 2.21.15.15 or later

      • iOS: 2.21.170.4 or later

      • SMBI (Small Business iOS): 2.21.170.4 or later

      • KaiOS: 2.2130.10 or later

      • Web: 2.2132.6 or later

  5. WhatsApp’s marketing message limit has been reached.

    • To maintain a high-quality user experience, WhatsApp restricts the number of marketing template messages a user can receive within a specific time frame across all businesses.

How to Resolve This Error

If you encounter this issue, you can ask the recipient to perform the following checks using an alternative communication method:

  1. Ensure they can send messages to your WhatsApp Business number.

    • Ask them to initiate a chat with your business to confirm that messages are going through.

  2. Check if they have blocked your WhatsApp Business number.

    • The recipient should navigate to Settings > Privacy > Blocked and verify that your number is not listed.

  3. Confirm they have accepted WhatsApp’s latest Terms of Service.

    • They can check this under Settings > Help or Settings > Application Information. If prompted, they should accept the latest terms.

  4. Update WhatsApp to the latest version.

    • The recipient should visit their app store (Google Play Store or Apple App Store) and update WhatsApp if they are using an outdated version.

Frequently Asked Questions (FAQs)

General questions

1. What does the "Message Undeliverable" or error #131026 mean?

This error indicates that a template message sent via Wati could not be delivered to the recipient. It can occur due to various reasons, such as the recipient not using WhatsApp, blocking your business, or having outdated app versions.

2. Is this error caused by Wati?

No, this error is triggered by WhatsApp’s messaging restrictions and policies. Wati does not control the delivery of messages once they are sent.

Troubleshooting

3. How do I know if a recipient has blocked my business?

If a recipient has blocked your business, messages sent to them will not be delivered. You can ask them via an alternative communication method to check their Blocked Contacts under Settings > Privacy > Blocked.

4. What should I do if the recipient hasn't accepted WhatsApp’s latest Terms of Service?

Ask the recipient to navigate to Settings > Help or Settings > Application Information in WhatsApp. If prompted, they should accept the latest terms.

5. How can I check if the recipient is using an outdated version of WhatsApp?

If your message is not being delivered, ask the recipient to update WhatsApp through the Google Play Store or Apple App Store. They should be using at least the following versions:

  • Android: 2.21.15.15 or later

  • SMBA: 2.21.15.15 or later

  • iOS: 2.21.170.4 or later

  • KaiOS: 2.2130.10 or later

  • Web: 2.2132.6 or later

6. Why is my message not being delivered even when the recipient has WhatsApp?

If the recipient meets all technical requirements, WhatsApp may limit the number of marketing messages they receive within a certain timeframe.

Preventive measures

7. How can I avoid this error in the future?

  • Ensure that recipients have opted in to receive messages from your business.

  • Send messages to active WhatsApp users.

  • Encourage recipients to keep WhatsApp updated.

  • Avoid excessive marketing messages that could trigger WhatsApp's restrictions.

8. What if none of these solutions work?

If the issue persists, consider reaching out to WhatsApp support or reviewing their official documentation for additional details.

Did this answer your question?