[{"data":1,"prerenderedAt":483},["ShallowReactive",2],{"help-article-messaging-why-messages-fail":3,"help-siblings-messaging":423},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"category":5,"order":10,"difficulty":11,"time_to_complete":12,"related":13,"body":17,"_type":417,"_id":418,"_source":419,"_file":420,"_stem":421,"_extension":422},"\u002Fhelp\u002Fmessaging\u002Fwhy-messages-fail","messaging",false,"","Why messages fail and how to fix them","Common reasons WhatsApp messages fail to deliver and step-by-step solutions for each error type.",14,"beginner","4 minutes",[14,15,16],"\u002Fhelp\u002Fmessaging\u002F24-hour-window","\u002Fhelp\u002Fmessaging\u002Fsend-template-message","\u002Fhelp\u002Fcampaigns\u002Fbest-practices",{"type":18,"children":19,"toc":397},"root",[20,28,34,41,48,59,69,75,84,93,99,108,117,123,132,158,164,173,182,188,197,206,212,221,230,236,245,254,260,266,278,284,296,302,357,363,368],{"type":21,"tag":22,"props":23,"children":25},"element","h1",{"id":24},"why-messages-fail-and-how-to-fix-them",[26],{"type":27,"value":8},"text",{"type":21,"tag":29,"props":30,"children":31},"p",{},[32],{"type":27,"value":33},"When a message fails, AIsoule shows a red error indicator. Here are the most common causes and fixes.",{"type":21,"tag":35,"props":36,"children":38},"h2",{"id":37},"common-failure-reasons",[39],{"type":27,"value":40},"Common failure reasons",{"type":21,"tag":42,"props":43,"children":45},"h3",{"id":44},"_1-phone-number-doesnt-have-whatsapp",[46],{"type":27,"value":47},"1. Phone number doesn't have WhatsApp",{"type":21,"tag":29,"props":49,"children":50},{},[51,57],{"type":21,"tag":52,"props":53,"children":54},"strong",{},[55],{"type":27,"value":56},"Error:",{"type":27,"value":58}," \"Recipient not on WhatsApp\" or \"Invalid WhatsApp number\"",{"type":21,"tag":29,"props":60,"children":61},{},[62,67],{"type":21,"tag":52,"props":63,"children":64},{},[65],{"type":27,"value":66},"Fix:",{"type":27,"value":68}," The number you're trying to reach doesn't have WhatsApp installed. Verify the number is correct and has WhatsApp active.",{"type":21,"tag":42,"props":70,"children":72},{"id":71},"_2-outside-24-hour-window-no-template-used",[73],{"type":27,"value":74},"2. Outside 24-hour window (no template used)",{"type":21,"tag":29,"props":76,"children":77},{},[78,82],{"type":21,"tag":52,"props":79,"children":80},{},[81],{"type":27,"value":56},{"type":27,"value":83}," \"Message failed to send\" or \"Outside service window\"",{"type":21,"tag":29,"props":85,"children":86},{},[87,91],{"type":21,"tag":52,"props":88,"children":89},{},[90],{"type":27,"value":66},{"type":27,"value":92}," You can only send free-form messages within 24 hours of the customer's last message. Use a template message instead.",{"type":21,"tag":42,"props":94,"children":96},{"id":95},"_3-template-not-approved",[97],{"type":27,"value":98},"3. Template not approved",{"type":21,"tag":29,"props":100,"children":101},{},[102,106],{"type":21,"tag":52,"props":103,"children":104},{},[105],{"type":27,"value":56},{"type":27,"value":107}," \"Template not found\" or \"Template status invalid\"",{"type":21,"tag":29,"props":109,"children":110},{},[111,115],{"type":21,"tag":52,"props":112,"children":113},{},[114],{"type":27,"value":66},{"type":27,"value":116}," Check Settings → Templates. The template must show \"Approved\" status. If it's \"Pending\" or \"Rejected\", you can't use it.",{"type":21,"tag":42,"props":118,"children":120},{"id":119},"_4-invalid-phone-number-format",[121],{"type":27,"value":122},"4. Invalid phone number format",{"type":21,"tag":29,"props":124,"children":125},{},[126,130],{"type":21,"tag":52,"props":127,"children":128},{},[129],{"type":27,"value":56},{"type":27,"value":131}," \"Invalid parameter\" or \"Phone number format error\"",{"type":21,"tag":29,"props":133,"children":134},{},[135,139,141,148,150,156],{"type":21,"tag":52,"props":136,"children":137},{},[138],{"type":27,"value":66},{"type":27,"value":140}," Phone numbers must include the country code without + or 00. Example: ",{"type":21,"tag":142,"props":143,"children":145},"code",{"className":144},[],[146],{"type":27,"value":147},"919876543210",{"type":27,"value":149}," (India), ",{"type":21,"tag":142,"props":151,"children":153},{"className":152},[],[154],{"type":27,"value":155},"14155551234",{"type":27,"value":157}," (US).",{"type":21,"tag":42,"props":159,"children":161},{"id":160},"_5-account-disconnected",[162],{"type":27,"value":163},"5. Account disconnected",{"type":21,"tag":29,"props":165,"children":166},{},[167,171],{"type":21,"tag":52,"props":168,"children":169},{},[170],{"type":27,"value":56},{"type":27,"value":172}," \"Authentication failed\" or \"Token expired\"",{"type":21,"tag":29,"props":174,"children":175},{},[176,180],{"type":21,"tag":52,"props":177,"children":178},{},[179],{"type":27,"value":66},{"type":27,"value":181}," Go to Settings → WhatsApp Accounts → click \"Test Connection\". If it fails, reconnect your account or generate a new access token.",{"type":21,"tag":42,"props":183,"children":185},{"id":184},"_6-messaging-limit-reached",[186],{"type":27,"value":187},"6. Messaging limit reached",{"type":21,"tag":29,"props":189,"children":190},{},[191,195],{"type":21,"tag":52,"props":192,"children":193},{},[194],{"type":27,"value":56},{"type":27,"value":196}," \"Rate limit exceeded\" or \"Messaging limit reached\"",{"type":21,"tag":29,"props":198,"children":199},{},[200,204],{"type":21,"tag":52,"props":201,"children":202},{},[203],{"type":27,"value":66},{"type":27,"value":205}," Meta limits how many unique contacts you can message per day. New accounts start at 250\u002Fday and increase with good quality. Wait 24 hours or improve your quality rating.",{"type":21,"tag":42,"props":207,"children":209},{"id":208},"_7-number-blocked-by-recipient",[210],{"type":27,"value":211},"7. Number blocked by recipient",{"type":21,"tag":29,"props":213,"children":214},{},[215,219],{"type":21,"tag":52,"props":216,"children":217},{},[218],{"type":27,"value":56},{"type":27,"value":220}," \"Recipient unavailable\" or \"User blocked\"",{"type":21,"tag":29,"props":222,"children":223},{},[224,228],{"type":21,"tag":52,"props":225,"children":226},{},[227],{"type":27,"value":66},{"type":27,"value":229}," The recipient has blocked your business number. You cannot send messages to users who have blocked you.",{"type":21,"tag":42,"props":231,"children":233},{"id":232},"_8-media-too-large",[234],{"type":27,"value":235},"8. Media too large",{"type":21,"tag":29,"props":237,"children":238},{},[239,243],{"type":21,"tag":52,"props":240,"children":241},{},[242],{"type":27,"value":56},{"type":27,"value":244}," \"Media size exceeds limit\"",{"type":21,"tag":29,"props":246,"children":247},{},[248,252],{"type":21,"tag":52,"props":249,"children":250},{},[251],{"type":27,"value":66},{"type":27,"value":253}," WhatsApp limits: Images (5MB), Videos (16MB), Documents (100MB), Audio (16MB). Compress your file and try again.",{"type":21,"tag":35,"props":255,"children":257},{"id":256},"how-to-retry-failed-messages",[258],{"type":27,"value":259},"How to retry failed messages",{"type":21,"tag":42,"props":261,"children":263},{"id":262},"in-a-conversation",[264],{"type":27,"value":265},"In a conversation",{"type":21,"tag":29,"props":267,"children":268},{},[269,271,276],{"type":27,"value":270},"Click the ",{"type":21,"tag":52,"props":272,"children":273},{},[274],{"type":27,"value":275},"retry icon",{"type":27,"value":277}," next to the failed message to resend it.",{"type":21,"tag":42,"props":279,"children":281},{"id":280},"in-a-campaign",[282],{"type":27,"value":283},"In a campaign",{"type":21,"tag":29,"props":285,"children":286},{},[287,289,294],{"type":27,"value":288},"Go to the campaign detail page → click ",{"type":21,"tag":52,"props":290,"children":291},{},[292],{"type":27,"value":293},"\"Retry Failed\"",{"type":27,"value":295}," to resend to all failed recipients.",{"type":21,"tag":35,"props":297,"children":299},{"id":298},"preventing-failures",[300],{"type":27,"value":301},"Preventing failures",{"type":21,"tag":303,"props":304,"children":305},"ol",{},[306,317,327,337,347],{"type":21,"tag":307,"props":308,"children":309},"li",{},[310,315],{"type":21,"tag":52,"props":311,"children":312},{},[313],{"type":27,"value":314},"Validate phone numbers",{"type":27,"value":316}," before importing — ensure they have country codes",{"type":21,"tag":307,"props":318,"children":319},{},[320,325],{"type":21,"tag":52,"props":321,"children":322},{},[323],{"type":27,"value":324},"Use templates",{"type":27,"value":326}," for first-time messages",{"type":21,"tag":307,"props":328,"children":329},{},[330,335],{"type":21,"tag":52,"props":331,"children":332},{},[333],{"type":27,"value":334},"Monitor quality rating",{"type":27,"value":336}," in Meta Business Suite",{"type":21,"tag":307,"props":338,"children":339},{},[340,345],{"type":21,"tag":52,"props":341,"children":342},{},[343],{"type":27,"value":344},"Don't spam",{"type":27,"value":346}," — high block rates will restrict your account",{"type":21,"tag":307,"props":348,"children":349},{},[350,355],{"type":21,"tag":52,"props":351,"children":352},{},[353],{"type":27,"value":354},"Keep access tokens fresh",{"type":27,"value":356}," — regenerate if they expire",{"type":21,"tag":35,"props":358,"children":360},{"id":359},"still-failing",[361],{"type":27,"value":362},"Still failing?",{"type":21,"tag":29,"props":364,"children":365},{},[366],{"type":27,"value":367},"If messages continue to fail after trying these fixes:",{"type":21,"tag":303,"props":369,"children":370},{},[371,387,392],{"type":21,"tag":307,"props":372,"children":373},{},[374,376,385],{"type":27,"value":375},"Check ",{"type":21,"tag":377,"props":378,"children":382},"a",{"href":379,"rel":380},"https:\u002F\u002Fmetastatus.com",[381],"nofollow",[383],{"type":27,"value":384},"Meta Platform Status",{"type":27,"value":386}," for outages",{"type":21,"tag":307,"props":388,"children":389},{},[390],{"type":27,"value":391},"Test your connection in Settings → Accounts → Test Connection",{"type":21,"tag":307,"props":393,"children":394},{},[395],{"type":27,"value":396},"Contact our support team via WhatsApp",{"title":7,"searchDepth":398,"depth":398,"links":399},2,[400,411,415,416],{"id":37,"depth":398,"text":40,"children":401},[402,404,405,406,407,408,409,410],{"id":44,"depth":403,"text":47},3,{"id":71,"depth":403,"text":74},{"id":95,"depth":403,"text":98},{"id":119,"depth":403,"text":122},{"id":160,"depth":403,"text":163},{"id":184,"depth":403,"text":187},{"id":208,"depth":403,"text":211},{"id":232,"depth":403,"text":235},{"id":256,"depth":398,"text":259,"children":412},[413,414],{"id":262,"depth":403,"text":265},{"id":280,"depth":403,"text":283},{"id":298,"depth":398,"text":301},{"id":359,"depth":398,"text":362},"markdown","content:help:messaging:why-messages-fail.md","content","help\u002Fmessaging\u002Fwhy-messages-fail.md","help\u002Fmessaging\u002Fwhy-messages-fail","md",[424,426,429,432,435,438,441,444,447,450,453,456,459,461,464,467,470,473,476,479,482],{"_path":14,"title":425},"Understanding the 24-hour messaging window",{"_path":427,"title":428},"\u002Fhelp\u002Fmessaging\u002Fassigning-conversations","Assigning conversations to team members",{"_path":430,"title":431},"\u002Fhelp\u002Fmessaging\u002Fcatalog-commerce","WhatsApp Catalog & Commerce",{"_path":433,"title":434},"\u002Fhelp\u002Fmessaging\u002Finteractive-messages","Sending interactive messages (buttons & lists)",{"_path":436,"title":437},"\u002Fhelp\u002Fmessaging\u002Finternal-notes","Using internal notes on conversations",{"_path":439,"title":440},"\u002Fhelp\u002Fmessaging\u002Fmessage-formatting","Message formatting and emoji support",{"_path":442,"title":443},"\u002Fhelp\u002Fmessaging\u002Fmessage-status","Message status explained (sent, delivered, read, failed)",{"_path":445,"title":446},"\u002Fhelp\u002Fmessaging\u002Fpayment-links","Sending payment links in chat",{"_path":448,"title":449},"\u002Fhelp\u002Fmessaging\u002Fproduct-catalog","Using the product catalog in conversations",{"_path":451,"title":452},"\u002Fhelp\u002Fmessaging\u002Freactions","Sending reactions to messages",{"_path":454,"title":455},"\u002Fhelp\u002Fmessaging\u002Fread-receipts","Managing read receipts",{"_path":457,"title":458},"\u002Fhelp\u002Fmessaging\u002Freply-to-message","Using reply-to-message (quoting)",{"_path":15,"title":460},"Sending template messages",{"_path":462,"title":463},"\u002Fhelp\u002Fmessaging\u002Fsending-interactive-buttons","Sending voice call interactive buttons",{"_path":465,"title":466},"\u002Fhelp\u002Fmessaging\u002Fsending-media","Sending media messages (images, videos, documents)",{"_path":468,"title":469},"\u002Fhelp\u002Fmessaging\u002Fsending-text","Sending text messages",{"_path":471,"title":472},"\u002Fhelp\u002Fmessaging\u002Fshared-team-inbox","How the shared team inbox works",{"_path":474,"title":475},"\u002Fhelp\u002Fmessaging\u002Fusing-canned-responses","Using canned responses (quick replies)",{"_path":477,"title":478},"\u002Fhelp\u002Fmessaging\u002Fvoice-notes","Recording and sending voice notes",{"_path":480,"title":481},"\u002Fhelp\u002Fmessaging\u002Fwhatsapp-calling","WhatsApp Business Calling (voice calls)",{"_path":4,"title":8},1780423186413]