Errore 4 di WhatsApp: l'app ha raggiunto il limite di chiamate API
Il codice di errore 4 indica che l'app ha raggiunto il limite di chiamate API. Meta lo descrive così: "L'app ha raggiunto il limite di frequenza delle chiamate API." Conta le chiamate fatte dall'app in un'ora mobile, non i messaggi inviati da un numero. Controlla l'uso nell'App Dashboard, aspetta e riduci la frequenza con cui l'app chiama l'API.
Il codice di Meta per "L'app ha raggiunto il limite di frequenza delle chiamate API."
Le chiamate che un'app può fare in un'ora secondo i Graph API Platform Rate Limits.
Il nome che la guida alla gestione degli errori della Graph API dà al codice 4.
Cosa significa il codice di errore 4 di WhatsApp?
Significa che la tua app ha fatto troppe chiamate API nella finestra attuale e che le chiamate successive vengono rifiutate finché il conteggio non scende.
Meta classifica il codice 4 tra gli errori di throttling, con il testo di dettaglio "L'app ha raggiunto il limite di frequenza delle chiamate API." La guida alla gestione degli errori della Graph API lo chiama API Too Many Calls e lo descrive come un problema temporaneo di throttling.
Si affianca a due altri codici di throttling facili da confondere. 80007 indica che l'account WhatsApp Business ha raggiunto il suo limite di frequenza. 130429 riguarda il throughput dei messaggi della Cloud API. Il codice 4 non è nessuno dei due: è il budget di chiamate dell'app stessa.
Come si calcola il limite di chiamate dell'app?
Per le richieste fatte con un token di accesso dell'app, la guida di Meta ai limiti di frequenza della Graph API riporta una formula: le chiamate in un'ora sono pari a 200 moltiplicato per il numero di utenti.
Il numero di utenti si basa sugli utenti attivi giornalieri unici dell'app, con i dati settimanali e mensili usati quando quello giornaliero cala. È un limite sull'app nel suo insieme e non per singolo utente, quindi pochi utenti molto attivi possono consumarne gran parte.
La guida aggiunge che l'uso compare nell'App Dashboard e, dopo un numero sufficiente di chiamate, in un header X-App-Usage nelle risposte. Quell'header è il modo per vedere il limite avvicinarsi prima che arrivi l'errore 4.
Cosa fare dopo l'errore 4?
Smetti di chiamare per un po', poi chiama meno.
La guida di Meta ai limiti di frequenza è chiara sulla prima parte: quando il limite è stato raggiunto, interrompi le chiamate API, perché continuare aumenta il conteggio e allunga il tempo prima che le chiamate tornino ad avere successo.
La seconda parte riguarda la progettazione. Distribuisci le richieste in modo uniforme invece che a raffiche, filtra le risposte in modo che una sola chiamata restituisca ciò che serve ed evita chiamate che recuperano dati sovrapposti. Il polling è di solito il colpevole. Un'integrazione che chiede lo stato dello stesso account ogni pochi secondi spende il suo budget per risposte che ha già.
Errori comuni
- Riprovare in un ciclo. Ogni chiamata in più si somma al conteggio e allontana il recupero.
- Trattarlo come un limite di invio. Il codice 4 conta le chiamate dell'app, mentre il throughput dei messaggi è il 130429.
- Fare polling degli endpoint di stato a intervalli brevi. Letture ripetute di dati invariati consumano il budget orario.
EasyCoexistence monitora ogni numero connesso 24 ore su 24, 7 giorni su 7, dal suo lato, quindi controllare la salute della connessione non richiede di costruire un ciclo di polling che pesa sul budget di chiamate della tua app.
Domande frequenti
L'errore 4 è lo stesso del 130429?
No. Il 130429 riguarda il throughput dei messaggi di un numero. L'errore 4 riguarda il numero di chiamate API fatte dalla tua app.
Quanto dura l'errore 4?
Finché il conteggio delle chiamate nella finestra mobile di un'ora non scende sotto il limite. Se chiami in questo periodo, si allunga.
Dove posso vedere quanto la mia app è vicina al limite?
Nella sezione Application Rate Limit dell'App Dashboard e nell'header X-App-Usage restituito nelle risposte.
L'errore 4 è lo stesso dell'80007?
No. Meta usa l'80007 quando l'account WhatsApp Business raggiunge il suo limite di frequenza, mentre l'errore 4 conta le chiamate dell'app stessa.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il