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

הודעה ב-WhatsApp API לא נמסרה: הסיבות, לפי הסדר

הודעת WhatsApp API שהתקבלה אינה הודעה שנמסרה: Meta מדווחת על התוצאה מאוחר יותר, בוובהוק (Webhook) של סטטוס, עם הערכים sent, delivered, read או failed, ובצירוף קוד שגיאה. בודקים לפי הסדר: סטטוס הכישלון וקודו, חלון 24 השעות (131047), אמצעי התשלום (131042), התבנית (132001, 132015), הנמען (131026, 131049, 131050), ואז המגבלות והחיבור של המספר.

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

4 statuses

עדכוני הסטטוס מסמנים את sent בסימון אחד, את delivered בשניים, את read בשניים בכחול, ואת failed במשולש שגיאה אדום.

131047

עברו יותר מ-24 שעות מאז שהנמען כתב לאחרונה, ולכן מומלץ לשלוח תבנית במקום.

131026

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

30 days

משך ברירת המחדל שבו WhatsApp מנסה שוב תבנית שירות או שיווק שלא נמסרה, לפני שהיא נמחקת, ותבניות אימות מוגדרות כברירת מחדל ל-10 דקות.

20 mps

קצב קבוע של מספר שמשמש גם באפליקציית WhatsApp Business וגם ב-Cloud API.

למה הודעה שהתקבלה עדיין לא מגיעה?

משום שתשובת ה-API והמסירה הן שני אירועים נפרדים. כששולחים, המערכת מחזירה מזהה ברגע שהבקשה התקבלה. אם ההודעה מגיעה לטלפון של הלקוח, זה מתברר מאוחר יותר, בוובהוק של סטטוס בשדה messages. הערך sent פירושו שההודעה יצאה משרתי Meta (סימון אחד), delivered שהגיעה למכשיר (שניים), read שנפתחה (שניים בכחול), ואילו failed פירושו שלא ניתן היה לשלוח או למסור אותה. הכישלון מוצג לכם במערך errors עם code, title, וגם בשדה error_data.details. לכן הצעד הראשון הוא לא לנחש: מחפשים את הסטטוס failed של אותו מזהה ובודקים את הקוד שלו. אם לא הוגדר יעד לוובהוק, אף דבר לא נרשם.

אילו הסיבות, לפי הסדר שבו בודקים אותן?

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

  • החלון סגור: 131047, יותר מ-24 שעות מאז שהלקוח כתב לאחרונה. הודעות בטקסט חופשי דורשות חלון פתוח, ולכן שולחים תבנית.
  • תשלום: 131042, או תבניות שנזרקות בשקט. החל מ-1 באוקטובר 2026, גם הודעות שירות נעצרות כשנוצלו 1,000 הודעות בחודש ללא אמצעי תשלום.
  • תבנית: 132001 לא מאושרת או בשפה שגויה, 132000 מספר משתנים שגוי, 132012 פורמט שגוי, 132015 מושהית, 132016 מבוטלת.
  • נמען: 131026 לא ב-WhatsApp, גרסה ישנה או תנאים שלא אושרו; 131050 ביטל את קבלת הודעות השיווק; 131049 נעצר לשמירה על מעורבות בריאה; תבניות שיווק למספרים בארה״ב לא נמסרות.
  • מגבלות: 131048 מוגבל אחרי סימני ספאם, 131056 יותר מדי הודעות לאדם אחד, 130429 קצב שליחה, 20 הודעות בשנייה במספר Coexistence.
  • חשבון: 131031 או 368, חשבון ה-WhatsApp Business מוגבל או מושבת בגין הפרת מדיניות.
  • חיבור: המספר כבר לא מקושר, למשל אחרי 14 ימים בלי לפתוח את אפליקציית WhatsApp Business.

איך מטפלים בקודים שקשורים לנמען?

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

כמה זמן WhatsApp ממשיך לנסות למסור?

זה תלוי בזמן החיים של ההודעה (TTL). כשהטלפון כבוי או מחוץ לטווח קליטה, WhatsApp מנסה למסור שוב במקום להיכשל מיד: כברירת מחדל 30 יום לתבניות שירות ושיווק, ולתבניות אימות 10 דקות. עסק יכול לקצר את הזמן לכל תבנית באמצעות השדה message_send_ttl_seconds, מ-30 שניות עד 12 שעות לתבניות שירות, ומ-30 שניות עד 15 דקות לתבניות אימות. הודעה שלא ניתן למסור בתוך ה-TTL שלה נזרקת. לכן הודעה עם סטטוס sent ובלי סטטוס delivered אחרי כמה שעות ממתינה בדרך כלל בטלפון של הלקוח, ולא אבודה. לקודי אימות ולהתראות רגישות לזמן הגדירו TTL קצר, כדי שמסירה מאוחרת לא תבלבל איש.

