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

קודי שגיאה של WhatsApp Cloud API

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

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

בלי שמירת הודעות כברירת מחדלאפליקציה עסקית + Cloud APIMCP ל-Claude ול-ChatGPTמתחברים תוך 2 דקות

בקשה

קודמה זה אומרניסיון חוזר
100פרמטר לא נתמך, מאוית לא נכון או בפורמט שגוי.לא
131008פרמטר חובה לא נכלל בכלל.לא
131009הפרמטר קיים, אבל עם ערך שנקודת הקצה דוחה.לא
131021השולח והנמען הם אותו מספר.לא
131051סוג ההודעה לא נתמך, לעיתים קרובות בגלל מגבלה של Coexistence.לא
131052Meta לא הצליחה להוריד מדיה שלקוח שלח.לא
131053Meta לא הצליחה להעלות מדיה ששלחתם. גודל, פורמט או נגישות.לא

תבנית

קודמה זה אומרניסיון חוזר
132000מספר הפרמטרים לא תואם לתבנית.לא
132001לא קיימת תבנית עם צירוף השם והשפה הזה.לא
132007התבנית מפרה את מדיניות ההודעות. כתבו אותה מחדש והגישו שוב.לא
132012פורמט הפרמטר לא תואם למה שהתבנית מגדירה.לא
132015התבנית הושהתה אחרי ירידה באיכות. זמני.המתינו
132016התבנית הושבתה לצמיתות. היא לא תחזור.לא

חלון ונמען

קודמה זה אומרניסיון חוזר
131047חלון השירות של 24 השעות נסגר. שלחו תבנית.לא
131026הנמען לא יכול לקבל את ההודעה בכלל.לא
131050האדם ביקש לא לקבל הודעות. אין דרך לעקוף את זה, וזה מכוון.לא
130497שליחת הודעות למדינה הזו מוגבלת בחשבון שלכם.לא

רישום ו-PIN

קודמה זה אומרניסיון חוזר
131045המספר מעולם לא נרשם לשליחת הודעות דרך Cloud API.לא
133010המספר לא רשום. צריך להשלים את הרישום.לא
133006צריך לאמת את המספר לפני שאפשר לרשום אותו.לא
133005קוד ה-PIN של האימות הדו-שלבי שגוי. הפסיקו לנחש.לא
133008יותר מדי ניסיונות PIN. הרישום נעול לפרק זמן מסוים.המתינו

גישה וחשבון

קודמה זה אומרניסיון חוזר
190אסימון הגישה פג תוקף או בוטל.לא
368החשבון הוגבל בעקבות הפרת מדיניות.לא
131031החשבון מוגבל, או שהנתונים שלו לא תואמים לנתונים של Meta.לא
131042בעיית תשלום בחשבון העסקי חוסמת את השליחה.לא
131049ההודעה נחסמה על ידי Meta כדי לשמור על בריאות המערכת.לא

מגבלות קצב

קודמה זה אומרניסיון חוזר
130429החשבון הגיע למגבלת קצב השליחה של הודעות.המתינו
131048הופעלה מגבלת קצב נגד ספאם. הסיבה היא איכות, לא כמות.לא
131056יותר מדי הודעות בין המספר שלכם לנמען אחד.לא
80007החשבון הגיע למגבלת קריאות הניהול. בדרך כלל בגלל תשאול תכוף (polling).המתינו

תקלות זמניות

קודמה זה אומרניסיון חוזר
131016אחד השירותים של Meta אינו זמין באופן זמני.כן
131000כשל לא מסווג. נסו שוב פעם אחת, ואז העבירו לטיפול עם ה-trace id.כן

סנכרון Coexistence

קודמה זה אומרניסיון חוזר
2593107חריגה ממגבלת הסנכרון של היסטוריית הצ'אטים.לא
2593108בוצע ניסיון סנכרון מחוץ לחלון הסנכרון של 24 שעות.לא

איך לקרוא את עמודת הניסיון החוזר

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

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

למה לרוב אי אפשר לנסות שוב

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

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

מה לתעד כשאחת מהשגיאות האלה מתקבלת

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

  • תגובת השגיאה המלאה, כולל trace id, שאותו צוות התמיכה של Meta מבקש.
  • גוף הבקשה כפי שנשלח, לא כפי שהתכוונתם לשלוח. הפער בין השניים הוא בדרך כלל הבאג.
  • ה-phone number id, כדי להבדיל בין בעיה במספר אחד לבין בעיה בכל החשבון.
  • חותמת הזמן, כדי לבדוק את הכשל מול מצב החיבור באותו רגע.

הקודים שקיימים רק ב-Coexistence

שניים מהם, והם מבלבלים כי הם נראים כמו כשלי שליחה רגילים. 2593107 ו-2593108 קשורים לסנכרון היסטוריית הצ'אט, השלב שמעתיק שיחות אחרונות מהאפליקציה WhatsApp Business כשמחברים מספר בפעם הראשונה.

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

שאלות נפוצות

אילו שגיאות כדאי לנסות שוב?

131016 ו-131000, עם השהיה מעריכית. 130429, 132015 ו-133008 נעלמים מעצמם אם מחכים. כל השאר דטרמיניסטיים.

האם קוד שגיאה אומר שהמספר שלי מנותק?

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

מהו trace id?

מזהה בתגובת השגיאה שמאפשר לתמיכה של Meta למצוא את הבקשה הספציפית. תעדו אותו בכל כשל; בלעדיו אי אפשר לטפל בפנייה.

האם הקודים האלה זהים אצל כל הספקים?

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

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

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

התחילו תקופת ניסיון בחינםלא תחויבו במשך 3 ימים. בטלו בכל זמן.

המשיכו לקרוא