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

שגיאה 131060: הודעה מסוג unsupported במספר Coexistence

שגיאה 131060 מגיעה בוובהוק (Webhook) של הודעות כהודעה מסוג unsupported עם הכותרת "This message is currently unavailable." זוהי הודעה ש-Meta מגדירה כצפויה במספר Coexistence: היא מופיעה בעיקר כשאדם כותב לעסק בפעם הראשונה, לרוב מיד אחרי לחיצה על מודעת Click-to-WhatsApp, ובדרך כלל נעלמת תוך שניות. ההודעה עצמה נשארת זמינה לקריאה באפליקציית WhatsApp Business שבטלפון.

easyCoexistence מוציא הודעות לא נתמכות מהאוטומציות שלכם, כך שה-AI לעולם לא עונה להודעה שאינו יכול לקרוא, ועדיין מעביר את ה-payload של Meta למערכת שלכם כשהוגדרה כתובת Forward URL.

131060

הקוד של Meta להודעה נכנסת שאינה זמינה כרגע, עם הכותרת "This message is currently unavailable."

Seconds

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

First contact

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

131051

קוד אחר באותו וובהוק: ה-Cloud API אינו תומך בסוג ההודעה הזה כלל.

Skipped

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

מה כולל וובהוק 131060?

זהו וובהוק הודעות רגיל, שההודעה בו מסומנת "type": "unsupported" ויש בו מערך errors. השגיאה נושאת את הקוד 131060 והכותרת "This message is currently unavailable.", עם אותו משפט כהודעתה. האובייקט unsupported מציין את סוג התוכן ש-Meta לא הצליחה להעביר; רשימת הערכים של Meta כוללת image, interactive, reaction וגם poll_creation. אין גוף טקסט ואין מזהה מדיה, כך שאין ב-payload שום דבר שמגלה מה הלקוח כתב. מספר השולח, מזהה ההודעה והחותמת הזמן קיימים כרגיל.

messages webhook with error 131060 (shape from Meta's reference, values illustrative)
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "<WABA_ID>",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "<BUSINESS_NUMBER>",
          "phone_number_id": "<PHONE_NUMBER_ID>"
        },
        "contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
        "messages": [{
          "from": "5511999998888",
          "id": "wamid.HBgN...",
          "timestamp": "1762876800",
          "type": "unsupported",
          "errors": [{
            "code": 131060,
            "title": "This message is currently unavailable.",
            "message": "This message is currently unavailable."
          }],
          "unsupported": { "type": "<UNSUPPORTED_TYPE>" }
        }]
      }
    }]
  }]
}

למה זה קורה במספר Coexistence?

מדריך Coexistence של Meta קובע ששותפים "עשויים לקבל וובהוק של הודעות unsupported עם קוד שגיאה 131060", ומציין שזה צפוי. הוא מציין שני תרחישים.

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

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

מה העסק אמור לעשות כשזה מגיע?

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

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

איך התוכנה וה-AI צריכים לטפל בזה?

להתייחס לזה כאירוע ידוע, לא ככשל. לאשר את הוובהוק עם סטטוס 200 כמו לכל מסירה, כדי ש-Meta לא תשלח אותו שוב. לתעד את מזהה ההודעה ואת השולח, כדי לקשר אותו לשיחה שבאה אחריו. לעולם אל תעבירו את ההודעה הריקה ל-AI כאילו היה בה טקסט: בלי תוכן, כל תשובה היא ניחוש. ולהתריע על קצב אירועי 131060, לא על אירועים בודדים.

  • מחזירים 200 במהירות ומסננים כפילויות לפי מזהה ההודעה, כמו בכל וובהוק.
  • כשהסוג הוא unsupported, מדלגים על תשובות AI ועל זיהוי מילות מפתח.
  • מציגים לצוות שהודעה ממתינה באפליקציה בטלפון.
  • סופרים את 131060 בנפרד משגיאות אמיתיות בלוחות הבקרה.

האם אוטומציות רצות על הודעה לא נתמכת?

ב-easyCoexistence, לא. אוטומציות קוראות טקסט, תשובות כפתור ורשימה, כיתובי מדיה ותגיות מקום כמו "[voice message]"; להודעה מסוג unsupported אין אף אחד מאלה, ולכן אף אוטומציה לא עונה לה ואין ריצה שמופיעה. אם הוגדרה כתובת Forward URL, המערכת שלכם עדיין מקבלת את ה-payload המקורי של Meta, כולל השגיאה. במצב ישיר, Meta שולחת אותו ישירות לשרת שלכם.

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

מה ההבדל בין 131060 לבין 131051?

שניהם מגיעים עם type unsupported באותו וובהוק הודעות, וזו הסיבה שמבלבלים ביניהם ביומנים. הם מציינים דברים הפוכים לתכנון: האחד הוא פער קצר שמתיישב מעצמו, והשני הוא מגבלה קבועה של ה-API לאותו תוכן. קראו את errors[0].code, לא את הסוג, כדי להבדיל ביניהם בטיפול שלכם. הטבלה מסכמת את מה שמקורות ההפניה של Meta אומרים על כל קוד.

131060131051
TitleThis message is currently unavailable.Message type unknown
MeaningThe message cannot be passed on right nowThe Cloud API does not support that type
Typical causeFirst contact on a Coexistence number, often after an ad tapContent the API never delivers
How longUsually clears within secondsPermanent for that content
What to doRead it in the WhatsApp Business appAsk the customer for text, or read it in the app

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

  • התראה על אירועי 131060 בודדים. Meta מכנה אותם צפויים במספרי Coexistence; במקום זאת עקבו אחרי הקצב.
  • לתת ל-AI לענות להודעה הריקה. ה-payload אינו מכיל טקסט, לכן התשובה תהיה מומצאת.
  • להשיב לוובהוק בשגיאת סטטוס. Meta שולחת שוב וובהוקים שנכשלו, ולכן הודעה לא נתמכת אחת הופכת לכמה מסירות.
  • להניח שההודעה אבדה. היא נמצאת באפליקציית WhatsApp Business; רק עותק ה-API לא היה זמין.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

אפשר למשוך את התוכן המקורי דרך ה-API?

ההנחיה של Meta לקוד 131060 היא לבדוק באפליקציית WhatsApp Business. מסמך העזר של Meta לוובהוקים אינו מתאר דרך לאחזר את התוכן מאוחר יותר.

האם 131060 אומר שהמספר תקול?

לא. אם הודעות מאנשי קשר רגילים ממשיכות להגיע עם קוד 131060 במשך שעות, בקשו מה-AI להריץ את get_number_health או לבדוק את החיבור, אבל פרצים בתחילת שיחה הם צפויים.

האם זה קורה גם במספרים שמשתמשים רק ב-Cloud API?

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

האם מחויבים על זה?

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

המשיכו לקרוא

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

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

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

נבדק ב-