Il team di Periskope
La Groups API di WhatsApp (l'API per i gruppi) permette alle aziende di creare e gestire gruppi WhatsApp in modo programmatico tramite la WhatsApp Business Platform.
Per accedervi servono un Official Business Account (OBA) e un numero Cloud API compatibile. L'API ha anche limiti rigidi su dimensione dei gruppi, creazione, gestione dei partecipanti e messaggi.
In questa guida trovi requisiti di accesso alla Groups API, condizioni per l'OBA, limiti attuali, prezzi e cosa fare se l'API non fa al caso tuo.
In breve: la Groups API di WhatsApp in sintesi
Chi può usare l'API gruppi di WhatsApp?
Per usare la Groups API, la tua azienda deve avere un Official Business Account (OBA).
Attenzione però: avere un account Meta Business verificato, un nome visualizzato approvato o l'accesso alla WhatsApp Business Platform non ti rende automaticamente un OBA.
1. Cosa significa OBA?
Meta assegna lo stato di OBA alle aziende affermate e conosciute su WhatsApp. Nella valutazione per l'OBA contano, tra le altre cose:
La verifica dell'azienda
Un nome visualizzato approvato
La verifica in due passaggi sul numero di telefono
Da quanto tempo l'azienda è attiva sulla WhatsApp Business Platform
Se l'azienda ha una presenza autentica e riconoscibile
Avere i requisiti per l'OBA è una cosa diversa dal completare la semplice verifica dell'azienda.
2. Il badge OBA e lo stato reale nell'API
C'è un altro dettaglio da controllare se verifichi i requisiti tramite API.
WhatsApp espone più di un campo legato allo stato dell'account aziendale, tra cui is_official_business_account e oba_status. E non sempre dicono la stessa cosa.
Può capitare che un account risulti ufficiale in un campo mentre il suo oba_status non mostra uno stato OBA attivo.
Se stai costruendo un controllo automatico dei requisiti, non fidarti di un solo campo booleano. Controlla lo stato OBA effettivo restituito per l'azienda e verifica che numero e account rispettino i requisiti della Groups API.
È importante, perché altrimenti una dashboard o un'integrazione può mostrare un'azienda come «ufficiale» anche quando l'account non può ancora usare la Groups API.
3. Ti serve un numero Cloud API
La Groups API funziona con i numeri WhatsApp Cloud API.
Un numero che usa l'app WhatsApp Business non può usare la Groups API. E al momento Meta non supporta la Groups API con la modalità Coexistence (coesistenza).
Quindi, se un'azienda oggi gestisce il suo numero con l'app WhatsApp Business, non può semplicemente collegare la stessa configurazione alla Groups API. Il numero ha bisogno di una configurazione Cloud API compatibile.
Checklist rapida dei requisiti Prima di costruire qualcosa sulla Groups API, controlla questi punti:
|
|---|
Try Periskope
Gestisci gruppi, chat e numeri WhatsApp su larga scala
Limiti e restrizioni dell'API gruppi di WhatsApp
Una volta che la tua azienda ha i requisiti, la domanda successiva è se l'API si adatta davvero al tuo modo di lavorare.
1. Fino a 8 partecipanti per gruppo
Un gruppo creato con la Groups API supporta fino a 8 partecipanti, compreso il numero aziendale. Restano quindi al massimo 7 posti per gli altri.
Per questo l'API va bene per conversazioni piccole e mirate, non per grandi community di clienti.
Per esempio:
Un cliente con il team di assistenza
Un piccolo team di progetto
Un rivenditore con i suoi account manager
Un piccolo gruppo di clienti che sta facendo l'onboarding
Se ti serve un gruppo WhatsApp da 50 o 500 membri, questo limite esclude la Groups API.
2. Fino a 10.000 gruppi per numero aziendale
Un singolo numero aziendale WhatsApp API può creare fino a 10.000 gruppi tramite la Groups API.
Un'altra regola da sapere: un gruppo può appartenere a una sola azienda Cloud API. Due account aziendali diversi non possono condividere né gestire insieme lo stesso gruppo.
3. Si entra solo su invito
La Groups API non permette all'azienda di aggiungere direttamente i partecipanti a un gruppo.
Quando crei un gruppo, WhatsApp genera un link di invito. Puoi mandarlo alle persone che vuoi coinvolgere e, se preferisci controllare chi entra, puoi attivare l'approvazione delle richieste di adesione.
Per esempio, un'azienda può creare un gruppo per un nuovo cliente e mandargli il link di invito con un modello WhatsApp approvato.
4. Puoi fissare solo 3 messaggi
La Groups API supporta i messaggi fissati, fino a un massimo di 3 messaggi fissati per gruppo.
Se ne fissi un quarto, WhatsApp toglie in automatico il più vecchio. Ogni messaggio può restare fissato da 1 a 30 giorni.
5. La Groups API ha i suoi limiti di frequenza
Le operazioni della Groups API hanno limiti di frequenza propri. Se un numero esegue troppe operazioni sui gruppi in poco tempo, l'API può restituire l'errore 131208, Group Rate Limit Hit.
È un limite separato dalla capacità di invio generale della Cloud API. Anche con un throughput di messaggi alto, i limiti sulle operazioni della Groups API restano.
6. Meta può bloccare temporaneamente la creazione di gruppi
Meta può impedire per un periodo a un'azienda di creare nuovi gruppi se rileva troppi messaggi di marketing inviati dalla WABA dentro la finestra di assistenza clienti negli ultimi 7 giorni.
In questo caso compare l'errore 131214.
Se il tuo flusso di lavoro si basa molto sulla creazione di nuovi gruppi, è un limite da mettere in conto.
Quanto costa l'API gruppi di WhatsApp?
Con la normale tariffa della WhatsApp Cloud API paghi ogni messaggio consegnato alla persona a cui scrivi (dal 1° luglio 2025 Meta fattura per messaggio, non più per conversazione di 24 ore).
Una persona, un messaggio da pagare.
Con i gruppi funziona diversamente.
Quando invii un messaggio in un gruppo, WhatsApp lo fattura come una consegna separata a ogni persona del gruppo, non come un solo messaggio.
Quindi un aggiornamento inviato in un gruppo pieno da 8 persone (la tua azienda più altre 7) vale 7 consegne da pagare, non 1.
Esempio: un'azienda che invia 100 aggiornamenti al mese in un gruppo pieno da 8 persone non paga 100 messaggi. Paga fino a 700 consegne, la stessa spesa di 700 messaggi individuali 1:1.
Il costo cresce con il numero totale di persone raggiunte in tutti i tuoi gruppi, non con quante volte premi invio. Dal 1° ottobre 2026 si pagano anche i messaggi di servizio (le risposte libere dentro la finestra di 24 ore), oltre i primi 1.000 gratuiti per numero aziendale al mese, alla tariffa utility del mercato di riferimento. Scopri cosa è cambiato il 1° ottobre.
Cosa fare se non hai i requisiti o se i limiti ti stanno stretti
Se la tua azienda non ha ancora lo stato di OBA, usa l'app WhatsApp Business o lavora in modalità Coexistence, oggi la Groups API non è disponibile per te, per quanto solida sia il resto della tua configurazione.
E anche con l'OBA, il tetto di 8 partecipanti esclude tutto ciò che va oltre un gruppo piccolo e strutturato.
Un'escalation di assistenza con poche persone funziona. Una community, una classe di corsisti o un gruppo di clienti di dimensioni reali no.
Se hai già gruppi WhatsApp attivi, Periskope ti permette di gestirli su larga scala insieme al tuo team.
Collega normali numeri WhatsApp e WhatsApp Business tramite i dispositivi collegati di WhatsApp, così il team gestisce i gruppi e le chat che quei numeri usano già.
Porti quelle conversazioni in uno spazio di lavoro condiviso, assegni ticket e attività, smisti i messaggi alle persone del team, automatizzi i flussi e gestisci migliaia di gruppi WhatsApp da un unico posto.
È la soluzione giusta per le aziende che hanno già gruppi WhatsApp attivi e vogliono gestirli in team, invece di creare nuovi gruppi con la Groups API.
Per un confronto dettagliato tra i due approcci, leggi Gruppi WhatsApp normali vs API gruppi di WhatsApp.
Domande frequenti
1. Cosa significa avere un Official Business Account (OBA) su WhatsApp?
L'OBA è uno stato che Meta concede alle aziende affermate e conosciute sulla WhatsApp Business Platform.
Servono la verifica dell'azienda, un nome visualizzato approvato, la verifica in due passaggi e una certa storia sulla piattaforma, ma anche rispettando tutto questo l'OBA non è garantito.
2. Perché la mia azienda risulta verificata ma non riesce ad accedere alla Groups API?
La verifica dell'azienda e lo stato di OBA non sono la stessa cosa. Controlla direttamente il campo oba_status invece di fidarti di un badge, che può comparire con Meta Verified anche senza l'approvazione OBA completa.
3. Posso usare la Groups API di WhatsApp con l'app WhatsApp Business?
No. La Groups API richiede un normale numero Cloud API. Non è disponibile sui numeri dell'app Business né con la modalità Coexistence.
4. Per la Groups API servono 100.000 messaggi al giorno?
No. L'attuale documentazione di Meta sulla Groups API non indica una soglia di 100.000 messaggi come requisito a parte. Il requisito chiave per l'account aziendale è lo stato di OBA, insieme alla configurazione Cloud API richiesta.
5. Quanti gruppi può creare un numero WhatsApp aziendale?
Fino a 10.000 gruppi per numero aziendale.
6. Come si calcola il prezzo della Groups API di WhatsApp?
Per destinatario, non per messaggio inviato. Un messaggio in un gruppo da 8 persone vale fino a 7 consegne, non una.
7. Perché non posso aggiungere direttamente un partecipante a un gruppo della Groups API?
Non esiste un endpoint per aggiungere partecipanti. Si entra con un link di invito, che ogni persona deve accettare da sola.
8. Posso spostare un gruppo WhatsApp esistente sulla Groups API?
No. La Groups API serve a creare nuovi gruppi gestiti via API e non permette di importare un gruppo WhatsApp esistente o il suo elenco di membri. Se hai già gruppi WhatsApp attivi, Periskope li gestisce così come sono, senza nessuna migrazione.
Prova Periskope gratis e guarda come funziona sui tuoi gruppi.
