Risposta breve
Secondo la documentazione di Meta, ogni numero di telefono aziendale della WhatsApp Cloud API supporta per impostazione predefinita fino a 80 messaggi al secondo, che salgono a 1.000 con upgrade automatico per i numeri idonei. Limiti separati valgono per lo stesso destinatario, per le chiamate di gestione della Graph API e per i messaggi giornalieri. Superare il throughput restituisce l’errore 130429: rallentate, accodate il lavoro e riprovate con backoff.
Arrivare a 1.000 messaggi al secondo
Il limite si applica a ciascun numero di telefono aziendale e conta i messaggi in entrata e in uscita di ogni tipo. Meta esegue l’upgrade dei numeri idonei in automatico e senza costi, quando valgono tutte e tre le condizioni. L’upgrade può richiedere fino a 1 minuto, durante il quale il numero non è utilizzabile.
I numeri usati sia con l’app WhatsApp Business sia con la Cloud API hanno un limite fisso di 20 messaggi al secondo.
| Requisito | Dettaglio |
|---|---|
| Limite di messaggistica | Illimitato sul portfolio aziendale |
| Volume | 100.000 o più utenti unici contattati fuori dalle finestre di assistenza clienti in 24 ore mobili |
| Qualità | Punteggio di qualità YELLOW (medio) o superiore |
Quattro limiti diversi e i relativi errori
| Limite | Cosa limita | Errore tipico |
|---|---|---|
| Throughput | Messaggi al secondo per numero | 130429 |
| Limite di coppia (pair rate limit) | Messaggi da un numero allo stesso destinatario in poco tempo | 131056 |
| Limiti della Graph API | Chiamate di gestione per app e account | 4, 80007, 80008 |
| Limite di messaggistica | Persone uniche raggiunte in 24 ore mobili | Restrizioni all’invio |
Come riprovare in sicurezza
- Accodate ogni invio e svuotate la coda con un pool di worker.
- Limitate la frequenza sotto il vostro tetto, lasciando spazio alle risposte.
- Registrate ogni messaggio prima dell’invio, così un nuovo tentativo non crea mai duplicati.
- Riprovate solo in caso di limitazione e di errori temporanei del server, con backoff esponenziale e jitter, limitando ritardo e numero di tentativi.