---
title: "Throughput e rate limit della WhatsApp Cloud API spiegati"
description: "Throughput e rate limit della WhatsApp Cloud API: messaggi al secondo, come aumentarli, limiti pair e Graph API, codici di errore e nuovi tentativi con backoff."
canonical: "https://omnichannels.ai/it/blog/whatsapp-api-throughput-rate-limits/"
language: "it"
updated: "2026-11-07"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
category: "integration"
primaryQuery: "whatsapp cloud api throughput"
keywords: ["rate limit whatsapp api", "messaggi al secondo whatsapp", "errore 130429", "pair rate limit whatsapp", "errore 131056", "whatsapp api 80 mps", "rate limit graph api whatsapp", "retry backoff whatsapp", "throughput whatsapp cloud api"]
published: "2026-11-07"
author: "OmniChannels.ai Editorial Team"
reviewer: "BroadNet Messaging Solutions Team"
readingMinutes: 9
answer: "Secondo la documentazione di Meta, ogni numero di telefono aziendale della WhatsApp Cloud API supporta per impostazione predefinita fino a 80 messaggi al secondo, fino a 1.000 con aggiornamento automatico per i numeri idonei. Limiti distinti valgono per lo stesso destinatario (pair rate limit), per le chiamate di gestione della Graph API e per il numero di persone che potete contattare ogni giorno. Superato il throughput, l'API restituisce l'errore 130429: rallentate, mettete il lavoro in coda e riprovate con backoff."
takeaways: ["Secondo la documentazione di Meta sul throughput, un numero di telefono aziendale supporta per impostazione predefinita fino a 80 messaggi al secondo e fino a 1.000 con aggiornamento automatico; il tetto comprende i messaggi in entrata e in uscita di ogni tipo.", "L'aggiornamento automatico a 1.000 mps richiede un limite di messaggistica illimitato, messaggi ad almeno 100.000 utenti unici fuori dalle finestre di assistenza clienti in 24 ore mobili e un punteggio di qualità medio o superiore.", "Esistono quattro limiti diversi: throughput per numero, un pair rate limit per destinatario, limiti di chiamate della Graph API e limiti giornalieri di messaggistica; ciascuno ha il proprio errore.", "L'errore 130429 indica che il throughput è stato raggiunto, 131056 che i messaggi allo stesso destinatario sono troppi, e 80007 che l'account WhatsApp Business ha raggiunto il suo rate limit.", "Un invio massivo richiede una coda, un limitatore di frequenza sotto il vostro limite, nuovi tentativi con backoff esponenziale e jitter e un server webhook dimensionato per il traffico degli stati."]
faq: 
  - q: "Qual è il rate limit della WhatsApp Cloud API?"
    a: "Ce ne sono diversi. Meta documenta fino a 80 messaggi al secondo per numero di telefono aziendale per impostazione predefinita e fino a 1.000 con aggiornamento automatico. Esistono poi un pair rate limit per destinatario, limiti di chiamate della Graph API per gli endpoint di gestione e limiti giornalieri di messaggistica che fissano quante persone uniche potete raggiungere. Ciascuno restituisce un errore diverso."
  - q: "Come ottengo un throughput WhatsApp superiore a 80 messaggi al secondo?"
    a: "Meta porta i numeri idonei fino a 1.000 messaggi al secondo in automatico e senza costi. Servono un limite di messaggistica illimitato sul portfolio aziendale, messaggi ad almeno 100.000 utenti unici fuori dalle finestre di assistenza clienti entro 24 ore mobili e un punteggio di qualità giallo o superiore. L'aggiornamento può richiedere fino a un minuto, durante il quale il numero non è utilizzabile."
  - q: "Che cosa significa l'errore 130429?"
    a: "Meta definisce 130429 come throughput dei messaggi della Cloud API raggiunto, con il titolo Rate limit hit. L'azione suggerita è riprovare più tardi o ridurre la frequenza con cui l'app invia messaggi. Si risolve quando la vostra velocità di invio rientra nel livello consentito, quindi di norma bastano un limitatore di frequenza e un nuovo tentativo con backoff."
  - q: "Che cos'è il pair rate limit di WhatsApp?"
    a: "Limita quanti messaggi un numero aziendale può inviare allo stesso destinatario in un breve periodo. L'errore 131056 di Meta descrive troppi messaggi dal numero mittente allo stesso numero destinatario in poco tempo e consiglia di attendere e riprovare. La pagina di Meta sul throughput non indica alcun valore, quindi non fate affidamento su una cifra fissa."
  - q: "I limiti di messaggistica coincidono con il throughput?"
    a: "No. Il throughput è la velocità con cui potete inviare, in messaggi al secondo. Un limite di messaggistica è il numero di persone uniche con cui potete avviare conversazioni in 24 ore mobili. Potete rispettare un limite e superare l'altro. Per i livelli giornalieri leggete la nostra guida ai limiti di messaggistica, per la velocità questa."
  - q: "Come devo riprovare dopo un errore di rate limit di WhatsApp?"
    a: "Riprovate solo in caso di throttling ed errori temporanei del server, attendete di più dopo ogni tentativo, aggiungete un jitter casuale e ponete un tetto sia all'attesa sia ai tentativi. La pagina di Meta sul throughput non indica un backoff specifico per l'errore 130429, quindi è una prassi comune e non una regola di Meta. Registrate prima ogni invio, così un nuovo tentativo non spedisce mai due volte lo stesso messaggio."
