התחברותהתחילו תקופת ניסיון
Meta Tech Provider

למה הודעת WhatsApp נכשלה: קריאת סטטוס failed והשגיאות שלו

וובהוק (Webhook) של סטטוס failed משמעו ש-Meta לא הצליחה לשלוח או למסור הודעה שהעסק שלח דרך ה-API. השדה messages מחזיר סטטוס failed ומערך errors שמכיל code, title, message, error_data.details ו-href. הקוד מסביר את הסיבה: 131047 חלון 24 השעות נסגר, 131026 לא ניתן למסירה, 131049 הגבלת שיווק, 131050 שיווק הופסק, 131042 בעיית תשלום.

easyCoexistence מחברת את מספר אפליקציית WhatsApp Business שלכם ל-Cloud API של Meta דרך Coexistence, ומעבירה סטטוסי failed לשרת שלכם, ישירות או כהעברות חתומות כשהאוטומציות פעילות.

131047

עברו יותר מ-24 שעות מאז שהנמען ענה לאחרונה; הפתרון של Meta הוא לשלוח תבנית במקום.

131049

לא נמסרה כדי לשמור על מעורבות תקינה במערכת; יש להמתין לפחות 24 שעות לפני שליחה מחדש של תבנית השיווק.

131050

הנמען בחר להפסיק לקבל הודעות שיווק מהעסק; Meta מבקשת לא לנסות שוב.

No contacts

סטטוס failed אינו כולל את מערך contacts, לכן יש לשייך את הכשל דרך statuses.id.

Delivered

על מה Meta גובה: על הודעות שנמסרו, לא על הודעות שנשלחו.

איך נראה סטטוס failed?

כמו כל סטטוס, ועם מערך errors נוסף. מערך contacts חסר, השדה recipient_user_id לא מופיע כשההודעה נשלחה למספר טלפון, ואין אובייקט pricing. השדות title ו-message מכילים את אותו טקסט, השדה error_data.details מסביר זאת במשפט, והשדה href מפנה לרשימת קודי השגיאה של Meta. זו הדוגמה של Meta עצמה: תבנית שיווק שנעצרה בגלל מגבלת המשתמש לכל משתמש:

