קודי שגיאה של WhatsApp Cloud API
כאן מרוכזים כל קודי השגיאה של WhatsApp Cloud API שאנו מתעדים, בטבלה אחת, עם משמעות כל קוד והאם ניסיון חוזר יעזור. לרוב לא: אלה שגיאות דטרמיניסטיות, ולכן אותה בקשה נכשלת באותה צורה, ולולאת ניסיונות חוזרים הופכת בקשה שגויה למגבלת קצב.
EasyCoexistence עוקבת ברציפות אחר תקינות החיבור ומתעדת בציר הזמן של החיבור את אירועי החשבון והאיכות מ-Meta, כך ששגיאות שמקורן במצב המספר נראות לפני שכשל שליחה מתרחש, ולא אחריו.
בקשה
| קוד | מה זה אומר | ניסיון חוזר |
|---|---|---|
| 100 | פרמטר לא נתמך, מאוית לא נכון או בפורמט שגוי. | לא |
| 131008 | פרמטר חובה לא נכלל בכלל. | לא |
| 131009 | הפרמטר קיים, אבל עם ערך שנקודת הקצה דוחה. | לא |
| 131021 | השולח והנמען הם אותו מספר. | לא |
| 131051 | סוג ההודעה לא נתמך, לעיתים קרובות בגלל מגבלה של Coexistence. | לא |
| 131052 | Meta לא הצליחה להוריד מדיה שלקוח שלח. | לא |
| 131053 | Meta לא הצליחה להעלות מדיה ששלחתם. גודל, פורמט או נגישות. | לא |
תבנית
| קוד | מה זה אומר | ניסיון חוזר |
|---|---|---|
| 132000 | מספר הפרמטרים לא תואם לתבנית. | לא |
| 132001 | לא קיימת תבנית עם צירוף השם והשפה הזה. | לא |
| 132007 | התבנית מפרה את מדיניות ההודעות. כתבו אותה מחדש והגישו שוב. | לא |
| 132012 | פורמט הפרמטר לא תואם למה שהתבנית מגדירה. | לא |
| 132015 | התבנית הושהתה אחרי ירידה באיכות. זמני. | המתינו |
| 132016 | התבנית הושבתה לצמיתות. היא לא תחזור. | לא |
חלון ונמען
רישום ו-PIN
גישה וחשבון
מגבלות קצב
תקלות זמניות
סנכרון Coexistence
איך לקרוא את עמודת הניסיון החוזר
בעמודה יש שלושה ערכים, ובחירה שגויה ביניהם היא הטעות היקרה ביותר בכל המדריך הזה.
לא אומר שהכשל דטרמיניסטי. הבקשה, התבנית או מצב הנמען הם שנכשלו, ושליחה חוזרת של אותה בקשה בדיוק תחזיר את אותה שגיאה ותצרוך קיבולת שתצטרכו בהמשך. כן אומר שהכשל היה בצד של 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 ימים. בטלו בכל זמן.