Meta Tech Provider

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

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

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

Request

Code	What it means	Retry
100	A parameter is unsupported, misspelled or malformed.	No
131008	A required parameter was not included at all.	No
131009	A parameter is present with a value the endpoint rejects.	No
131021	Sender and recipient are the same number.	No
131051	The message type is not supported, often a Coexistence limit.	No
131052	Meta could not download media a customer sent.	No
131053	Meta could not upload media you sent. Size, format or reach.	No

Template

Code	What it means	Retry
132000	The number of parameters does not match the template.	No
132001	No template exists with that name and language pair.	No
132007	The template breaks messaging policy. Rewrite and resubmit.	No
132012	Parameter format does not match what the template defines.	No
132015	The template is paused after a quality decline. Temporary.	Wait
132016	The template is permanently disabled. It will not come back.	No

Window and recipient

Code	What it means	Retry
131047	The 24-hour service window is closed. Send a template.	No
131026	The recipient cannot receive the message at all.	No
131050	The person opted out. There is no workaround, by design.	No
130497	Messaging that country is restricted for your account.	No

Registration and PIN

Code	What it means	Retry
131045	The number was never registered for Cloud API messaging.	No
133010	The number is not registered. Registration must be completed.	No
133006	The number must be verified before it can be registered.	No
133005	The two-step verification PIN was wrong. Stop guessing.	No
133008	Too many PIN attempts. Registration is locked for a period.	Wait

Access and account

Code	What it means	Retry
190	The access token expired or was invalidated.	No
368	The account is restricted after a policy violation.	No
131031	The account is restricted, or its data does not match Meta's.	No
131042	A payment problem on the business account blocks sending.	No
131049	Meta blocked the message to protect ecosystem health.	No

Rate limits

Code	What it means	Retry
130429	The account's messaging throughput limit was reached.	Wait
131048	A spam rate limit was hit. Quality, not volume, is the cause.	No
131056	Too many messages between your number and one recipient.	No
80007	The account hit its management call limit. Usually polling.	Wait

Transient

Code	What it means	Retry
131016	A Meta service is temporarily unavailable.	Yes
131000	Unclassified failure. Retry once, then escalate with the trace id.	Yes

Coexistence sync

Code	What it means	Retry
2593107	The chat history synchronisation limit was exceeded.	No
2593108	A sync was attempted outside the 24-hour sync window.	No

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

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

לא אומר שהכשל דטרמיניסטי. הבקשה, התבנית או מצב הנמען הם שנכשלו, ושליחה חוזרת של אותה בקשה בדיוק תחזיר את אותה שגיאה ותצרוך קיבולת שתצטרכו בהמשך. כן אומר שהכשל היה בצד של 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 בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.

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

המשיכו לקרוא

ReferenceWhatsApp error 131047: re-engagement messageError 131047 means more than 24 hours have passed since that customer last messaged you, so the customer service window is closed and free text will not deliver.ReferenceWhatsApp error 100: invalid parameterError 100 means the request carried a parameter Meta does not accept: unsupported, misspelled, or the wrong shape for that endpoint.ReferenceWhatsApp error 131016: service unavailableError 131016 means a service on Meta's side is temporarily unavailable.ReferenceA number stopped working: how to find out whyWhen a connected number stops working, the cause is almost never the code.ReferenceWhatsApp webhook fields, and which ones go whereA WhatsApp Business Account delivers events as named fields.GuideWhatsApp Coexistence: the app and the API on one numberCoexistence is Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time.