מה זה אומר לתשובות ה-AI ולאוטומציות?

קודם קוראים את ההרצה, ואחר כך את הסטטוס. בלשונית Runs, הרצה במצב Skipped לא שלחה כלום ומסבירה למה: "More than 24 hours since the customer's last message", "You answered this chat from your phone recently" או "AI reply limit for this chat reached this hour". הרצה במצב Done אומרת ש-Meta קיבלה כל תשובה, וזה לא הוכחה למסירה. easyCoexistence לא שומר סטטוסים של הודעות: כשהאוטומציות פעילות, הם מגיעים לכתובת ה-URL להעברה שהגדרתם, אם הגדרתם כזו, ובמצב ישיר הם עוברים ישירות לנקודת הקצה שלכם. מ-ChatGPT או Claude, בקשו מה-AI להריץ את get_number_health: הוא מחזיר את הסטטוס החי, דירוג האיכות ו-15 אירועי הניטור האחרונים, כולל בלוק שליחה עם הקוד של Meta.

איך מגדירים

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

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

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

ה-AI שלכם יכול לבדוק מספר מ-ChatGPT או Claude באמצעות get_number_health. US$ 9 עד US$ 0.75 לכל מספר בחודש, יורד ככל שמוסיפים מספרים, כולל תקופת ניסיון של 3 ימים בחינם.

שאלות נפוצות

למה ההודעה הציגה סימון אחד במשך שעות?

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

למה תשובות מגיעות ותבניות לא?

בדרך כלל זו בעיית אמצעי תשלום בחשבון ה-WhatsApp Business. הודעות שירות נמסרות במסגרת המכסה החינמית החודשית של המספר גם בלי אמצעי תשלום, אבל תבניות לא נמסרות. ב-Billing & payments מוסיפים כרטיס.

אפשר לראות הודעות שנכשלו באפליקציית WhatsApp Business?

לא בצורה אמינה. במספר Coexistence, הודעות שנשלחו דרך ה-API מופיעות בשרשור הצ׳אט באפליקציה, אבל הסיבה לכישלון מגיעה רק בקוד השגיאה שבוובהוק הסטטוס.

האם Meta גובה תשלום על הודעות שלא נמסרו?

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

המשיכו לקרוא

למה הודעת WhatsApp נכשלה: קריאת סטטוס failed והשגיאות שלוסטטוס failed אומר ש-Meta לא הצליחה לשלוח או למסור את הודעת WhatsApp. קראו את מערך errors ואת קודי השגיאה הנפוצים, למשל 131047, ומה לעשות.סטטוסי וובהוק (Webhook) של WhatsApp: נשלחה, נמסרה, נקראה ונכשלהאיך WhatsApp מדווחת מה קרה להודעה ששלחתם: מערך statuses, כל ערך סטטוס, כל שדה, והתאמה לשדה wamid ולפורמט האמיתי של Meta.הוסיפו אמצעי תשלום לחשבון WhatsApp Business שלכם, אחרת הודעות השירות ייעצרובלי אמצעי תשלום, Meta מפסיקה לשלוח תבניות, ותשובות השירות אחרי 1,000 בחודש ייפסקו. מה להוסיף, איפה, ואיך לבדוק.תבנית WhatsApp מושהית או מושבתת: מה לעשותתבנית WhatsApp עם דירוג איכות נמוך מושהית 3 שעות, אחר כך 6, ואז מושבתת. איך מזהים, מה לשנות, איך מסירים השהיה ומה לעשות הלאה.מספר WhatsApp Business מוגבל או חסום: איך מבקשים בדיקה מחדשאיפה מופיעה הגבלה או חסימה של WhatsApp מטעם Meta, איך לוחצים על Request Review, מה לתקן לפני הערעור וכמה זמן זה לוקח.קודי שגיאה של WhatsApp Cloud APIכל קודי השגיאה של WhatsApp Cloud API בטבלה אחת: משמעות, ניסיון חוזר והסבר מלא לכל קוד.

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

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

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

נבדק ב-