sources: 
  - title: "Throughput — WhatsApp Business Platform, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput"
  - title: "Error codes — WhatsApp Business Platform, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes"
  - title: "Rate limiting — Graph API, Meta for Developers"
    url: "https://developers.facebook.com/docs/graph-api/overview/rate-limiting"
  - title: "Webhooks overview — WhatsApp Business Platform, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview"
---

# Throughput e rate limit della WhatsApp Cloud API spiegati

Canonical: https://omnichannels.ai/it/blog/whatsapp-api-throughput-rate-limits/
Language: it
Publisher: OmniChannels.ai by BroadNet Technologies

Questa guida è pensata per ingegneri e responsabili di campagna che pianificano grandi invii WhatsApp e vogliono sapere quanto velocemente possono andare e che cosa succede se vanno troppo veloci. Spiega i limiti documentati da Meta, come si aumenta il throughput, quali errori vedrete e come mettere in coda e riprovare un invio massivo in sicurezza.

I numeri sono i valori documentati da Meta al momento della stesura (7 novembre 2026). Meta può modificarli, quindi confermateli nelle fonti linkate prima di un lancio.

## Che cos'è il throughput della WhatsApp Cloud API?

Il throughput è il numero di messaggi al secondo che un singolo numero di telefono aziendale può gestire. La documentazione di Meta indica fino a 80 messaggi al secondo (mps) per impostazione predefinita e fino a 1.000 mps con aggiornamento automatico.

Dettagli dalla pagina di Meta sul throughput:

- Il tetto vale per ogni numero di telefono aziendale e conta i messaggi in entrata e in uscita di ogni tipo.
- I numeri usati sia con l'app WhatsApp Business sia con la Cloud API hanno un valore fisso di 20 mps.
- Potete leggere il livello attuale di un numero con `GET /<PHONE_NUMBER_ID>?fields=throughput`.

Il throughput riguarda la velocità, non il volume. Con quante persone uniche potete avviare conversazioni al giorno è invece un [limite di messaggistica](/it/blog/whatsapp-messaging-limits-quality-rating/) distinto.

## Come porto il throughput WhatsApp a 1.000 mps?

Meta aggiorna automaticamente e senza costi i numeri idonei quando sono soddisfatte tutte e tre le condizioni.

| Requisito | Dettaglio |
|---|---|
| Limite di messaggistica | Illimitato sul portfolio aziendale |
| Volume | 100.000 o più numeri utente WhatsApp unici contattati fuori dalle finestre di assistenza clienti in un periodo mobile di 24 ore |
| Qualità | Punteggio di qualità YELLOW (medio) o superiore |

L'aggiornamento può richiedere fino a 1 minuto e in quel tempo il numero non è utilizzabile. Meta lo segnala con un webhook `phone_number_quality_update` con l'evento `THROUGHPUT_UPGRADE`. Se inviate un messaggio mentre il numero è in fase di aggiornamento, viene restituito l'errore `131057`.

Nel processo documentato da Meta non potete acquistare un livello più alto né richiederlo con un modulo, quindi se non rispettate i requisiti pianificate l'invio sugli 80 mps. Chiedete al nostro team informazioni sul vostro account.

## Quali altri limiti WhatsApp si applicano?

Quattro limiti possono bloccare un invio. Sono indipendenti, quindi controllateli uno per uno.

| Limite | Che cosa limita | Errore tipico | Dove è definito |
|---|---|---|---|
| Throughput | Messaggi al secondo per numero | `130429` | Pagina Meta sul throughput |
| Pair rate limit | Messaggi da un numero allo stesso destinatario in poco tempo | `131056` | Codici di errore Meta |
| Limiti Graph API | Chiamate di gestione per app e account | `4`, `80007`, `80008` | Documentazione Meta sulla Graph API |
| Limite di messaggistica | Persone uniche raggiunte in 24 ore mobili | Restrizioni all'invio | [La nostra guida ai limiti](/it/blog/whatsapp-messaging-limits-quality-rating/) |

