מדריך שגיאות בשליחת תבניות וואטסאפ: הקודים, הסיבות והפתרונות | שיג ושיח

טבלת עזר מהירה

קודי השגיאה, אחד-אחד

131049: חסימת מסרים שיווקיים על ידי מטא (Healthy ecosystem engagement)

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

מדוע זה קורה:

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

מה עושים כדי שההודעה תגיע בכל זאת:

• להמתין לפחות 24 שעות לפני ניסיון חוזר, ולהאריך את ההמתנה בכישלון חוזר (יומיים, שבוע)
• לשלוח תבנית Utility במקום Marketing. תבניות תפעוליות אינן כפופות למכסה
• לנצל חלון שירות: כאשר הנמען פונה לעסק, ניתן לשלוח הודעות חופשיות במשך 24 שעות
• לשלב ערוץ חלופי (SMS, דוא"ל) לנמענים שנחסמים שוב ושוב
• לוודא שתוכן שיווקי אינו נשלח בתבנית המסווגת Utility. סיווג שגוי מחמיר את המצב

131050: הנמען ביטל קבלת מסרים שיווקיים (Recipient stopped marketing messages)

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

מדוע זה קורה:

• לחיצה של הנמען על "הפסקת קבלת הודעות שיווקיות" בממשק וואטסאפ
• ההגבלה חלה על תבניות Marketing בלבד

מה עושים כדי שההודעה תגיע בכל זאת:

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

131026: הודעה שאינה ניתנת למסירה (Message undeliverable)

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

מדוע זה קורה:

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

מה עושים כדי שההודעה תגיע בכל זאת:

• לאמת את המספר מול הלקוח בערוץ אחר, או לבדוק ידנית אם המספר קיים בוואטסאפ
• לנמענים שנכשלים שוב ושוב: לסמן במערכת ולהפסיק ניסיונות אוטומטיים
• ליצור קשר בערוץ חלופי (שיחה, SMS) ולעדכן מספר אם הוחלף
• ניסיון חוזר מיידי אינו מועיל כאשר המספר אינו פעיל בוואטסאפ

130472: המספר משתתף בניסוי של מטא (User's number is part of an experiment)

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

מדוע זה קורה:

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

מה עושים כדי שההודעה תגיע בכל זאת:

• ההודעה תימסר אם הנמען פונה לעסק קודם: מענה להודעה, לחיצה על מודעת Click-to-WhatsApp או קישור wa.me
• לשלוח תבנית Utility. הניסוי אינו חוסם תבניות תפעוליות
• לנסות שוב בהמשך. ההקצאה לניסוי משתנה עם הזמן

131042: בעיית חיוב בחשבון העסקי (Business eligibility payment issue)

מה קרה: מטא דחתה את השליחה בגלל בעיה באמצעי התשלום או בהגדרות החיוב של חשבון הוואטסאפ העסקי (WABA). אף הודעה אינה נמסרת עד לפתרון.

מדוע זה קורה:

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

מה עושים כדי שההודעה תגיע בכל זאת:

• לפתוח את WhatsApp Manager: הגדרות תשלום, ולוודא שאמצעי התשלום פעיל ותקף
• לבדוק מסגרת אשראי ופרטי מס בחשבון ה-Business Manager
• לאחר הסדרת התשלום ניתן לשלוח מחדש לכל הנמענים שנכשלו. החסימה אינה קשורה לנמען

131008: פרמטר חובה חסר בתבנית (Required parameter is missing)

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

מדוע זה קורה:

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

מה עושים כדי שההודעה תגיע בכל זאת:

• לוודא שכל משתנה בתבנית ממופה לשדה קיים
• להגדיר ערך ברירת מחדל לכל משתנה (לדוגמה: "לקוח יקר" כאשר אין שם פרטי)
• להשלים את הנתון החסר בכרטיסי הלקוחות ולשלוח שוב. לאחר התיקון השליחה תצליח

132000: אי-התאמה במספר הפרמטרים (Number of parameters does not match)

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

מדוע זה קורה:

• התבנית עודכנה אצל מטא (נוסף או הוסר משתנה) אך הזרימה לא סונכרנה
• נבחרה גרסת תבנית שגויה בזרימה

מה עושים כדי שההודעה תגיע בכל זאת:

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

תוכן הודעה ריק (Message content is empty)

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

מדוע זה קורה:

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

מה עושים כדי שההודעה תגיע בכל זאת:

• לאתר את הצומת בזרימה שממנו נשלחה ההודעה ולהוסיף ערך ברירת מחדל
• לבדוק את תקינות הנתונים בכרטיסי הנמענים שנכשלו
• לאחר התיקון השליחה החוזרת תצליח

פסק זמן בטעינת קובץ מדיה (Media download timeout)

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

מדוע זה קורה:

• קובץ מדיה גדול מדי ביחס לחלון הזמן של השליחה
• עומס או איטיות זמנית באחסון הקבצים

מה עושים כדי שההודעה תגיע בכל זאת:

• לדחוס וידאו או להקטין רזולוציה. מומלץ עד 5MB לשליחה יציבה
• להעלות את הקובץ מחדש לאחר הדחיסה ולעדכן את הזרימה
• לשקול קישור לצפייה במקום צירוף הקובץ המלא

פסק זמן כללי בבקשה (Request timeout)

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

מדוע זה קורה:

• איטיות זמנית בתקשורת מול ה-API של מטא

מה עושים כדי שההודעה תגיע בכל זאת:

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

לעקוב אחרי זה בלי לפתוח יומן

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

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

שאלות נפוצות