הבנה וטיפול בשגיאות שליחת הודעות בוואטסאפ
מדריך מקיף עם טבלה מפורטת של שגיאות נפוצות בשליחת הודעות וואטסאפ, הסברים בעברית ופתרונות מומלצים לכל שגיאה.
הבנה וטיפול בשגיאות שליחת הודעות בוואטסאפ
מבוא
בעבודה עם WhatsApp Business API, תיתקלו מעת לעת בשגיאות שונות בעת שליחת הודעות. הבנת השגיאות הללו ודרכי הטיפול בהן היא קריטית לשמירה על תקשורת תקינה עם הלקוחות.
מדריך זה מרכז את השגיאות הנפוצות ביותר בטבלה מקיפה, מסביר את הסיבות להן, ומציע פתרונות מעשיים.
שגיאות נפוצות - טבלה מלאה
להלן טבלה מקיפה של כל השגיאות הנפוצות ביותר ב-WhatsApp Business API, עם קודי שגיאה, הסברים מפורטים, ופתרונות מעשיים:
תגיות
| קוד שגיאה | קטגוריה | שם השגיאה | תיאור הבעיה | פתרון מומלץ |
|---|---|---|---|---|
130472 | מערכת | המשתמש חלק מניסוי User is part of experiment | המשתמש נמצא כחלק מניסוי או בדיקה של WhatsApp ולכן לא ניתן לשלוח לו הודעות מסוימות או להשתמש בפיצ'רים מסוימים. WhatsApp מבצע ניסויים על משתמשים נבחרים כדי לבדוק פיצ'רים חדשים. זה לא שגיאה מצדכם ולא ניתן לעקוף את זה. | זוהי מגבלה זמנית מצד WhatsApp. נסו לשלוח את ההודעה למשתמש אחר כהז זמן או המתינו עד שהניסוי יסתיים. |
131000 | מערכת | משהו השתבש Something went wrong | ההודעה נכשלה בשליחה עקב שגיאה לא ידועה. עבור WhatsApp Flows עם Endpoint - כאשר מגדירים מפתח ציבורי עסקי, החישוב של החתימה נכשל, הקריאה ל-GraphQL endpoint נכשלה, או ה-GraphQL endpoint החזיר שגיאה. זוהי שגיאה כללית שדורשת בדיקה מעמיקה יותר. | נסו שוב. אם השגיאה נמשכת, פתחו קריאת תמיכה ישירה (Direct Support ticket). |
131005 | אימות | גישה נדחתה Access denied | ההרשאה לא הוענקה או הוסרה. השתמשו ב-access token debugger כדי לוודא שהאפליקציה שלכם קיבלה את ההרשאות הנדרשות על ידי ה-endpoint. שימוש ב-access token debugger יכול לעזור לזהות בדיוק אילו הרשאות חסרות. | בדקו את ההרשאות של האפליקציה ב-Meta Business Manager. ודאו שכל ההרשאות הנדרשות ניתנו ופעילות. |
131008 | הודעות | פרמטר נדרש חסר Required parameter is missing | הבקשה חסרה פרמטר נדרש. עיינו בתיעוד של ה-endpoint כדי לקבוע אילו פרמטרים נדרשים. בדיקת התיעוד הרשמי תעזור לזהות בדיוק איזה פרמטר חסר. | בדקו את התיעוד של ה-API ווודאו שכל הפרמטרים הנדרשים נכללים בבקשה. |
131009 | הודעות | ערך הפרמטר אינו תקף Parameter value is not valid | ערך אחד או יותר מהפרמטרים אינו תקף. עיינו בתיעוד של ה-endpoint כדי לקבוע אילו ערכים נתמכים לכל פרמטר. שימו לב במיוחד לפורמט מספרי טלפון ולערכים של enum. | ודאו שכל הערכים שאתם שולחים תואמים לפורמט ולערכים המותרים בתיעוד ה-API. |
131016 | מערכת | שירות לא זמין Service unavailable | שירות זמני לא זמין. בדקו את עמוד הסטטוס של WhatsApp Business Platform כדי לראות מידע על מצב ה-API לפני שתנסו שוב. זוהי בדרך כלל בעיה זמנית בצד השרתים של WhatsApp. | המתינו מספר דקות ובדקו את עמוד הסטטוס של Meta לפני שתנסו שוב. |
131021 | אימות | מספר הטלפון של הנמען אינו תקף Recipient phone number not valid | מספר הטלפון שהזנתם אינו בפורמט הנכון או שאינו מספר וואטסאפ פעיל. פורמט נכון: 972501234567 (ללא אפס מוביל אחרי הקידומת). | ודאו שהמספר כולל קידומת בינלאומית (לדוגמה: 972501234567) וללא סימנים מיוחדים כמו +, -, או רווחים. |
131026 | הודעות | ההודעה לא נשלחה Message undeliverable | ההודעה לא הצליחה להגיע ליעד. הסיבות יכולות להיות: מספר לא תקין, המשתמש חסם את העסק, או בעיית רשת. אם המשתמש חסם אתכם, לא תוכלו לשלוח לו הודעות עד שיסיר את החסימה. | ודאו שמספר הטלפון תקין וכולל קידומת בינלאומית (+972). בדקו שהמשתמש לא חסם את החשבון העסקי שלכם. |
131031 | מערכת | השירות לא זמין זמנית Service temporarily unavailable | שירות WhatsApp נתקל בבעיה זמנית. זוהי בדרך כלל בעיה בצד השרתים של Meta. זוהי שגיאה זמנית ובדרך כלל נפתרת מעצמה תוך זמן קצר. | נסו שוב תוך מספר דקות. אם הבעיה נמשכת, בדקו את עמוד הסטטוס של Meta למידע נוסף. |
131037 | אימות | נדרש אישור שם תצוגה Display name approval needed | מספר הטלפון העסקי שבו נעשה שימוש לשליחת הבקשה אין לו שם תצוגה מאושר. תהליך אישור שם תצוגה יכול לקחת מספר ימי עסקים. | שנו את שם התצוגה של מספר הטלפון העסקי. ראו את המדריך 'How to change your WhatsApp Business display name' במרכז העזרה. |
131042 | אימות | בעיית זכאות עסקית/תשלום Business eligibility payment issue | הייתה שגיאה הקשורה לשיטת התשלום שלכם. בעיות נפוצות: חשבון תשלום לא מחובר ל-WhatsApp Business Account, מסגרת האשראי חורגת מהמגבלה, מסגרת אשראי לא מוגדרת או לא פעילה, חשבון עסקי נמחק/מושעה, אזור זמן/מטבע לא מוגדרים. בעיות חיוב יכולות למנוע שליחת הודעות עד לפתרון הבעיה. | ודאו שהגדרתם חיוב נכון ב-'About Billing For Your WhatsApp Business Account'. בדקו שחשבון התשלום מחובר ופעיל. |
131045 | אימות | תעודה שגויה Incorrect certificate | ההודעה נכשלה בשליחה עקב שגיאת רישום מספר טלפון. ודאו שתהליך הרישום הושלם בהצלחה לפני שליחת הודעות. | רשמו את מספר הטלפון לפני שתנסו שוב. |
131047 | הגבלת קצב | נשלחו יותר מדי הודעות Too many messages sent | חרגתם מהמכסה היומית או השעתית של שליחת הודעות. WhatsApp מגביל את מספר ההודעות שניתן לשלוח בתקופה מסוימת. מגבלה זו נועדה למנוע ספאם ולשמור על איכות השירות. | המתינו מספר שעות לפני שליחת הודעות נוספות. בדקו את מגבלות החשבון שלכם ושקלו שדרוג חבילת ההודעות. |
131048 | תבניות | התבנית מושהית Template paused | התבנית הושהתה על ידי Meta בגלל איכות נמוכה או תלונות משתמשים. תבניות מושהות כאשר אחוז גבוה של משתמשים חוסמים את העסק או מדווחים על הודעות. | בדקו בחשבון Meta Business Manager את הסיבה להשהיה. שפרו את התבנית ושלחו אותה לאישור מחדש. |
131049 | הגבלת קצב | Meta בחרה לא למסור Meta chose not to deliver | הודעה זו לא נמסרה כדי לשמור על מעורבות בריאה של האקוסיסטם. אם אתם מקבלים קוד שגיאה זה וחושדים שזה בגלל המגבלה, המתינו לפחות 24 שעות לפני שתשלחו מחדש את הודעת התבנית. זוהי מגבלה שנועדה למנוע ספאם ולשמור על חוויית המשתמש. | המתינו לפחות 24 שעות לפני שתנסו לשלוח שוב. ראו 'Per-User Marketing Template Message Limits' למידע נוסף. |
131050 | הודעות | המשתמש הפסיק לקבל הודעות שיווקיות User stopped marketing messages | לא ניתן למסור את ההודעה. נמען זה בחר להפסיק לקבל הודעות שיווקיות בוואטסאפ מהעסק שלכם. כבדו את בחירת המשתמש ואל תנסו לעקוף זאת. | אל תנסו לשלוח הודעות למשתמש זה כיוון שהן לא יתקבלו. כדי לקבל התראה כאשר משתמש מפסיק או ממשיך משלוח הודעות תבנית שיווקיות מהעסק שלכם, הירשמו ל-user_preferences webhook. |
131051 | הודעות | סוג הודעה לא נתמך Unsupported message type | ניסיתם לשלוח סוג הודעה שאינו נתמך על ידי WhatsApp Business API. סוגי הודעות כמו סטיקרים או GIFs עשויים לא להיות נתמכים ב-API. | השתמשו רק בסוגי הודעות נתמכים: טקסט, תמונה, וידאו, אודיו, מסמך, מיקום, אנשי קשר. |
131052 | מדיה | שגיאת הורדת מדיה Media download error | לא ניתן להוריד את המדיה שנשלחה על ידי המשתמש. לא הצלחנו להוריד מדיה שנכללה בהודעת המשתמש. למידע נוסף, עיינו ב-error.error_data.details בכל webhooks שהופעלו כאשר הודעה זו התקבלה. זה יכול לקרות בגלל בעיות רשת או קובץ פגום. | בקשו מהמשתמש לשלוח לכם את קובץ המדיה בשיטה שאינה וואטסאפ. |
131053 | מדיה | שגיאת העלאת מדיה Media upload error | לא ניתן להעלות את המדיה שבשימוש בהודעה. לא הצלחנו להעלות את המדיה מסיבה אחת או יותר, כגון סוג מדיה לא נתמך. למידע נוסף, עיינו ב-error.error_data.details. ודאו שסוג הקובץ וגודלו תואמים למגבלות WhatsApp. | בדקו שקבצי המדיה שגורמים לשגיאות הם אכן נתמכים. השתמשו בפקודה 'file -I' ב-UNIX לבדיקת סוג ה-MIME. ראו 'Supported Media Types'. |
131057 | מערכת | חשבון במצב תחזוקה Account in maintenance mode | חשבון עסקי נמצא במצב תחזוקה. סיבה אפשרית אחת לכך יכולה להיות שהחשבון עובר שדרוג תפוקה. זוהי פעולה זמנית שמבוצעת על ידי WhatsApp ואינכם יכולים לשלוט בה. | המתינו עד שתחזוקה תסתיים. בדרך כלל זה אורך זמן קצר. |
132000 | תבניות | אי התאמה במספר פרמטרים Template param count mismatch | מספר ערכי הפרמטרים המשתנים שנכללו בבקשה לא תאם למספר הפרמטרים המשתנים שהוגדרו בתבנית. ספרו בדיוק כמה {{}} יש בתבנית ושלחו את אותו מספר פרמטרים. | ראו את מסמך ה-Templates כדי ללמוד על פרמטרים וודאו שהבקשה כוללת ערכים לכל הפרמטרים הנדרשים על ידי התבנית. |
132001 | תבניות | התבנית לא קיימת Template does not exist | התבנית לא קיימת בשפה שצוינה או שהתבנית לא אושרה. שם התבנית הוא case-sensitive וחייב להתאים בדיוק. | ודאו שהתבנית שלכם אושרה ושם התבנית והשפה המקומית נכונים. ראו את מסמך ה-Templates כדי ללמוד עוד על תבניות. |
132005 | תבניות | טקסט מתורגם ארוך מדי Template hydrated text too long | הטקסט המתורגם ארוך מדי. כאשר פרמטרים מוזנים לתבנית, הטקסט המלא עשוי לחרוג מהמגבלה. | בדקו ב-WhatsApp Manager שהתבנית שלכם תורגמה. ראו את מסמך 'Template quality' כדי ללמוד כיצד לבדוק את סטטוס התבנית שלכם. |
132007 | תבניות | הפרת מדיניות תווי פורמט Template format character policy violated | תוכן התבנית מפר מדיניות של WhatsApp. WhatsApp יש מדיניות קפדנית לגבי תוכן תבניות למניעת ספאם. | ראו את מסמך 'Template review' כדי ללמוד על סיבות אפשריות להפרה. |
132012 | תבניות | אי התאמת פורמט פרמטר Template parameter format mismatch | ערכי הפרמטרים המשתנים שנכללו בבקשה אינם משתמשים בפורמט שצוין בתבנית. אם התבנית מצפה למספר, שלחו מספר ולא טקסט. | ראו את מסמך ה-Templates כדי ללמוד עוד על פרמטרים ופורמטים של תבניות. |
132015 | תבניות | התבנית מושהית Template is paused | התבנית מושהית בגלל איכות נמוכה ולכן לא ניתן לשלוח אותה בהודעת תבנית. תבניות מושהות בדרך כלל בגלל שיעור גבוה של חסימות או דיווחים. | ערכו את התבנית כדי לשפר את איכותה ונסו שוב לאחר שתאושר. |
132016 | תבניות | התבנית מושבתת Template is disabled | התבנית הושהתה פעמים רבות מדי בגלל איכות נמוכה וכעת היא מושבתת לצמיתות. תבנית מושבתת לא יכולה להיות מופעלת מחדש - חייבים ליצור תבנית חדשה. | צרו תבנית חדשה עם תוכן שונה. |
132068 | מערכת | Flow חסום Flow is blocked | ה-Flow נמצא במצב חסום. Flow עשוי להיות חסום בגלל הפרת מדיניות או בעיה טכנית. | תקנו את ה-Flow. |
132069 | הגבלת קצב | Flow מוגבל Flow is throttled | ה-Flow נמצא במצב מוגבל ו-10 הודעות המשתמשות ב-flow זה כבר נשלחו בשעה האחרונה. מגבלה של 10 הודעות לשעה עבור Flow מסוים. | תקנו את ה-Flow או המתינו לשעה הבאה. |
133000 | אימות | ביטול רישום לא שלם Incomplete deregistration | ניסיון קודם לביטול רישום נכשל. ודאו שתהליך ביטול הרישום הושלם בהצלחה. | בטלו את רישום המספר שוב לפני רישום מחדש. |
133004 | מערכת | שרת זמני לא זמין Server temporarily unavailable | השרת זמנית לא זמין. זוהי בעיה זמנית בצד השרתים של WhatsApp. | בדקו את עמוד סטטוס WhatsApp Business Platform לראות מידע על סטטוס ה-API ובדקו את ערך הפרטים של התגובה לפני שתנסו שוב. |
133005 | אימות | PIN אימות דו-שלבי שגוי Two step verification PIN mismatch | PIN של אימות דו-שלבי שגוי. PIN שגוי מספר פעמים עלול להוביל לחסימה זמנית. | ודאו ש-PIN של אימות דו-שלבי שנכלל בבקשה נכון. כדי לאפס את ה-PIN, השביתו אימות דו-שלבי ואז הגדירו PIN חדש. ראו 'Two-step verification'. |
133006 | אימות | נדרש אימות מחדש של מספר טלפון Phone number re-verification needed | יש צורך לאמת את מספר הטלפון לפני הרישום. תהליך אימות נדרש לפני רישום המספר. | אמתו ורשמו את מספר הטלפון. |
133008 | אימות | יותר מדי ניסיונות PIN Too many PIN guesses | יותר מדי ניסיונות ניחוש PIN של אימות דו-שלבי עבור מספר טלפון זה. זהו מנגנון אבטחה למניעת ניחושי brute force. | נסו שוב לאחר פרק הזמן שצוין בערך הפרטים של התגובה. |
133009 | אימות | PIN הוזן מהר מדי PIN guessed too fast | PIN של אימות דו-שלבי הוזן מהר מדי. המערכת מזהה ניסיונות אוטומטיים מהירים. | בדקו את ערך הפרטים של התגובה לפני שתנסו שוב. |
133010 | אימות | מספר טלפון לא רשום Phone number not registered | מספר הטלפון לא רשום ב-WhatsApp Business Platform. ודאו שתהליך הרישום הושלם במלואו. | רשמו את מספר הטלפון לפני שתנסו שוב. |
133015 | אימות | מספר טלפון נמחק לאחרונה Phone number recently deleted | מספר הטלפון שאתם מנסים לרשום נמחק לאחרונה, והמחיקה עדיין לא הושלמה. זהו זמן המתנה טכני בצד המערכת של WhatsApp. | המתינו 5 דקות לפני שתנסו שוב את הבקשה. |
133016 | הגבלת קצב | הגעתם למגבלת ההודעות Messaging limit reached | הגעתם למספר המקסימלי של משתמשים ייחודיים שניתן לשלוח להם הודעות ב-24 שעות האחרונות. המגבלה נקבעת על פי איכות ההודעות שלכם ומשתנה באופן דינמי. | חכו 24 שעות עד שהמגבלה תתאפס. לשדרוג מגבלת ההודעות, שפרו את איכות ההודעות והפחיתו דיווחים של משתמשים. |
134011 | אימות | תנאי WhatsApp Payments לא אושרו WhatsApp Payments terms not accepted | ההודעה נכשלה בשליחה מכיוון שאישור תנאי השירות של WhatsApp Payments ממתין לחשבון העסקי הזה. נדרש לעסקים שרוצים להשתמש בתכונות תשלום. | אשרו את תנאי השירות של WhatsApp Payments באמצעות הקישור המסופק בהודעת השגיאה לפני שתנסו שוב. |
135000 | הודעות | שגיאת משתמש כללית Generic user error | ההודעה נכשלה בשליחה בגלל שגיאה לא ידועה עם פרמטרי הבקשה שלכם. זוהי שגיאה כללית - בדקו לוגים למידע נוסף. | בדקו שוב את כל הפרמטרים שאתם שולחים ווודאו שהם תואמים לתיעוד ה-API. |