שגיאת 429 ב WhatsApp API (קוד שגיאה HTTP 429 Too Many Requests) מתרחשת כאשר מערכת הדיוור שלכם חורגת ממגבלת הקריאות לשנייה שמקצה Meta למספר הטלפון של העסק. כדי למנוע את חסימת הבקשות ואובדן הודעות, יש לנתב את כל תעבורת ההודעות דרך תור מנוהל שמפעיל אלגוריתם השהיה חכם (Exponential Backoff with Jitter) ומווסת את קצב השליחה בהתאם לקיבולת החשבון. במאמר זה נסביר מה גורם לשגיאה 429, כיצד פועלות מגבלות הקצב של Meta Cloud API, וכיצד בנוי מנגנון התורים של WAGate שמבטיח מסירה מלאה גם בעומסי שיא.
מהי שגיאת 429 ב-WhatsApp API ומדוע Meta מחזירה אותה?
שגיאת 429 Too Many Requests היא קוד סטטוס בפרוטוקול HTTP המוגדר תחת RFC 6585, שמשמעותו שהשרת המקבל מסרב לעבד בקשות נוספות משום שהלקוח שלח יותר מדי בקשות בפרק זמן נתון. בהקשר של Meta Cloud API, שגיאה זו מעידה על חריגה ממכסת הקריאות לשנייה (Throughput Limit) המוגדרת לחשבון הוואטסאפ העסקי (WABA).
כאשר חנות איקומרס מפעילה קמפיין שיווקי לרשימת תפוצה של אלפי נמענים במקביל לעדכוני רכישה שוטפים, שליחה ישירה ללא בקרת עומסים תגרום לכך שהשרתים של Meta ישיבו בתגובת שגיאה עם קוד שגיאה פנימי 130429 או 80007. ברגע שמוחזרת שגיאה 429, Meta אינה שומרת את ההודעה בתור ואינה מבצעת ניסיון נוסף. האחריות לטפל בהודעה, להמתין ולשדר אותה מחדש מוטלת כולה על המערכת השולחת.
| קוד שגיאה ב-Graph API | משמעות | פעולת Meta | פעולה נדרשת מהמערכת |
|---|---|---|---|
| 130429 (Rate limit hit) | חריגה ממגבלת הודעות לשנייה למספר | הבקשה נדחית ונמחקת | השהיה אקספוננציאלית ושליחה חוזרת |
| 80007 (Rate limit exceeded) | חריגה זמנית ברמת האפליקציה | הבקשה נדחית ונמחקת | האטת קצב כלל התורים במערכת |
| 429 (HTTP Status) | שגיאת מעטפת כללית של שרתי Meta | ניתוק החיבור הנוכחי | קריאת כותרת Retry-After ועצירה |
הבנת מגבלות הקצב (Rate Limits) ב-Meta Cloud API
מגבלות הקצב בחיבור WhatsApp Cloud API מחולקות לשתי שכבות עיקריות שחשוב להבדיל ביניהן:
- מגבלת נפח יומית (Messaging Tier): מגבלה הקובעת לכמה משתמשים ייחודיים ניתן ליזום פנייה בחלון זמן של 24 שעות (Tier 1 של 1,000 נמענים, Tier 2 של 10,000 נמענים, ועד שליחה ללא הגבלה).
- מגבלת תפוקה לשנייה (Throughput Limits): מגבלה טכנית הקובעת כמה בקשות HTTP מסוג POST ניתן לשלוח לשרת בכל שנייה בודדת.
לפי התיעוד הרשמי של Meta למפתחי WhatsApp, מרבית החשבונות מתחילים בתפוקה של 80 הודעות בשנייה (עבור הודעות טקסט והודעות תבנית פשוטות), בעוד שבחשבונות מסוימים המגבלה ההתחלתית עשויה לעמוד על 20 הודעות בשנייה. כאשר שולחים הודעות מדיה מורכבות הכוללות תמונות מוצר, קובצי PDF או סרטונים, העיבוד בשרתי Meta דורש משאבים נוספים, ומגבלת הקצב בפועל יורדת באופן משמעותי.
צוואר הבקבוק בחנויות איקומרס: הבזקי תעבורה (Bursts)
בפעילות שוטפת של חנות מקוונת, קריאות ה-API מתפזרות לאורך שעות היום. אולם באירועי מכירות מיוחדים (כגון בלאק פריידיי או השקת מוצר חדש), נוצר עומס כפול:
- הודעות תפעוליות מיידיות: מערכות כגון WhatsApp ל-Shopify או WhatsApp ל-WooCommerce שולחות אישורי הזמנה, עדכוני משלוח והודעות שחזור עגלה. אלו הודעות קריטיות שחייבות להגיע בזמן אמת.
- הודעות שיווק יזומות: קמפיין שנשלח בלחיצת כפתור אחת לרשימת לקוחות של 5,000 נמענים מייצר אלפי קריאות API באותו שבריר שנייה.
אם הארכיטקטורה אינה כוללת שכבת ניהול תורים מתוחכמת, קמפיין השיווק ישרוף את כל מכסת הקריאות של המספר, ואישורי ההזמנה של לקוחות שרכשו באותו רגע יידחו עם שגיאת 429. הלקוח לא יקבל את אישור ההזמנה, צוות התמיכה יוצף בפניות, ומדדי האיכות (Quality Rating) של המספר ב-Meta עלולים להיפגע כתוצאה משיעורי כשל גבוהים.
כיצד WAGate מונעת שגיאות עומס: ארכיטקטורת ניהול תורים והשהיה חכמה
כדי למנוע תקלות אלו, פלטפורמת WAGate מבוססת על מנוע תורים מבוזר ורב-שלבי, הפועל כמחסום ויסות בין מערכות האיקומרס לבין ה-API של Meta. המנגנון בנוי מארבעה רכיבי ליבה:
1. הפרדת תורים לפי עדיפות (Priority Queuing)
המערכת מנהלת תורים נפרדים להודעות טרנזקציוניות ולהודעות שיווקיות:
- תור עדיפות עליונה (High Priority): הודעות אימות (OTP), התראות התחברות ואישורי רכישה מחנויות מקוונות נכנסות לערוץ ייעודי ומקבלות קדימות מיידית בשיגור.
- תור שיווקי מווסת (Standard Priority): קמפיינים המוניים מחולקים למנות (Batches) מתוזמנות. המערכת משחררת הודעות שיווקיות רק כאשר יש קיבולת פנויה שאינה מסכנת את ההודעות התפעוליות.
2. בקרת דליפת טוקנים (Leaky Bucket Rate Limiter)
לפני ביצוע קריאת HTTP לעבר השרתים של Meta, כל בקשה עוברת דרך רכיב בקרת קצב. אם המגבלה לחשבון מוגדרת ל-80 הודעות בשנייה, המנוע של WAGate יגביל את השיגור היזום לקצב בטוח (למשל, 70-75 הודעות בשנייה). שולי הביטחון הללו מבטיחים שגם תנודות זמניות בשרתי Meta לא יגרמו לחריגה מהמכסה.
3. מנגנון Exponential Backoff עם Full Jitter
במידה ש-Meta מחזירה תשובת HTTP 429 (למשל עקב עומס פתאומי בצד השרת שלהם), המערכת אינה מנסה לשלוח שוב מיד. ניסיון שליחה מיידי רק מגביר את העומס על שרת שכבר קורס. במקום זאת, מופעל אלגוריתם נסיגה אקספוננציאלית:
- הניסיון הראשון נדחה בפרק זמן קצר (למשל, 500 מילי-שניות).
- הניסיון השני נדחה בפרק זמן כפול (1,000 מילי-שניות).
- הניסיון השלישי מוכפל שוב (2,000 מילי-שניות), וכן הלאה.
לזמני ההמתנה מתווסף רכיב אקראי (Jitter). פיזור ההודעות בפרקי זמן אקראיים מונע את תופעת ה-Thundering Herd, שבה אלפי הודעות שנדחו מנסות להישלח שוב באותה מילי-שנייה ויוצרות גל חסימות חדש.
4. האזנה לכותרות תגובה (Response Headers)
כאשר שרתי Meta מספקים בתגובת השגיאה את כותרת ה-HTTP שנקראת Retry-After, המנוע של WAGate קורא את הערך במדויק ומשהה את שידור ההודעות מאותו מספר טלפון בדיוק למשך הזמן שביקשה Meta, מבלי לזרוק את ההודעות ומבלי לפגוע בסדר המסירה.
מעקב סטטוסים מלא ומניעת כפילויות
אחד הסיכונים הנפוצים בניסיון שליחה חוזר (Retry) בעקבות שגיאות רשת הוא שליחה כפולה של אותה הודעה ללקוח. אם הבקשה נקלטה ב-Meta אך תגובת האישור אבדה ברשת, שליחה חוזרת עלולה להביא לכך שהלקוח יקבל שתי הודעות זהות.
WAGate מיישמת עקרון אידמפוטנטיות (Idempotency Key) ייחודי לכל שיגור, לצד מעקב מלא דרך Webhooks אחר כל שלב בחיי ההודעה. ניתן לקרוא בהרחבה על אופן עיבוד האותות במדריך שלנו אודות סטטוס מסירה בוואטסאפ. כל שינוי סטטוס מתועד בזמן אמת, כך שצוות התמיכה והמערכות האוטומטיות יודעים בדיוק אילו הודעות נמצאות בהמתנה, אילו נמסרו ואילו ממתינות לשליחה חוזרת.
סיכום והמלצות יישום
התמודדות עם שגיאת 429 ב WhatsApp API אינה דורשת צמצום של היקף הפעילות או ויתור על קמפיינים שיווקיים, אלא יישום תשתיות תקשורת שמכבדות את מגבלות השרתים של Meta. ניהול תורים מבוקר, מנגנוני השהיה עם פיזור עומסים ותעדוף הודעות תפעוליות הם הבסיס לעבודה יציבה בעסקים מבוססי מסחר מקוון.
פלטפורמת WAGate מספקת את כל התשתית הזו באופן מובנה, ומאפשרת חיבור מהיר ל-WooCommerce, Shopify ו-HubSpot בחבילות חודשיות גמישות של $19, $49 ו-$99, עם שבוע ניסיון ללא כרטיס אשראי. אם אתם חווים שגיאות עומס בשליחת הודעות ללקוחות, צרו קשר עם צוות המומחים שלנו לבחינת פתרון ניתוב מותאם.
שאלות נפוצות
מה ההבדל בין שגיאת 429 לשגיאת חסימת חשבון ב-WhatsApp API?
שגיאת 429 היא שגיאת עומס טכנית וזמנית שמשמעותה חריגה ממספר הקריאות המותר לשנייה. היא אינה מעידה על ענישה או השעיה של החשבון. לעומת זאת, חסימת חשבון מתרחשת עקב הפרת מדיניות השימוש של Meta, מחזירה קודי שגיאה שונים (כגון שגיאות הרשאה 401 או 403), ומונעת כל אפשרות לשלוח הודעות עד להגשת ערעור.
כמה הודעות בשנייה מותר לשלוח דרך Meta Cloud API?
עסקים המחוברים ל-Meta Cloud API מתחילים בדרך כלל עם מגבלת תפוקה בסיסית של 80 הודעות בשנייה לחשבון עבור הודעות טקסט רגילות ותבניות פשוטות. בחשבונות חדשים מסוימים המגבלה ההתחלתית עשויה לעמוד על 20 הודעות בשנייה. שליחת קובצי מדיה כבדים עשויה להפחית את הקצב המעשי המאושר על ידי השרתים.
האם ניסיון שליחה חוזר מידי של הודעה שנכשלה בשגיאה 429 עוזר?
לא, ניסיון שליחה מיידי מחמיר את הבעיה. שרתי Meta דוחים הודעות נוספות כל עוד העומס נמשך. ניסיונות חוזרים רצופים ללא השהיה יובילו לרצף שגיאות 429 נוספות ועלולים לגרום לחסימה זמנית ארוכה יותר. הפתרון הנכון הוא השהיה אקספוננציאלית (Exponential Backoff) שמגדילה את מרווח הזמן בין ניסיון לניסיון.
איך ניתן להגן על הודעות דחופות כמו קודי אימות בזמן שליחת קמפיין?
ההגנה מושגת באמצעות פיצול תורים לפי רמות עדיפות. תור ייעודי מקבל קדימות מוחלטת לקודי אימות והודעות תפעוליות מחנות האיקומרס, בעוד שהודעות הקמפיין השיווקי מנותבות לתור משני שמווסת ומגביל את קצב השיגור שלו, כך שנשאר תמיד רוחב פס פנוי להודעות החשובות.
נסו את זה על המספר שלכם.
WhatsApp, Messenger, Instagram וצ'אטבוט ה-AI — 7 ימי ניסיון חינם, בלי כרטיס אשראי.

