Genuka WA docs

Errore WhatsApp 80007: limite di frequenza dell'account raggiunto — soluzione

Errore WhatsApp 80007: il WhatsApp Business Account ha raggiunto il suo limite di chiamate API (200 o 5.000 all'ora). Quali chiamate contano, e come evitarlo.

L'errore WhatsApp 80007 significa che un'applicazione ha fatto troppe chiamate su uno stesso account WhatsApp Business nell'arco di un'ora: 200 per impostazione predefinita, 5.000 per un account attivo con un numero registrato. Le chiamate che contano sono quelle di gestione dell'account, come modelli e numeri di telefono, non gli invii di messaggi. Aspetta, poi chiama meno spesso.

Cosa significa l'errore 80007?

Meta lo elenca tra gli errori di limitazione:

"The WhatsApp Business Account has reached its rate limit." — Meta, Cloud API error codes

Soluzione suggerita: consultare i limiti di frequenza dell'account WhatsApp Business, poi "try again later or reduce the frequency or amount of API queries the app is making".

Quei limiti sono descritti nella panoramica della piattaforma: le richieste di un'app su un account vengono contate su un'ora mobile, a 200 all'ora, per app, per account per impostazione predefinita, e a 5.000 all'ora per un account attivo con almeno un numero di telefono registrato (Meta, About the platform). Coprono questi endpoint:

RichiestaEndpoint
GET/{WABA_ID}
GET, POST, DELETE/{WABA_ID}/assigned_users
GET/{WABA_ID}/phone_numbers
GET, POST, DELETE/{WABA_ID}/message_templates
GET, POST, DELETE/{WABA_ID}/subscribed_apps
GET/{WABA_TO_NUMBER_CURRENT_STATUS_ID}

La pagina generale sui limiti di frequenza della Graph API collega inoltre il codice 80008 al tipo di limite "WhatsApp Business Management API". Gestiscili entrambi allo stesso modo (Meta, Rate limits).

Quando si verifica l'errore 80007?

  • Polling dei modelli. Rileggere l'elenco dei modelli ogni minuto per vedere se uno è stato approvato costa 60 chiamate all'ora su quell'account, prima di qualsiasi altra cosa.
  • Creazione di modelli in massa. Uno script che invia, elimina e ricrea decine di modelli uno dopo l'altro.
  • Un account non ancora attivo. Finché non vi è registrato un numero, l'account resta a 200 chiamate all'ora.

Dove lo vedi in Genuka WA?

Il limite viene contato per applicazione e per account WhatsApp. Con Genuka WA l'applicazione è quella di Genuka: tutte le chiamate fatte sull'account di un cliente si sommano, che vengano dal tuo codice, dalla dashboard o dal portale cliente. In compenso, l'account di un cliente non consuma mai il limite di un altro cliente.

Dal lato di Genuka WA, queste chiamate passano di qui:

Endpoint di Genuka WAChiamata Meta conteggiata
POST /api/v1/templatesPOST /{WABA_ID}/message_templates
DELETE /api/v1/templates/{id}DELETE /{WABA_ID}/message_templates
POST /api/v1/templates/sync, GET /api/v1/templates?sync=trueGET /{WABA_ID}/message_templates, una volta per ogni account WhatsApp coperto

Genuka colloca il codice 80007 nella classe retryable. Una creazione di modello rifiutata torna come 422 meta_rejected con meta.retryable: true, oppure come 502 se Meta ha risposto con un 429 o un 5xx. Un aggiornamento resta un 200 finché almeno un account ha risposto: l'account limitato mostra "ok": false con il motivo di Meta in error. Se tutti gli account hanno rifiutato, la risposta è un 502 meta_rejected.

Un 502 ti arriva senza corpo JSON: la nostra CDN lo sostituisce con la sola riga error code: 502 (riferimento API). Leggi lo stato HTTP prima del corpo, e tratta questo caso come un errore temporaneo.

Come risolvo l'errore 80007?

Smetti di chiedere ciò che arriva da solo. La revisione di un modello arriva via webhook, come evento message_template_status_update (Webhook). Iscrivi un endpoint a quell'evento ed elimina il ciclo di lettura.

Riserva l'aggiornamento alle riparazioni. POST /api/v1/templates/sync esiste per recuperare un webhook perso: una volta all'ora è più che sufficiente, e companyId o connectionId lo restringono all'unico account interessato (riferimento API).

Riprova più tardi ciò che è stato rifiutato. Una creazione di modello segnata come retryable può essere inviata di nuovo dopo un'attesa; il limite si libera man mano che l'ora mobile avanza.

Distribuisci nel tempo la creazione in massa. Invia i modelli di un nuovo cliente in piccoli lotti invece che in un'unica raffica.

Se chiami tu stesso la Graph API, l'header X-Business-Use-Case-Usage indica la quota di chiamate utilizzata (call_count) e, una volta limitato, estimated_time_to_regain_access, il numero di minuti prima che tutto torni alla normalità (Meta, Rate limits).

// Un aggiornamento all'ora, ristretto a un cliente, segnalando gli account che hanno fallito.
const response = await fetch("https://wa.genuka.com/api/v1/templates/sync", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ companyId: "cmp_1" }),
});
// Un 502 arriva senza JSON: la nostra CDN lo sostituisce con "error code: 502".
const json = await response.json().catch(() => null);

if (!response.ok) {
  console.error("Nessun account ha risposto", response.status, json?.message ?? "");
} else {
  for (const waba of json.data.wabas.filter((w: { ok: boolean }) => !w.ok)) {
    console.warn("Account non aggiornato, riprova tra un'ora", waba.wabaId, waba.error);
  }
}

Come prevengo l'errore 80007?

  • Prima i webhook. Lo stato di un modello, un cambiamento di qualità o un aggiornamento dell'account ti raggiungono senza che tu debba chiederli.
  • Un aggiornamento programmato, non uno scatenato dalle visite alla pagina. Una dashboard che rilegge Meta a ogni apertura moltiplica le chiamate per il numero di visitatori.
  • Collega il numero prima di creare i modelli. Un account attivo con un numero registrato ha 5.000 chiamate all'ora invece di 200.

Codici di errore correlati

  • 4: il limite di chiamate dell'intera applicazione.
  • 130429: il throughput di messaggi di un numero.
  • 80008: il codice che la pagina sui limiti di frequenza della Graph API collega alla WhatsApp Business Management API.

FAQ

Perché il mio account è limitato a 200 chiamate all'ora invece di 5.000?

Meta riserva le 5.000 chiamate all'ora agli account attivi con almeno un numero registrato. Un account creato senza numero, o il cui numero non è ancora registrato, resta a 200.

Gli invii di messaggi contano per questo limite?

Gli endpoint che Meta elenca per questo limite sono quelli di gestione dell'account, non gli invii. Gli invii hanno i loro tetti, tra cui il throughput per numero, codice 130429.

L'account di un cliente può esaurire il limite di un altro?

No. Il limite viene contato per applicazione e per account WhatsApp: ogni account ha il suo.

Fonti

In questa pagina