Understanding WhatsApp Errors

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 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 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 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/\<id>") 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