WhatsApp-Fehler 4: App hat ihr API-Aufruflimit erreicht
Der Fehlercode 4 bedeutet, dass die App ihr API-Aufruflimit erreicht hat. Meta beschreibt ihn mit "The app has reached its API call rate limit." Gezählt werden die Aufrufe der App innerhalb einer gleitenden Stunde, nicht die von einer Nummer gesendeten Nachrichten. Prüfen Sie die Nutzung im App Dashboard, warten Sie ab und senken Sie, wie oft die App die API aufruft.
Metas Code für "The app has reached its API call rate limit."
Anzahl der Aufrufe, die eine App laut Graph API Platform Rate Limits in einer Stunde ausführen darf.
Der Name, den der Graph API Error-Handling-Leitfaden für Code 4 verwendet.
Was bedeutet der WhatsApp-Fehlercode 4?
Er bedeutet, dass Ihre App im aktuellen Zeitfenster zu viele API-Aufrufe gemacht hat und weitere Aufrufe abgelehnt werden, bis der Zähler wieder sinkt.
Meta führt Code 4 unter den Throttling-Fehlern mit dem Detailtext "The app has reached its API call rate limit." auf. Der Graph API Error-Handling-Leitfaden nennt ihn API Too Many Calls und beschreibt ihn als vorübergehendes Throttling-Problem.
Er steht neben zwei weiteren Throttling-Codes, die sich leicht mit ihm verwechseln lassen. 80007 bedeutet, dass das WhatsApp Business Account sein Ratenlimit erreicht hat. 130429 betrifft den Nachrichtendurchsatz der Cloud API. Code 4 ist keines von beiden: Er betrifft das eigene Aufrufbudget der App.
Wie wird das Aufruflimit der App berechnet?
Für Anfragen mit einem App-Access-Token nennt Metas Leitfaden zum Graph API Rate Limiting eine Formel: Die Aufrufe innerhalb einer Stunde entsprechen 200 multipliziert mit der Anzahl der Nutzer.
Die Anzahl der Nutzer richtet sich nach den eindeutigen täglich aktiven Nutzern der App. Sinkt die tägliche Nutzung, werden Wochen- und Monatswerte herangezogen. Das Limit gilt für die App insgesamt und nicht pro Nutzer, sodass wenige aktive Nutzer den größten Teil davon verbrauchen können.
Laut Leitfaden erscheint die Nutzung außerdem im App Dashboard und, sobald genug Aufrufe erfolgt sind, in einem X-App-Usage Header der Antworten. Anhand dieses Headers sehen Sie, dass sich das Limit nähert, bevor Fehler 4 auftritt.
Was sollten Sie nach Fehler 4 tun?
Hören Sie eine Weile auf, die API aufzurufen, und rufen Sie sie danach seltener auf.
Zum ersten Teil ist Metas Leitfaden eindeutig: Ist das Limit erreicht, stellen Sie die API-Aufrufe ein, denn weitere Aufrufe erhöhen den Zähler und verlängern die Zeit, bis Aufrufe wieder gelingen.
Der zweite Teil ist eine Frage des Designs. Verteilen Sie Anfragen gleichmäßig statt in Schüben, filtern Sie Antworten, damit ein Aufruf genau das liefert, was Sie brauchen, und vermeiden Sie Aufrufe, die sich überschneidende Daten abrufen. Meist ist Polling der Verursacher. Eine Integration, die alle paar Sekunden denselben Konto-Status abfragt, verbraucht ihr Budget für Antworten, die sie längst hat.
Häufige Fehler
- Wiederholungen in einer Schleife. Jeder zusätzliche Aufruf erhöht den Zähler und verschiebt die Erholung weiter nach hinten.
- Den Fehler für ein Sendelimit halten. Code 4 zählt die Aufrufe der App, der Nachrichtendurchsatz ist dagegen 130429.
- Status-Endpoints in kurzen Abständen abfragen. Wiederholtes Lesen unveränderter Daten verbraucht das Stundenbudget.
EasyCoexistence überwacht jede verbundene Nummer rund um die Uhr auf eigener Seite. Die Prüfung der Verbindung muss deshalb nicht als Polling-Schleife gegen das Aufrufbudget Ihrer App gebaut werden.
Häufig gestellte Fragen
Ist Fehler 4 dasselbe wie Fehler 130429?
Nein. 130429 betrifft den Nachrichtendurchsatz einer Nummer. Fehler 4 betrifft die Anzahl der API-Aufrufe Ihrer App.
Wie lange dauert Fehler 4?
Bis die Zahl der Aufrufe im gleitenden Zeitfenster von einer Stunde unter das Limit fällt. Weitere Aufrufe in dieser Zeit verlängern die Dauer.
Wo sehe ich, wie nah meine App am Limit ist?
Im Bereich Application Rate Limit des App Dashboards und im X-App-Usage Header, der mit den Antworten zurückkommt.
Ist Fehler 4 dasselbe wie Fehler 80007?
Nein. Meta verwendet 80007, wenn das WhatsApp Business Account sein Ratenlimit erreicht, während Fehler 4 die eigenen Aufrufe der App zählt.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am