שגיאה 4 ב-WhatsApp: האפליקציה הגיעה למגבלת הקריאות
קוד שגיאה 4 אומר שהאפליקציה הגיעה למגבלת הקריאות ל-API. התיאור של Meta: "The app has reached its API call rate limit." המגבלה סופרת קריאות של האפליקציה בחלון נע של שעה, ולא הודעות שנשלחות ממספר. בודקים את השימוש בלוח הבקרה של האפליקציה, ממתינים ומקטינים את תדירות הקריאות.
הקוד של Meta עבור "The app has reached its API call rate limit."
מספר הקריאות שאפליקציה רשאית לבצע בשעה לפי Graph API Platform Rate Limits.
השם שמדריך הטיפול בשגיאות של Graph API נותן לקוד 4.
מה המשמעות של קוד שגיאה 4 ב-WhatsApp?
המשמעות: האפליקציה ביצעה יותר מדי קריאות ל-API בחלון הנוכחי, וקריאות נוספות נדחות עד שהספירה יורדת.
Meta מפרטת את קוד 4 בין שגיאות ההגבלה (throttling) עם טקסט הפרטים "The app has reached its API call rate limit." מדריך הטיפול בשגיאות של Graph API קורא לו API Too Many Calls ומתאר אותו כבעיית הגבלה זמנית.
לצידו יש שני קודי הגבלה אחרים שקל לבלבל איתו. 80007 מציין שחשבון WhatsApp Business הגיע למגבלת הקצב שלו. 130429 הוא קצב ההודעות ב-Cloud API עצמו. קוד 4 אינו אף אחד מהם: זו מכסת הקריאות של האפליקציה.
איך מחושבת מגבלת הקריאות של האפליקציה?
בבקשות שנעשות עם אסימון גישה (Access Token) של האפליקציה, מדריך הגבלת הקצב של Graph API מבית Meta נותן נוסחה: מספר הקריאות בשעה שווה ל-200 כפול מספר המשתמשים.
מספר המשתמשים מבוסס על המשתמשים הפעילים הייחודיים ביום, ובנתונים שבועיים וחודשיים משתמשים כשהשימוש היומי יורד. זו מגבלה על האפליקציה כולה ולא לכל משתמש, ולכן כמה משתמשים פעילים מאוד יכולים לנצל את רובה.
המדריך מוסיף שהשימוש מופיע בלוח הבקרה של האפליקציה, ולאחר מספר מספיק של קריאות גם בכותרת X-App-Usage בתגובות. הכותרת הזו מאפשרת לראות שהמגבלה מתקרבת עוד לפני ששגיאה 4 מגיעה.
מה עושים אחרי שגיאה 4?
מפסיקים לקרוא לזמן מה, ואז קוראים פחות.
המדריך של Meta ברור לגבי החלק הראשון: כשהמגבלה הושגה, מפסיקים לבצע קריאות API, כי המשך הקריאות מגדיל את הספירה ומאריך את הזמן עד שהקריאות יצליחו שוב.
החלק השני הוא תכנון. מפזרים בקשות באופן אחיד במקום בהתפרצויות, מסננים תגובות כך שקריאה אחת תחזיר את מה שצריך, ונמנעים מקריאות שמביאות נתונים חופפים. לרוב האשם הוא סקירה חוזרת (polling) בתדירות גבוהה. אינטגרציה ששואלת על סטטוס החשבון כל כמה שניות מבזבזת את המכסה על תשובות שכבר יש לה.
טעויות נפוצות
- ניסיון חוזר בלולאה. כל קריאה נוספת מוסיפה לספירה ודוחקת את ההתאוששות רחוק יותר.
- התייחסות לשגיאה כמגבלת שליחה. קוד 4 סופר קריאות של האפליקציה, ואילו קצב ההודעות הוא 130429.
- בדיקת נקודות הקצה של הסטטוס במרווחים קצרים. קריאות חוזרות לנתונים שלא השתנו מבזבזות את המכסה השעתית.
EasyCoexistence מנטרת כל מספר מחובר 24/7 מצידה, כך שבדיקת תקינות החיבור לא חייבת להיבנות כלולאת בדיקות חוזרות שמנצלת את מכסת הקריאות של האפליקציה שלכם.
שאלות נפוצות
האם שגיאה 4 זהה לשגיאה 130429?
לא. 130429 הוא קצב ההודעות של מספר. שגיאה 4 סופרת את קריאות ה-API שהאפליקציה שלכם ביצעה.
כמה זמן נמשכת שגיאה 4?
עד שמספר הקריאות בחלון הנע של שעה אחת יורד מתחת למגבלה. קריאות בזמן הזה מאריכות אותה.
איפה רואים כמה האפליקציה קרובה למגבלה?
בלוח הבקרה של האפליקציה, בסעיף Application Rate Limit, ובכותרת X-App-Usage שמוחזרת בתגובות.
האם שגיאה 4 זהה לשגיאה 80007?
לא. Meta משתמשת ב-80007 כשחשבון WhatsApp Business מגיע למגבלת הקצב שלו, ואילו שגיאה 4 סופרת את הקריאות של האפליקציה עצמה.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-