--- title: Understanding WhatsApp Errors slug: understanding-whatsapp-errors icon: 🔴 docTags: createdAt: 2026-07-28T11:38:56.723Z --- 1. **Peach-First Support**: Users are advised to contact the **Peach Support Team** for template errors, parameter issues, and account setup problems, providing key details like **Template ID / Name**, **Recipient Number**, and **Message ID / Broadcast ID**. 2. **Simplified Meta References**: Replaced confusing Meta Manager navigation advice with a direct link to [Meta Business Support Home](#) specifically for account flags, template category changes, or policy appeals. 3. **Billing Guidance**: Clarified that Peach manages billing for most accounts, but customers on direct Meta billing should manage their payments on Meta. *** # Troubleshooting WhatsApp Message Delivery Errors When a WhatsApp message fails to reach a recipient, an error code is generated. Below is a comprehensive guide to understanding these error codes, why they happen, and how to resolve them. :::hint{type="info"} **Need help from Peach Support?** When reaching out to our support team regarding message delivery issues, please share: - Recipient Phone Number(s) - Error Code & Exact Error Message - Broadcast URL / Chat Url ("/conversations/\") or Template URL ::: *** ## Quick Navigation & Table of Contents - [1. Recipient & Phone Number Issues](#) - [2. Messaging Window & Opt-Out Restrictions](#) - [3. Template & Flow Errors](#) - [4. Account, Quality & Rate Limit Restrictions](#) - [5. Account Setup, Billing & Verification](#) - [6. Media & Content Formatting Issues](#) - [7. System & Temporary Errors](#) *** ## 1. Recipient & Phone Number Issues These errors happen when there is a problem reaching the target recipient's phone number or location. ### Error 470 - **Message:** *"This recipient cannot receive WhatsApp messages right now."* - **Reason:** The user's phone number may be temporarily inactive, disconnected, or WhatsApp is uninstalled. - **Action:** Verify the recipient's phone number or try reaching them through an alternative channel. ### Error 1013 - **Message:** *"This phone number is not a valid WhatsApp recipient."* - **Reason:** The target phone number is invalid or not registered on WhatsApp. - **Action:** Check for missing country codes or typos in the contact’s phone number. ### Error 130472 - **Message:** *"This recipient cannot receive this message right now. Please try again later."* - **Reason:** The recipient's account status or app version temporarily prevents them from receiving this specific payload. - **Action:** Re-try sending after some time. ### Error 130497 - **Message:** *"This WhatsApp number cannot message recipients in this country."* - **Reason:** Your sender account has international messaging restrictions or country-level routing limits applied. - **Action:** Contact Peach Support to review country routing configuration for your account. ### Error 131021 - **Message:** *"This recipient cannot receive WhatsApp messages right now."* - **Reason:** The recipient's device cannot accept WhatsApp messages currently. - **Action:** Re-try delivery later or confirm active status with the user. ### Error 131026 - **Message:** *"This message could not be delivered to the recipient."* - **Reason:** General delivery failure to the destination user (e.g., user blocked the number or has privacy restrictions). - **Action:** Delivery cannot be forced to blocked or restricted users. *** ## 2. Messaging Window & Opt-Out Restrictions WhatsApp enforces rules around marketing permissions, 24-hour service windows, and user frequency limits. ### Error 131047 - **Message:** *"The 24-hour customer service window has closed. Send an approved template instead."* - **Reason:** A free-form session message was attempted more than 24 hours after the recipient's last incoming message. - **Action:** Send an approved Message Template to resume conversation with the customer. ### Error 131049 - **Message:** *"WhatsApp did not deliver this marketing message to protect the recipient experience. Try again later."* - **Reason:** Meta's automated protection mechanisms paused delivery to prevent user spam. - **Action:** Retry sending at a later time or refine campaign audience targeting. ### Error 131050 - **Message:** *"This recipient has opted out of marketing messages from your business."* - **Reason:** The customer explicitly opted out of marketing broadcasts from your account. - **Action:** Respect opt-out preferences. Only transactional communications or explicit user-initiated replies should be sent. ### Error 131056 - **Message:** *"Too many messages were sent to this recipient. Please try again later."* - **Reason:** Frequency capping triggered for this recipient. - **Action:** Wait for the rate-limit window to clear before sending additional messages. *** ## 3. Template & Flow Errors These errors occur when template formatting, variables, or interactive components (like WhatsApp Flows) have missing or incorrect parameters. ### Error 132000 - **Message:** *"The template message is missing a required value."* - **Reason:** One or more dynamic variables (e.g., `{{1}}`, `{{2}}`) were left blank. - **Action:** Provide values for all required variables in your template mapping. ### Error 132001 - **Message:** *"This template is no longer available. Choose another approved template."* - **Reason:** The selected template has been deleted or is unavailable. - **Action:** Choose an active template from your template library. If you believe this is an error, contact Peach Support with the **Template ID / Name**. ### Error 132005 - **Message:** *"This template translation is no longer available. Choose another approved template."* - **Reason:** The requested language/locale version of the template is missing or deleted. - **Action:** Select a supported language version or re-submit the translation via Peach. ### Error 132007 - **Message:** *"This template does not match its approved format. Review the template values."* - **Reason:** The number of parameters, header media, or button variables provided does not match the approved format. - **Action:** Review your template configuration in Peach. Contact Peach Support if template parameters appear correct. ### Error 132012 - **Message:** *"A template value has an invalid format. Review the template values."* - **Reason:** A variable value contains illegal characters, invalid URLs, or exceeds character limits. - **Action:** Check your variable values for unexpected formatting or special characters. ### Error 132015 - **Message:** *"This template is paused by Meta and cannot be sent."* - **Reason:** Meta temporarily paused this template due to negative user feedback or low quality ratings. - **Action:** You can review account flags and submit an appeal via [Meta Business Support Home](https://business.facebook.com/business-support-home) or contact Peach Support with your **Template ID** for guidance. ### Error 132016 - **Message:** *"This template is disabled by Meta and cannot be sent."* - **Reason:** Meta permanently disabled this template following policy violations or unaddressed quality issues. - **Action:** Create a new template in Peach with updated messaging, or submit an appeal on [Meta Business Support Home](https://business.facebook.com/business-support-home). ### Error 132068 - **Message:** *"This WhatsApp Flow is blocked and cannot be sent."* - **Reason:** The interactive Flow attached to this message has validation errors or compliance flags. - **Action:** Contact Peach Support with the **Flow Name / ID** to resolve the block. ### Error 132069 - **Message:** *"This WhatsApp Flow is temporarily limited. Please try again later."* - **Reason:** The attached Flow is undergoing temporary rate limiting or system maintenance. - **Action:** Retry sending after a short wait. *** ## 4. Account, Quality & Rate Limit Restrictions These errors trigger when account thresholds, quality ratings, or daily messaging limits block outgoing delivery. ### Error 471 - **Message:** *"Sending is temporarily restricted for this phone number. Review its quality rating and try again later."* - **Reason:** The phone number's quality score dropped, triggering a temporary cool-down period. - **Action:** Pause outbound marketing broadcasts temporarily. Reach out to Peach Support to review campaign practices and health status. ### Error 131005 - **Message:** *"WhatsApp denied access to send this message. Check your phone number setup."* - **Reason:** Sending permissions or integration authorization for your number experienced an issue. - **Action:** Contact Peach Support so our team can verify your channel connection. ### Error 131031 - **Message:** *"This WhatsApp account is restricted. Check its account status in Meta."* - **Reason:** Account-level restrictions were applied due to policy or verification flags. - **Action:** Visit [Meta Business Support Home](https://business.facebook.com/business-support-home) to review account flags or submit an appeal. You can also contact Peach Support for assistance. ### Error 131048 - **Message:** *"Sending is temporarily restricted for this phone number. Review its quality rating and try again later."* - **Reason:** Quality rating drop triggered a temporary sending restriction. - **Action:** Wait for the restriction period to lift. Contact Peach Support for tips on improving list quality and opt-in standards. ### Error 131057 - **Message:** *"This WhatsApp account is restricted because of its quality rating."* - **Reason:** Account restriction resulting from sustained low quality scores. - **Action:** Check account health status on [Meta Business Support Home](https://business.facebook.com/business-support-home) or reach out to Peach Support. ### Error 131058 - **Message:** *"This phone number has reached its sending limit. Please try again later."* - **Reason:** You have reached your current 24-hour unique recipient tier limit (e.g., 1K, 10K, or 100K messages). - **Action:** Wait for your 24-hour limit window to reset. Consistently high quality ratings will automatically upgrade your tier limit over time. *** ## 5. Account Setup, Billing & Verification These errors affect messaging due to administrative settings, display names, or billing. ### Error 131037 - **Message:** *"This message cannot be delivered because the WhatsApp display name is not approved."* - **Reason:** Your sender display name is either pending review or was rejected. - **Action:** Contact Peach Support to help submit or update your display name request. ### Error 131042 - **Message:** *"Your WhatsApp Business Account has a payment issue. Review its billing settings in Meta or Peach."* - **Reason:** A billing method issue is holding up outbound message delivery. - **Action:** - If your billing is managed by **Peach**, please contact Peach Support to resolve your payment method immediately. - If you pay **directly to Meta**, update your payment method directly in Meta Business Manager. ### Error 131045 - **Message:** *"This WhatsApp phone number has an invalid certificate. Check its Meta setup."* - **Reason:** The phone number security certificate is missing or invalid. - **Action:** Contact Peach Support to refresh your channel certificate configuration. ### Error 133000 - **Message:** *"This WhatsApp phone number is still being deregistered. Please try again later."* - **Reason:** The phone number is undergoing account transfer or deregistration. - **Action:** Allow the migration process to complete before trying again. *** ## 6. Media & Content Formatting Issues These errors happen when message payloads or media attachments fail validation. ### Error 131008 - **Message:** *"A required message detail is missing. Review the message and try again."* - **Reason:** Crucial payload attributes are missing. - **Action:** Verify your message fields and retry, or contact Peach Support with your **Message ID**. ### Error 131009 - **Message:** *"A message detail is invalid. Review the message and try again."* - **Reason:** Message parameter formatting contains unsupported values. - **Action:** Review dynamic inputs and formatting rules. ### Error 131051 - **Message:** *"This type of message is not supported for this WhatsApp number."* - **Reason:** Your sender account type does not support the requested message layout or feature. - **Action:** Contact Peach Support to confirm your channel capabilities. ### Error 131052 - **Message:** *"WhatsApp could not download the attached media. Check the media and try again."* - **Reason:** Meta servers were unable to fetch the media attachment (e.g., link expired, inaccessible URL, or invalid file type). - **Action:** Ensure the media link is publicly accessible and uses supported file formats. ### Error 131053 - **Message:** *"WhatsApp could not upload the attached media. Check the media and try again."* - **Reason:** Media processing failed (e.g., file exceeds size limits). - **Action:** Verify file sizes remain within WhatsApp limits (images \< 5MB, documents \< 100MB). *** ## 7. System & Temporary Errors These are intermittent service glitches on WhatsApp's network. ### Error 131000 - **Message:** *"We could not deliver this message. Please try again later."* - **Reason:** Generic transient delivery error on Meta’s network. - **Action:** Wait a few minutes and retry delivery. ### Error 131016 - **Message:** *"WhatsApp is temporarily unavailable. Please try again later."* - **Reason:** Temporary network disruption or maintenance on Meta infrastructure. - **Action:** Retry sending after a short period. Contact Peach Support if failures persist across extended periods.