Meta's example: a message that failed with 131049
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "statuses": [
              {
                "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
                "status": "failed",
                "timestamp": "1751142888",
                "recipient_id": "16505551234",
                "errors": [
                  {
                    "code": 131049,
                    "title": "This message was not delivered to maintain healthy ecosystem engagement.",
                    "message": "This message was not delivered to maintain healthy ecosystem engagement.",
                    "error_data": {
                      "details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
                    },
                    "href": "/documentation/business-messaging/whatsapp/support/error-codes"
                  }
                ]
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

אילו קודי שגיאה חוזרים הכי הרבה, ומה הם אומרים?

Meta מחזירה שגיאות בתגובה לשליחה, בסטטוס failed, או בשניהם, כך שאותו קוד יכול להגיע בכל אחת מהדרכים, והמטפל שלכם צריך לקרוא את שני המקומות. אלה הקודים שמסבירים את רוב ההודעות שלא מגיעות, עם הסיבה של Meta והדבר הראשון לנסות. הרשימה המלאה נמצאת במדריך קודי השגיאה של Meta:

131026Undeliverable: not a WhatsApp number, terms not accepted, or an outdated WhatsApp version on the recipient's phone.
131047More than 24 hours since the customer last wrote. Send an approved template instead.
131049Held back to keep engagement healthy, usually the per-user marketing limit. Wait 24 hours or more.
131050The customer stopped marketing messages from you. Do not retry.
131042A problem with the payment method on the WhatsApp Business Account.
130472Not sent because the recipient is part of Meta's marketing message experiment.
131053Media could not be uploaded, often an unsupported file type.
131000Unknown error. Try again; if it persists, open a Direct Support ticket.

איך המטפל צריך להגיב לכל סוג כשל?

מיינו כל קוד לפי מה שצריך לעשות הלאה, לפני שמשהו מנסה שוב. ניסיון חוזר גורף הופך ביטול הרשמה לשיווק לכשלים חוזרים ויכול להאריך חסימה, ואילו התעלמות משגיאה זמנית מאבדת הודעה שהייתה עוברת דקה מאוחר יותר.

  • לנסות שוב עם המתנה הולכת וגדלה: 131000 לא ידוע, 131016 השירות אינו זמין, 130429 הגיע למגבלת התפוקה.
  • להמתין קודם: 131049, לפחות 24 שעות, כי ניסיונות מוקדמים עלולים לחסום את אותו משתמש עד 24 שעות נוספות.
  • להחליף את ההודעה: 131047 דורש תבנית מאושרת, כי חלון 24 השעות סגור.
  • להפסיק עבור הלקוח הזה: 131050, עד שיגיע user_preferences עם resume.
  • לתקן את החשבון או את התוכן: 131042 תשלום, 131031 חשבון מוגבל, 131053 מדיה.

אילו כשלים מופיעים רק כסטטוס failed?

אלה ש-Meta מחליטה עליהם אחרי שקיבלה את הבקשה. השליחה מחזירה wamid, והסירוב מגיע מאוחר יותר בוובהוק הזה. Meta לא מוסרת תבניות שיווק למשתמשי WhatsApp עם מספרי טלפון מארצות הברית (+1 עם קידומת אזור אמריקאית), תבנית שיווק ללקוח שהפסיק לקבל הודעות שיווק נבדקת ואז מדווחת כ-failed עם 131050, והמגבלה לכל משתמש מדווחת על 131049 באותו אופן.

אם למספר אין יעד וובהוק, הכשלים האלה לא מגיעים לשום מקום שתוכלו לראות, וההודעה פשוט נראית כאילו נשלחה. לסדר המלא של הבדיקות כשלקוח לא קיבל כלום, ראו את העמוד על הודעות WhatsApp API שלא נמסרו.

מה משתנה במספר Coexistence?

שני דברים חשובים. ראשית, חלון 24 השעות חל רק על ה-API. ההנחיות של Meta ל-Coexistence קובעות שהודעות שנשלחות מאפליקציית WhatsApp Business אינן כפופות לחלון שירות הלקוחות, כך שאחרי 131047 הבעלים עדיין יכול לענות לאותו לקוח מהטלפון, בזמן שהמערכת שלכם שולחת תבנית מאושרת.

שנית, התפוקה קבועה. מספר שמשמש באפליקציה וב-API בבת אחת שולח עד 20 הודעות בשנייה, וחריגה מכך מחזירה 130429. כל השאר זהה למספר Cloud API רגיל: אותו שדה, אותו מערך errors ואותם קודים.

איך האוטומציות וה-AI שלכם רואים כשל?

זה תלוי מתי Meta אומרת לא. סירוב בזמן השליחה, כמו 131047, מכשיל את שלב האוטומציה: ההרצה מציגה Failed עם ההודעה של Meta בלשונית Runs, ובעל העסק מקבל אימייל כדי שיוכל לענות לאותו לקוח בעצמו. אוטומציות בודקות גם את החלון לפני שליחת תשובה חופשית, ומדלגות עם window_closed במקום לנסות.

כשל ש-Meta מדווחת עליו לאחר מכן מגיע כסטטוס failed אל ה-Forward URL או אל היעד הישיר שלכם, וההרצה נשארת כפי שהייתה. בינה מלאכותית ששלחה תבנית דרך מחבר ה-MCP רואה את ה-wamid ואת "sent: true"; בקשו ממערכת שלכם את הסטטוס של ה-wamid, או בקשו מהעוזר להריץ את get_number_health כשהרבה הודעות נכשלות בבת אחת.

טעויות נפוצות

  • לנסות שוב ושוב את 131050 בלולאה. הלקוח הפסיק לקבל הודעות שיווק, ולכן כל ניסיון נכשל באותו אופן עד שיחזור לקבל הודעות.
  • שליחה מחדש של תבנית שיווק עם 131049 תוך שעות. Meta מבקשת לפחות 24 שעות, וניסיונות מוקדמים עלולים לחסום את אותו משתמש עד 24 שעות נוספות.
  • לרשום רק את השדה title. השדה error_data.details נושא את הסיבה המדויקת, לכן שמרו את הקוד והפירוט יחד עם ה-wamid.
  • לפעול בלי יעד וובהוק ולשפוט את המסירה לפי תגובת השליחה, שרק אומרת ש-Meta קיבלה את ההודעה.
עושים את זה עם EasyCoexistence

כשתשובה של אוטומציה נדחית בזמן השליחה, ההרצה מציגה את השגיאה של Meta ואתם מקבלים אימייל, וכל מספר נבדק 24/7 לניתוקים וירידות באיכות. מחיר: מ-US$ 9 ועד US$ 0.75 למספר לחודש, יורד ככל שמוסיפים מספרים, עם 3 ימים ראשונים בחינם.

שאלות נפוצות

האם Meta גובה על הודעה שנכשלה?

בדפי התמחור של Meta כתוב שהיא גובה על הודעות שנמסרו, לא על הודעות שרק נשלחו. לסטטוס failed אין אובייקט pricing. החיובים הולכים לחשבון WhatsApp Business של העסק עצמו, ו-easyCoexistence לא מוסיפה עליהם תוספת.

האם 131026 אומר שהלקוח חסם את העסק?

הרשימה של Meta ל-131026 מציינת סיבות אחרות: המספר אינו ב-WhatsApp, הנמען לא אישר את התנאים האחרונים, או שגרסת WhatsApp שלו ישנה מדי. Meta ממליצה לשאול את הלקוח בערוץ אחר כדי לבדוק אותן.

למה השדה recipient_user_id מופיע בכשלים מסוימים ולא באחרים?

Meta משמיטה אותו בסטטוס failed כשההודעה נשלחה למספר טלפון. כשנשלחה אל ה-BSUID של הלקוח, הכשל כולל אותו, וייתכן שהשדה recipient_id הוא זה שחסר.

האם הודעה יכולה להיכשל אחרי שנמסרה?

התיעוד של Meta מגדיר את failed ככשל בשליחה או במסירה. לאחר שההודעה הגיעה למכשיר, הסטטוסים הבאים הצפויים הם read, או played בהודעות קוליות.

המשיכו לקרוא

סטטוסי וובהוק (Webhook) של WhatsApp: נשלחה, נמסרה, נקראה ונכשלהאיך WhatsApp מדווחת מה קרה להודעה ששלחתם: מערך statuses, כל ערך סטטוס, כל שדה, והתאמה לשדה wamid ולפורמט האמיתי של Meta.וובהוק (Webhook) user_preferences ב-WhatsApp: כשלקוח עוצר או מחדש הודעות שיווקיותוובהוק user_preferences של WhatsApp נשלח כשלקוח עוצר או מחדש הודעות שיווקיות. ה-payload, מה לעשות איתו, והכשל 131050 כגיבוי.הודעה ב-WhatsApp API לא נמסרה: הסיבות, לפי הסדרהודעה ב-WhatsApp API שלא מגיעה: עדכון הסטטוס, חלון 24 השעות, תשלום, תבניות, הנמען והמגבלות, לפי הסדר שמוצא את הבעיה.תבנית WhatsApp מושהית או מושבתת: מה לעשותתבנית WhatsApp עם דירוג איכות נמוך מושהית 3 שעות, אחר כך 6, ואז מושבתת. איך מזהים, מה לשנות, איך מסירים השהיה ומה לעשות הלאה.שגיאת WhatsApp 131049: הודעה נחסמה לשמירה על תקינות המערכת האקולוגיתשגיאה 131049 פירושה ש-Meta חסמה את השליחה לשמירה על תקינות המערכת, לא בגלל שחלפו 24 שעות. למה תבנית לא פותרת זאת.חלון שירות הלקוחות בן 24 השעותמהו חלון שירות הלקוחות, מתי הוא נפתח ונסגר, מה מותר לשלוח בתוכו ומחוצה לו, ולמה תשובות בתוכו בחינם.

מוכנים להתחיל?

מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.

התחילו תקופת ניסיון בחינם

נבדק ב-