למה הודעת 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 לשרת שלכם, ישירות או כהעברות חתומות כשהאוטומציות פעילות.
עברו יותר מ-24 שעות מאז שהנמען ענה לאחרונה; הפתרון של Meta הוא לשלוח תבנית במקום.
לא נמסרה כדי לשמור על מעורבות תקינה במערכת; יש להמתין לפחות 24 שעות לפני שליחה מחדש של תבנית השיווק.
הנמען בחר להפסיק לקבל הודעות שיווק מהעסק; Meta מבקשת לא לנסות שוב.
סטטוס failed אינו כולל את מערך contacts, לכן יש לשייך את הכשל דרך statuses.id.
על מה Meta גובה: על הודעות שנמסרו, לא על הודעות שנשלחו.
איך נראה סטטוס failed?
כמו כל סטטוס, ועם מערך errors נוסף. מערך contacts חסר, השדה recipient_user_id לא מופיע כשההודעה נשלחה למספר טלפון, ואין אובייקט pricing. השדות title ו-message מכילים את אותו טקסט, השדה error_data.details מסביר זאת במשפט, והשדה href מפנה לרשימת קודי השגיאה של Meta. זו הדוגמה של Meta עצמה: תבנית שיווק שנעצרה בגלל מגבלת המשתמש לכל משתמש:
{
"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:
איך המטפל צריך להגיב לכל סוג כשל?
מיינו כל קוד לפי מה שצריך לעשות הלאה, לפני שמשהו מנסה שוב. ניסיון חוזר גורף הופך ביטול הרשמה לשיווק לכשלים חוזרים ויכול להאריך חסימה, ואילו התעלמות משגיאה זמנית מאבדת הודעה שהייתה עוברת דקה מאוחר יותר.
- לנסות שוב עם המתנה הולכת וגדלה: 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 קיבלה את ההודעה.
כשתשובה של אוטומציה נדחית בזמן השליחה, ההרצה מציגה את השגיאה של 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 בהודעות קוליות.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-