LinkedIn
Instagram
Telegramma
Gmail
Prospettiva
Calendario di Google
Partecipare alla comunità Slack Indice dei contenuti
Limiti ed endpoint
Costruire con esso
API per gruppi WhatsApp - 2026
WhatsApp API di gruppo Nel 2026: cosa supporta Meta e cosa no
L'API dei gruppi WhatsApp di Meta è attiva sulla Cloud API, ma funziona solo per Account aziendali ufficiali, limita ogni gruppo a 8 partecipanti, e ha nessun endpoint per aggiungere qualcuno direttamente. Ecco cosa significa per un prodotto reale, endpoint per endpoint, più l'unica via che rimuove tutti e tre i limiti.
Impostazioni del gruppo API del cloud Onboarding Clienti Acme Gruppo
JD AS ML RK TN CW PB +1 8 / 8 partecipanti
È richiesto un Account Aziendale Ufficiale
Gruppo pieno: nessun endpoint per aggiungere un nono partecipante
API dei gruppi
L'API di WhatsApp supporta la messaggistica di gruppo?
Sì. La piattaforma WhatsApp Business espone ora un'API per i gruppi sulla Cloud API, consentendo a un numero aziendale di creare gruppi, inviare messaggi al loro interno e gestire l'appartenenza. Tre condizioni la limitano: l'azienda deve essere un Account Aziendale Ufficiale, ogni gruppo è limitato a 8 partecipanti, e c'è nessun endpoint per aggiungere un partecipante direttamente.
API per gruppi WhatsApp: supportate vs non supportate Verificato rispetto alla documentazione della Cloud API di Meta, agosto 2026
Supportato
Crea, elenca e aggiorna i gruppi su un numero aziendale Cloud API
Invia messaggi di testo, multimediali e con modelli in un gruppo
Genera e reimposta il link d'invito del gruppo
Approva o rifiuta le richieste di iscrizione in sospeso
Rimuovi un partecipante da un gruppo
Iscriviti a 4 eventi webhook specifici del gruppo
Non supportato
Aggiunta diretta di un partecipante: solo link di invito
Chiamate o videochiamate all'interno di un gruppo
Messaggi effimeri e file multimediali visualizzabili una sola volta
Modifica o eliminazione di un messaggio già inviato al gruppo
Nascondere l'elenco dei partecipanti come amministratore
Analisi delle prestazioni per modello per i messaggi di gruppo
Questa suddivisione segue la documentazione ufficiale dell'API Groups di Meta. Fonte: developers.facebook.com, API del gruppo WhatsApp, verificato ad agosto 2026. Il resto di questa guida copre ogni endpoint, cosa attiva il limite di 8 partecipanti e l'unica lacuna che nessuno dei documenti di Meta evidenzia direttamente: non c'è modo di aggiungere un partecipante a un gruppo.
Definizione
Cos'è l'API dei gruppi di WhatsApp?
Il API per gruppi di WhatsApp è il livello di messaggistica di gruppo che Meta ha aggiunto sopra la Cloud API della Piattaforma WhatsApp Business. Consente a un numero di telefono aziendale di creare gruppi, inviare messaggi al loro interno e gestire l'iscrizione tramite un set dedicato di endpoint, senza passare a un prodotto diverso.
Rimane uguale
Uguale
ID_NUMERO_DI_TELEFONO usato per la messaggistica 1:1Stessa configurazione di token di accesso e permessi a livello di app
Uguale
/messaggi endpoint da inviare in un gruppo Cosa c'è di nuovo
Un dedicato
/gruppi famiglia di endpoint: crea, elenca, aggiorna, eliminaEndpoint per i link di invito e le richieste di accesso
4 nuovi campi webhook per gli eventi del ciclo di vita del gruppo
Un numero che invia già messaggi 1:1 tramite il Guida alle API di WhatsApp non richiede una seconda integrazione per supportare i gruppi. Ha bisogno del permesso extra trattato di seguito e degli endpoint extra trattati più in basso in questa pagina.
Ammissibilità
Chi può utilizzare l'API dei Gruppi WhatsApp?
Solo un sottoinsieme di numeri della WhatsApp Business Platform è idoneo per le API dei gruppi di WhatsApp. Un'azienda deve gestire un Account aziendale ufficiale sulla Cloud API stessa prima che possa essere creato un singolo gruppo, e due tipi di numeri comuni sono esplicitamente esclusi.
Account Aziendale Ufficiale
Il numero deve avere lo status OBA di Meta, il livello verificato di WhatsApp Business Platform.
Live sulla Cloud API
Il numero deve essere in uso attivo sulla Cloud API, non sulla gratuita app WhatsApp Business.
Il
messaggistica_whatsapp_business permessoL'app connessa deve avere questa autorizzazione approvata prima che qualsiasi endpoint di gruppo risponda.
Abbonato al WABA giusto
L'applicazione deve essere associata all'account WhatsApp Business che possiede il numero.
Numeri sull'app WhatsApp Business
Escluso. L'API Groups è una funzionalità delle API Cloud, non qualcosa che l'applicazione Business rivolta ai consumatori espone.
Numeri in conversazioni a soluzione multipla
Escluso. I numeri condivisi tra più fornitori di soluzioni aziendali non possono utilizzare l'API Gruppi.
Documentazione introduttiva delle API Groups di Meta, verificata ad agosto 2026.
Limiti
Quanti partecipanti può avere un gruppo dell'API di WhatsApp?
Massimo 8 partecipanti per gruppo. Un singolo numero di attività può contenere fino a 10.000 gruppi, e solo un business di API Cloud può operare all'interno di un determinato gruppo alla volta.
Nell'API del gruppo WhatsApp, il numero aziendale che crea il gruppo occupa uno degli otto slot come partecipante, il che lascia spazio a clienti reali o membri del team anziché a tutti e otto. Per un prodotto che richiede un gruppo di onboarding, un canale di progetto o una cella di supporto con più di poche persone, quel limite viene raggiunto rapidamente.
Il limite di 8 partecipanti non è un bug tecnico. Riflette una scelta di design deliberata per la messaggistica aziendale strutturata anziché per la chat di comunità aperta, che è un caso d'uso sostanzialmente diverso da un gruppo WhatsApp personale. La questione pratica per un team di prodotto non è se 8 sia sufficiente in teoria, ma se il gruppo possa crescere oltre le prime 8 persone, a cui rispondono le prossime due sezioni.
Riferimento API
Quali endpoint espone l'API dei Gruppi WhatsApp?
L'API dei gruppi di WhatsApp aggiunge 12 endpoint in aggiunta alla Cloud API standard: creazione di gruppi, metadati, link di invito e richieste di partecipazione. Nessuno di essi aggiunge direttamente un partecipante.
Metodo
Percorso
Cosa fa
POSTA
//groups
Crea un nuovo gruppo e restituisce il suo primo link di invito
GET
//groups
Elenca ogni gruppo attivo collegato al numero aziendale
GET
/?campi=
Legge i metadati di un singolo gruppo: oggetto, descrizione, numero di partecipanti
POSTA
/
Aggiorna l'oggetto, la descrizione o la foto del gruppo
CANCELLARE
/
Elimina il gruppo e rimuove tutti i partecipanti in una volta sola
GET
//invite_link
Restituisce il link d'invito attuale del gruppo
POSTA
//invite_link
Ripristina il link di invito, invalidando ogni link condiviso in precedenza
GET
//join_requests
Elenca le richieste di iscrizione in attesa di approvazione
POSTA
//join_requests
Approva una o più richieste di iscrizione in sospeso
CANCELLARE
//join_requests
Rifiuta una o più richieste di iscrizione in sospeso
CANCELLARE
//participants
Rimuove uno o più partecipanti dal gruppo
POSTA
//messages
Invia un messaggio di testo, multimediale o un modello nel gruppo
Osserva attentamente ciò che manca: c'è un
DELETE /participants endpoint, e no POST /participants endpoint. Puoi rimuovere qualcuno da un gruppo dell'API di WhatsApp. Non puoi aggiungerlo allo stesso modo. La sezione successiva spiega esattamente cosa significa e cosa fare al riguardo. Il divario
Puoi aggiungere qualcuno a un gruppo WhatsApp con la Cloud API?
No. L'API del gruppo WhatsApp non dispone di un endpoint per aggiungere partecipanti. I partecipanti possono unirsi solo tramite un link di invito condiviso e l'azienda può quindi approvare o rifiutare la richiesta di iscrizione.
DELETE //participants rimuove le persone, non ne aggiunge nessuna.L'unico percorso d'entrata, dall'inizio alla fine
1
Crea il gruppo
POST /groups restituisce un group_id e un primo link di invito
2
Ottieni il link d'invito
GET o POST /invite_link, reimpostabile in qualsiasi momento
3
Invia il link
POST /messages, un modello 1:1 inviato al potenziale cliente
4
Chiedono di unirsi
Toccando il link viene creata una voce in join_requests
Tu approvi
POST /join_requests li conferma come partecipanti
# Fase 2: ottenere o reimpostare il link di invito del gruppo
ricciolo -X POSTA \ "https://graph.facebook.com/v21.0//invite_link" \ -H "Authorization: Bearer "
// 200 OK
{
"link di invito": "https://chat.whatsapp.com/"
}Questo è l'unico modo per entrare. Non esiste un'importazione massiva, nessun CSV di numeri di telefono, nessun endpoint che aggiunga un elenco di persone a un gruppo con una sola chiamata. Ogni persona deve toccare un link e attendere l'approvazione, una alla volta. Per una manciata di contatti VIP si tratta di un piccolo inconveniente. Per un flusso di prodotti ricorrente, per l'onboarding di ogni nuovo cliente in un gruppo dedicato, per la creazione del personale per un canale di progetto o di una cella di supporto per account, si tratta di un passaggio manuale che avviene al di fuori delle API per ogni singola persona, ogni volta.
Confrontalo con un API link WhatsApp utilizzato per l'outreach 1:1, dove la condivisione di un link è per design il punto di ingresso. All'interno di un gruppo, lo stesso meccanismo del link d'invito diventa l'unica porta disponibile, a prescindere dal fatto che si adatti o meno al reale flusso di onboarding del prodotto.
Un account WhatsApp collegato tramite Unipile non ha questa restrizione: lo stesso tipo di azione che rimuove un partecipante ha una controparte che ne aggiunge uno direttamente, per conto dell'utente autenticato. Tutti i dettagli, inclusi gli endpoint, sono più avanti in questa pagina in come accedere ai gruppi di WhatsApp dall'account di un utente.
Non supportato
Cosa non è supportato nei gruppi delle API di WhatsApp?
Sei tipi di messaggio, tre azioni di amministrazione e un'API non sono disponibili all'interno di un gruppo creato tramite l'API di WhatsApp per i gruppi, nonostante ciascuno di essi funzioni perfettamente in una normale conversazione 1:1 sullo stesso numero.
Categoria
Non disponibile
Tipi di messaggi
Chiamate, messaggi che scompaiono, file multimediali visualizzabili una sola volta, modelli di autenticazione, messaggi commerciali e messaggi interattivi
Azioni di amministrazione
Nascondere l'elenco dei partecipanti, modificare un messaggio già inviato al gruppo ed eliminare un messaggio già inviato al gruppo
API
L'API Calling non funziona all'interno di una conversazione di gruppo
Analisi
Nessuna metrica di performance per modello per i modelli utilizzati in un gruppo. Meta consiglia di mantenere i modelli di gruppo separati dai modelli 1:1 per questo motivo
Come fare
Come si invia un messaggio a un gruppo WhatsApp?
Usa lo stesso
POST //messages endpoint come messaggistica uno-a-uno, imposta tipo di destinatario a gruppo, e inserisci l'ID del gruppo in a. Non esiste un endpoint separato per i messaggi di gruppo.Messaggio di testo, curl
ricciolo -X POSTA \ "https://graph.facebook.com/v21.0//messages" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{
"messaging_product": "whatsapp",
"recipient_type": "group",
"to": "",
"type": "text",
"text": { "body": "Benvenuti nel canale del progetto." }
}'Messaggio modello, Node.js
const response = await fetch(
`https://graph.facebook.com/v21.0/${BUSINESS_PHONE_NUMBER_ID}/messages,
{
metodo: "POST",
intestazioni: {
Authorization: `Bearer ${TOKEN_DI_ACCESSO}`,
"Content-Type": "application/json",
},
corpo: JSON.stringify({
canale_di_messaggistica: "whatsapp",
tipo di destinatario: "gruppo",
a: ID_GRUPPO,
tipo: "modello",
modello: {
nome: "benvenuto",
lingua: { codice: "it_IT" },
},
}),
}
);I messaggi multimediali seguono uno schema identico: fare riferimento al media caricato, quindi inviarlo con
tipo_destinatario: "gruppo" allo stesso modo di un testo o di un modello. La consegna, la formattazione, i tentativi e i codici di errore seguono le stesse regole di qualsiasi altro messaggio della Cloud API, di gruppo o meno.Ciò che non cambia sull'API dei gruppi di WhatsApp: non vi è alcun limite di frequenza specifico per gruppo documentato separatamente dai limiti di messaggistica standard e nessun formato di messaggio specifico per gruppo. L'unico campo nuovo è
tipo di destinatario.Ganci web
Quali webhook si attivano sugli eventi dei gruppi di WhatsApp?
L'API del gruppo WhatsApp aggiunge quattro campi webhook per coprire l'attività dei gruppi, e tutti e quattro richiedono un abbonamento separato prima che qualsiasi evento di gruppo raggiunga il tuo endpoint. Nessuno di essi è coperto dal webhook dei messaggi standard che potresti già utilizzare per le chat 1:1.
Campo webhook
Si attiva quando
aggiornamento_ciclo_di_vita_del_gruppo
Un gruppo viene creato o eliminato sul numero aziendale
aggiornamento_partecipanti_gruppo
Modifiche all'iscrizione: una richiesta di adesione viene approvata o un partecipante viene rimosso
aggiornamento_impostazioni_gruppo
L'oggetto, la descrizione o la foto del gruppo sono stati modificati
aggiornamento_stato_gruppo
Lo stato generale del gruppo cambia sulla piattaforma
Nomi dei campi e requisiti di abbonamento secondo la documentazione introduttiva dell'API Groups di Meta, verificata ad agosto 2026. Vedi il riferimento completo del payload del webhook per le strutture di campo esatte.
Prezzi
Quanto costa la messaggistica di gruppo su WhatsApp?
Per messaggio, allo stesso modo di qualsiasi altra conversazione tramite Cloud API. Non esiste un listino prezzi separato né uno sconto per gruppi.
Il 1° luglio 2025 Meta ha trasferito l'intera piattaforma WhatsApp Business a una tariffazione per messaggio, sostituendo il precedente modello per conversazione. I messaggi di gruppo inviati tramite l'API di WhatsApp Group vengono fatturati allo stesso modo: ogni messaggio inviato a un gruppo viene conteggiato singolarmente, alla stessa tariffa per messaggio di un messaggio 1:1 nella stessa categoria, nello stesso paese.
Non è previsto uno sconto sul volume specifico per i gruppi e, come spiegato in precedenza in questa pagina, non esiste una dashboard delle prestazioni separata per i modelli utilizzati in un gruppo. Pianificare il budget per un caso d'uso incentrato sui gruppi significa considerare ogni messaggio di gruppo esattamente per quello che è sulla fattura: un messaggio in più rispetto alla tariffa standard per messaggio.
Per il listino prezzi completo relativo a tutte le categorie di conversazione e ai paesi, consultare il nostro Prezzi API di WhatsApp Business analisi.
Conti collegati
Come si accede ai gruppi WhatsApp dall'account di un utente?
Un account WhatsApp si connette tramite Unipile nello stesso modo in cui una persona userebbe WhatsApp Web: tramite Codice QR o codice di associazione, per conto dell'utente autenticato, con nessuna verifica Meta Business richiesto. Una volta collegati, i suoi gruppi sono chat standard, raggiungibili tramite gli stessi endpoint di chat e messaggistica di qualsiasi altra conversazione.
Unipile funge da intermediario tecnico indipendente tra un prodotto e WhatsApp: ogni chiamata qui sotto viene eseguita per conto dell'utente autenticato che ha collegato l'account, e non come un'integrazione permanente con WhatsApp o Meta.
Nota sulla gestione dei dati
Limitato alla sessione autenticata
I dati dei gruppi recuperati tramite un account WhatsApp collegato non vengono memorizzati in un sistema parallelo o conservati come archivio indipendente. L'accesso è limitato alla sessione del utente autenticato chi ha collegato l'account e ogni azione di richiesta per conto di quell'utente.
Limiti della piattaforma e uso responsabile
I limiti stessi di WhatsApp, trasmessi
Unipile applica i limiti di velocità nativi di WhatsApp sull'account collegato anziché imporne uno separato. La frequenza con cui viene inviato un messaggio a un gruppo e il numero di gruppi gestiti da un account rimangono un decisione lato cliente, effettuati entro i limiti di WhatsApp per quell'account.
Una volta collegato un account, i suoi gruppi compaiono insieme a qualsiasi altra chat. Il filtraggio su WhatsApp e la navigazione tra le pagine utilizzano lo stesso endpoint dell'elenco delle chat di qualsiasi altra conversazione:
Elenca ogni gruppo e chat di WhatsApp su un account collegato, curl
ricciolo -X GET \ ""https://.unipile.com:/api/v1/chats?account_type=WHATSAPP&account;_id=&limit;=50"" \ -H "X-API-KEY: " \ -H "accept: application/json"L'avvio di un nuovo gruppo funziona allo stesso modo dell'avvio di qualsiasi chat con più destinatari: passa più di una voce in
attendees_ids, formattato nello stesso modo in cui WhatsApp identifica i contatti internamente.Crea un nuovo gruppo WhatsApp, curl
ricciolo -X POSTA \ "https://.unipile.com:/api/v1/chats"" \ -H "X-API-KEY: " \ -F "account_id=" \ -F "attendees_ids[]=33600000001@s.whatsapp.net" \ -F "attendees_ids[]=33600000002@s.whatsapp.net" \ -F "attendees_ids[]=33600000003@s.whatsapp.net" \ -F "oggetto=Onboarding Cliente Acme" \ -F "Benvenuti nel gruppo"Il Node SDK espone la stessa interfaccia di chat per leggere chi è già in un gruppo:
Elenca i partecipanti di un gruppo, SDK per Node.js
import { UnipileClient } from "unipile-node-sdk";
const client = new UnipileClient(URL_DI_BASE, TOKEN_DI_ACCESSO);
const partecipanti = await client.messaging.tuttiIPartecipantiDallaChat(chat_id);Ecco dove un account collegato si differenzia dall'API dei gruppi di WhatsApp:
PATCH /chats/{chat_id} supporta un aggiungiPartecipante azione, insieme a rimuoviPartecipante e ottieniLinkInvito, sulle chat di WhatsApp e Telegram. L'aggiunta di qualcuno richiede che il proprietario dell'account disponga dell'autorizzazione "Aggiungi altri membri" del gruppo all'interno di WhatsApp stesso, la stessa autorizzazione che si applica se aggiungesse quella persona manualmente dal proprio telefono.Aggiungi, rimuovi o invita un partecipante, SDK per Node.js
// Aggiungi un partecipante (solo WhatsApp e Telegram)
await client.messaging.eseguiAzione({
chat_id,
azione: "aggiungiPartecipante",
valore: "33600000009@s.whatsapp.net",
});
// Rimuovi un partecipante
await client.messaging.eseguiAzione({
chat_id,
azione: "rimuoviPartecipante",
valore: "33600000009@s.whatsapp.net",
});
// Ottieni il link di invito del gruppo
const { link di invito } = await client.messaging.eseguiAzione({
chat_id,
azione: "ottieniLinkInvito",
});Non esiste un limite massimo pubblicato al numero di persone che un gruppo può contenere una volta gestito tramite un account collegato: il gruppo opera secondo le meccaniche native di WhatsApp sull'account collegato, non il limite di 8 partecipanti della Cloud API. Unipile non documenta né impone un limite di partecipanti separato oltre a esso.
Il riferimento completo dei parametri per queste tre azioni, incluso l'esatto formato dell'ID del provider per piattaforma, si trova in Unipile endpoint dell'azione della chat documentazione.
Decisione
API di gruppo o account collegato: quale si adatta al tuo prodotto?
Entrambi i percorsi, l'API del Gruppo WhatsApp e un account collegato, creano e inviano messaggi ai gruppi WhatsApp. Si adattano a prodotti diversi, quindi la scelta giusta dipende dal fatto che il caso d'uso possa tollerare o meno un limite di 8 partecipanti basato esclusivamente su inviti.
Requisito
API dei gruppi Meta
Account collegato
Requisito dell'account
Account aziendale ufficiale, su Cloud API
Account WhatsApp esistente, collegato tramite QR o codice di associazione
Numero massimo di partecipanti
8 per gruppo
Meccaniche di gruppo native di WhatsApp, nessun limite Unipile separato
Aggiungi un partecipante direttamente
Non disponibile: link di invito e solo approvazione
Disponibile, tramite l'azione addParticipant
Link di invito
Genera e reimposta tramite l'API
Genera tramite l'azione getInviteLink
Leggi la cronologia del gruppo esistente
Non fa parte dell'API: i messaggi arrivano tramite webhook man mano che si verificano
Sincronizzazione della cronologia completa ed endpoint dell'elenco dei messaggi
Elenco dei partecipanti
Solo conteggio dei partecipanti, tramite metadati del gruppo
Elenco completo dei partecipanti, una sola chiamata
Tipi di messaggi
Testo, file multimediale, testo del modello, file multimediale del modello
Testo, contenuti multimediali e tipi di messaggi nativi di WhatsApp
Ganci web
4 campi di gruppo dedicati, ciascuno un abbonamento separato
Webhook per chat e messaggi standard
Modello di fatturazione
Prezzo per messaggio della Cloud API standard per le conversazioni
Abbonamento Unipile, non fatturato per messaggio WhatsApp
Chi possiede la conversazione
L'azienda, in qualità di titolare dell'Account Business Ufficiale
L'utente finale, Unipile agisce per loro conto
API per Gruppi WhatsApp - FAQ
Risposte alle domande che la documentazione dell'API dei gruppi WhatsApp di Meta non spiega direttamente.
No. L'API dei gruppi WhatsApp è attiva sulla Cloud API della Piattaforma WhatsApp Business a partire dal 2026. La confusione deriva dal lato dell'ecosistema: diverse piattaforme di messaggistica di terze parti non hanno ancora implementato il supporto per i gruppi, e alcuni centri assistenza e richieste di funzionalità aperte descrivono ancora i gruppi delle API di WhatsApp come non supportati, anche se la documentazione ufficiale di Meta conferma il contrario.
No, non per l'API dei Gruppi di Meta: un Account Aziendale Ufficiale sulla Cloud API è richiesto, e i numeri presenti sull'app WhatsApp Business o nelle conversazioni multi-soluzione sono esclusi. A Account WhatsApp collegato tramite Unipile è un percorso diverso: si collega tramite codice QR o codice di associazione, per conto dell'utente autenticato, senza alcuna verifica Meta Business.
Massimo 8 partecipanti per gruppo sulle API dei Gruppi delle API Cloud e fino a 10.000 gruppi per numero aziendale. Un account WhatsApp collegato tramite Unipile segue le meccaniche dei gruppi native di WhatsApp sull'account collegato anziché tale limite.
Meta restituisce l'ID del gruppo quando il gruppo viene creato, tramite
POST //groups. Gli ID dei gruppi esistenti sono elencati con GET //groups. Su un account collegato, lo stesso ID appare come il chat_id restituito durante l'elenco delle chat o l'avvio di un nuovo gruppo.Dipende dal percorso. Le API Groups della Cloud API sono basate su webhook: i messaggi arrivano man mano che si verificano e non esiste un endpoint per recuperare la cronologia passata di un gruppo. Un account WhatsApp collegato tramite Unipile può recuperare i messaggi esistenti e risynchronizzare la cronologia completa di una conversazione per conto dell'utente autenticato.
No. Unipile è un intermediario tecnico indipendente e non affiliato con, approvato da o sponsorizzato da WhatsApp o Meta. Collega l'account WhatsApp personale dell'utente per suo conto e non opera come WhatsApp Business Solution Provider per l'API Cloud descritta in precedenza in questa pagina.
Avete ancora domande? Il nostro team è qui per aiutarvi.
IT 
EN 
FR 
ES 
DE 
BR 
NL 
PL 
TR