### Come funziona il pair rate limit?

Impedisce a un'azienda di inviare troppi messaggi a una stessa persona in tempi brevi. Meta descrive l'errore 131056 come troppi messaggi inviati dal numero di telefono mittente allo stesso numero di telefono destinatario in un breve periodo, e suggerisce di attendere e riprovare se intendete ancora inviare. La pagina di Meta sul throughput menziona il pair rate limit ma non indica alcun numero. Non codificatene uno nel software; evitate invece di mandare più messaggi di fila alla stessa persona e, quando possibile, accorpateli.

### Quali sono i rate limit della Graph API?

Si applicano alle chiamate di gestione, come la lettura di template o account, non all'invio dei messaggi. La documentazione Graph API di Meta indica, per la WhatsApp Business Management API, 200 chiamate all'ora per app per account WhatsApp Business per impostazione predefinita e 5.000 chiamate all'ora per app per un account attivo con almeno un numero di telefono collegato. Il limite si manifesta con l'errore `80008` per questa API, `4` per il limite dell'app, e la tabella degli errori di Meta riporta anche `80007` per il rate limit di un account WhatsApp Business.

Mettete in cache gli elenchi dei template e i dati degli account ed evitate il polling in un ciclo serrato.

## Quali codici di errore compaiono quando raggiungo un limite?

Abbinate il codice al limite, poi scegliete la risposta.

| Codice | Descrizione di Meta | Risposta |
|---|---|---|
| `130429` | Throughput dei messaggi della Cloud API raggiunto | Rallentare, poi riprovare |
| `131056` | Troppi messaggi dal mittente allo stesso destinatario in poco tempo | Attendere, riprovare solo se serve |
| `131057` | Numero usato durante un aggiornamento del throughput | Riprovare al termine dell'aggiornamento |
| `80007` | L'account WhatsApp Business ha raggiunto il suo rate limit | Ridurre le chiamate API, riprovare più tardi |
| `4` | L'app ha raggiunto il suo rate limit delle chiamate API | Ridurre le chiamate API, controllare l'App Dashboard |
| `131048` | Restrizioni sul numero di messaggi che il numero può inviare | Controllare lo stato di qualità in WhatsApp Manager |
| `131049` | Non consegnato per mantenere un coinvolgimento sano nell'ecosistema | Attendere almeno 24 ore prima di rinviare il template |

I codici `131048` e `131049` riguardano qualità e coinvolgimento, non la velocità, quindi riprovare più in fretta non aiuta. Vedi [risoluzione dei problemi dei codici di errore dell'API WhatsApp](/it/blog/whatsapp-api-error-codes-troubleshooting/).

Sull'API di OmniChannels.ai un rifiuto a monte arriva come HTTP `502` con il codice di errore e il testo di Meta in `message`, mentre il nostro rate limiting restituisce `429` con un header `Retry-After`. Consultate [errori e limiti](/developers/errors-and-limits/) per la tabella completa e i limiti predefiniti.

## Come metto in coda e riprovo?

Inserite una coda tra la vostra applicazione e l'API, limitate la frequenza sotto il vostro tetto e riprovate solo ciò che può riuscire più tardi.

1. **Mettete in coda ogni invio.** La vostra applicazione scrive i messaggi in una coda e un pool di worker la smaltisce. Non scorrete mai un elenco clienti in un'unica richiesta.
2. **Limitate la frequenza con un token bucket** impostato sotto il vostro throughput, lasciando spazio alle risposte e agli altri flussi che condividono lo stesso tetto.
3. **Registrate prima ogni tentativo.** Scrivete una riga per messaggio con un vostro ID operazione, salvate l'ID messaggio restituito e saltate ciò che è già stato accettato.
4. **Riprovate i guasti transitori.** Throttling ed errori temporanei del server si riprovano; errori di validazione (`400`), di autenticazione e dei template no.
5. **Backoff con jitter.** Attendete di più dopo ogni tentativo, aggiungete casualità perché i worker non riprovino insieme e ponete un tetto sia all'attesa sia al numero di tentativi.
6. **Rispettate `Retry-After`** quando la risposta lo include.
7. **Controllate prima di rinviare dopo un timeout.** Una risposta persa non significa un messaggio perso; guardate prima gli eventi di stato.

```js
const RETRYABLE = new Set([429, 500, 502, 503, 504]);

async function sendWithBackoff(send, { maxAttempts = 5, baseMs = 500, capMs = 30000 } = {}) {
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    const res = await send();
    if (res.ok) return res;
    if (!RETRYABLE.has(res.status) || attempt === maxAttempts) throw new Error(`failed: ${res.status}`);
    const wait = Math.random() * Math.min(capMs, baseMs * 2 ** (attempt - 1)); // full jitter
    await new Promise((r) => setTimeout(r, wait));
  }
}
```

La pagina di Meta sul throughput non indica una regola di backoff per l'errore 130429, quindi questa è normale prassi ingegneristica. Per un 502 che porta un codice di throttling di Meta, trattatelo come ripetibile; per qualsiasi altro codice a monte, leggete prima il messaggio. La nostra pagina [errori e limiti](/developers/errors-and-limits/) contiene la tabella completa dei nuovi tentativi e la protezione dagli invii duplicati.

## Come pianifico un invio massivo?

Calcolate durata, limiti e carico dei webhook prima di iniziare.

1. **Contate i destinatari unici** e confrontateli con il vostro limite di messaggistica. Partite dal [piano di crescita sicura](/it/blog/whatsapp-messaging-limits-quality-rating/) se l'elenco supera il vostro livello.
2. **Stimate la durata.** I messaggi divisi per il vostro throughput danno i secondi. In termini aritmetici, 100.000 messaggi a 80 al secondo richiedono 1.250 secondi, circa 21 minuti, se nient'altro usa il tetto.
3. **Riservate capacità.** Il tetto conta anche i messaggi in entrata, quindi lasciate margine per le risposte dei clienti durante l'invio.
4. **Dimensionate il server webhook.** Meta dice che i server webhook dovrebbero gestire il triplo del traffico di messaggi in uscita più il traffico in entrata previsto, con latenza mediana non superiore a 250 ms e meno dell'1% delle richieste oltre 1 secondo. Vedi la [guida ai webhook](/it/blog/whatsapp-webhooks-guide/).
5. **Controllate prima stato e qualità dei template** e scaglionate l'invio in lotti, così potete fermarvi se errori o blocchi aumentano. Vedi [invio massivo senza essere bannati](/it/blog/whatsapp-bulk-messaging-without-getting-banned/).
6. **Usate gli ID media** anziché i link quando inviate file in volume, come consiglia Meta. Vedi [tipi di media e limiti](/it/blog/whatsapp-media-messages-file-types-size-limits/).

Su OmniChannels.ai gli endpoint bulk accettano molti destinatari in una sola richiesta e un campo `delay` può regolare la consegna. Concordate in anticipo con il nostro team i piani per i picchi.

## Esempio pratico: una vendita flash a Dubai

"Marina Gadgets" (fittizia) pianifica un template per una vendita flash a 60.000 clienti con opt-in.

1. Il loro limite lo consente, quindi il vincolo non è il volume ma la velocità. A 80 mps, 60.000 messaggi richiedono 750 secondi.
2. Inviano in sei lotti da 10.000 con un limitatore a 60 mps, che lascia spazio alle risposte.
3. Un lotto mostra diversi errori `131056` per clienti che nello stesso minuto avevano ricevuto anche un aggiornamento sull'ordine. Ritardano quegli invii di qualche minuto.
4. Un worker riprova le richieste limitate con backoff e jitter, e nessun messaggio viene riprovato dopo aver ottenuto un ID.
5. L'endpoint webhook salva gli eventi e restituisce `200`, poi un worker aggiorna gli stati.
6. Dopo ogni lotto controllano errori e qualità del template prima di proseguire.

## Quali sono gli errori più comuni?

- **Confondere i limiti.** Throughput, pair, Graph API e limiti di messaggistica sono problemi diversi.
- **Riprovare subito**, il che tiene il numero al tetto e prolunga il problema.
- **Inviare al massimo del tetto**, così risposte e stati competono con la campagna.
- **Rinviare dopo un timeout** senza controllare lo stato, duplicando i messaggi.
- **Interrogare in ciclo gli endpoint Graph API** e raggiungere il limite orario.
- **Server webhook sottodimensionati** che restano indietro e provocano nuovi tentativi.
- **I limiti cambiano.** Questa guida riporta i valori di Meta al momento della stesura.

## Come vi aiuta OmniChannels.ai

BroadNet è un Business Solution Provider ufficiale di Meta, e OmniChannels.ai invia WhatsApp tramite un'unica API con endpoint bulk, un campo `delay` per la regolazione, pianificazione e stati di consegna in un unico formato di webhook normalizzato. I rivenditori ottengono webhook e credito separati per ogni sottoaccount. Pianificate i picchi con il nostro team e leggete la [documentazione dell'API WhatsApp](/developers/whatsapp/), [errori e limiti](/developers/errors-and-limits/) e la pagina [campagne](/it/platform/campaigns/).