LinkedIn
Instagram
Telegram
Gmail
Outlook
Google Agenda
Rejoindre la communauté Slack Table des matières
La réponse
Limites et points de terminaison
Construire avec
API de groupe WhatsApp - 2026
WhatsApp API de groupe En 2026 : ce que Meta prend en charge et ce qu'il ne prend pas en charge
L'API des groupes WhatsApp de Meta est disponible sur l'API Cloud, mais elle ne fonctionne que pour Comptes professionnels officiels, plafonne chaque groupe à 8 participants, et a aucun point de terminaison pour ajouter quelqu'un directement. Voici ce que cela signifie pour un vrai produit, point de terminaison par point de terminaison, ainsi que l'unique voie qui supprime ces trois limites.
Paramètres du groupe API dans le nuage Intégration des clients Acme Groupe
JD AS ML RK TN CW PB +1 8 / 8 participants
Compte professionnel requis
Groupe complet : aucun point de terminaison pour ajouter un 9e participant
API Groupes
L'API WhatsApp prend-elle en charge la messagerie de groupe ?
Oui. La plateforme WhatsApp Business propose désormais une API Groupes sur l'API Cloud, de sorte qu'un numéro professionnel peut créer des groupes, y envoyer des messages et gérer les membres. Trois conditions y donnent accès : l'entreprise doit être une Compte professionnel officiel, chaque groupe est limité à 8 participants, et il y a aucun point de terminaison pour ajouter un participant directement.
API de groupe WhatsApp : pris en charge vs non pris en charge Vérifié par rapport à la documentation de l'API Cloud de Meta, août 2026
Soutenu
Créer, lister et mettre à jour des groupes sur un numéro professionnel Cloud API
Envoyer des messages texte, multimédia et de type modèle dans un groupe
Générer et réinitialiser le lien d'invitation du groupe
Approuver ou rejeter les demandes d'adhésion en attente
Retirer un participant d'un groupe
S'abonner à 4 événements webhook spécifiques à un groupe
Non pris en charge
Ajouter un participant directement : lien d'invitation uniquement
Appel vocal ou vidéo au sein d'un groupe
Messages éphémères et médias visibles une seule fois
Modifier ou supprimer un message déjà envoyé au groupe
Masquer la liste des participants en tant qu'administrateur
Analyses de performance par modèle pour les messages de groupe
Cette ventilation suit la propre documentation de l'API Groupes de Meta. Source : developers.facebook.com, API de groupe WhatsApp, vérifié en août 2026. Le reste de ce guide couvre chaque point de terminaison, ce qui déclenche le mur des 8 participants, et la seule lacune qu'aucune des documentations de Meta ne mentionne directement : il n'y a aucun moyen d'ajouter un participant à un groupe.
Définition
Qu'est-ce que l'API des groupes WhatsApp ?
Le API des groupes WhatsApp la couche de messagerie de groupe que Meta a ajoutée par-dessus l'API Cloud de la plateforme WhatsApp Business. Elle permet à un numéro de téléphone professionnel de créer des groupes, d'y envoyer des messages et d'en gérer les membres via un ensemble dédié de points de terminaison, sans avoir à migrer vers un autre produit.
Reste inchangé
Pareil
ID_NUMÉRO_DE_TÉLÉPHONE utilisé pour la messagerie 1:1Même configuration de jeton d'accès et d'autorisations au niveau de l'application
Pareil
/messages point de terminaison pour envoyer dans un groupe Quoi de neuf
Dédié
/groupes famille de points de terminaison : créer, lister, mettre à jour, supprimerPoints de terminaison pour les liens d'invitation et les demandes d'adhésion
4 nouveaux champs de webhook pour les événements du cycle de vie des groupes
Un numéro qui envoie déjà des messages 1:1 via Guide de l'API WhatsApp n'a pas besoin d'une seconde intégration pour prendre en charge les groupes. Elle nécessite l'autorisation supplémentaire traitée ensuite, et les points de terminaison supplémentaires traités plus bas sur cette page.
Éligibilité
Qui peut utiliser l'API des groupes WhatsApp ?
Seul un sous-ensemble de numéros de la plateforme WhatsApp Business est éligible à l'API des groupes WhatsApp. Une entreprise doit exécuter un Compte Professionnel Officiel sur l'API Cloud elle-même avant qu'un seul groupe ne puisse être créé, et deux types de nombres courants sont explicitement exclus.
Compte professionnel officiel
Le numéro doit bénéficier du statut OBA de Meta, le niveau vérifié de la plateforme WhatsApp Business.
API Live sur le Cloud
Le numéro doit être utilisé activement sur l'API Cloud et non sur l'application gratuite WhatsApp Business.
Le
messagerie_whatsapp_business permissionL'application connectée doit avoir cette autorisation approuvée avant qu'un quelconque point de terminaison de groupe ne réponde.
Abonné au bon WABA
L'application doit être abonnée au compte WhatsApp Business qui possède le numéro.
Numéros sur l'application WhatsApp Business
Exclu. L'API Groupes est une fonctionnalité de l'API Cloud, et non quelque chose que l'application grand public Business expose.
Nombres dans les conversations à solutions multiples
Exclu. Les numéros partagés entre plusieurs fournisseurs de solutions professionnelles ne peuvent pas utiliser l'API Groupes.
Documentation de démarrage de l'API Groups de Meta, vérifiée en août 2026.
Limites
Combien de participants un groupe WhatsApp API peut-il compter ?
8 participants maximum par groupe. Un seul numéro d'entreprise peut détenir jusqu'à 10 000 groupes, et seulement une entreprise Cloud API peut fonctionner au sein d'un groupe donné à la fois.
Sur l'API du groupe WhatsApp, le numéro professionnel qui crée le groupe occupe l'une des huit places en tant que participant lui-même, ce qui laisse de la place pour de vrais clients ou coéquipiers plutôt que pour les huit complets. Pour un produit qui a besoin d'un groupe d'accueil, d'un canal de projet ou d'une cellule de support avec plus d'une poignée de personnes, ce plafond est atteint rapidement.
La limite de 8 participants n'est pas un bogue technique. Elle reflète un choix de conception délibéré pour la messagerie professionnelle structurée plutôt que pour le chat communautaire ouvert, ce qui constitue un cas d'utilisation fondamentalement différent de celui d'un groupe WhatsApp personnel. La question pratique pour une équipe produit n'est pas de savoir si 8 est suffisant en théorie, mais si le groupe peut dépasser ses 8 premiers membres, ce à quoi répondent les deux sections suivantes.
Référence API
Quels points de terminaison l'API des groupes WhatsApp expose-t-elle ?
L'API des groupes WhatsApp ajoute 12 points de terminaison en plus de l'API Cloud standard : la création de groupes, les métadonnées, le lien d'invitation et les demandes d'adhésion. Aucune d'elles n'ajoute directement de participant.
Méthode
Chemin
Ce qu'il fait
POST
//groups
Crée un nouveau groupe et renvoie son premier lien d'invitation
GET
//groups
Répertorie tous les groupes actifs liés au numéro d'entreprise
GET
/?champs=
Lit les métadonnées d'un seul groupe : sujet, description, nombre de participants
POST
/
Modifie le sujet, la description ou la photo du groupe
DELETE
/
Supprime le groupe et retire tous les participants en une seule fois
GET
//invite_link
Renvoie le lien d'invitation actuel du groupe
POST
//invite_link
Réinitialise le lien d'invitation, ce qui invalide tous les liens partagés auparavant
GET
//join_requests
Liste les demandes d'adhésion en attente d'approbation
POST
//join_requests
Approuve une ou plusieurs demandes d'adhésion en attente
DELETE
//join_requests
Rejette une ou plusieurs demandes d'adhésion en attente
DELETE
//participants
Retire un ou plusieurs participants du groupe
POST
//messages
Envoie un message texte, multimédia ou un modèle dans le groupe
Regardez bien ce qui manque : il y a un
SUPPRIMER /participants point de terminaison, et non POST /participants point final. Vous pouvez retirer quelqu'un d'un groupe de l'API WhatsApp. Vous ne pouvez pas l'y ajouter de la même manière. La section suivante explique exactement ce que cela signifie et ce qu'il faut faire à ce sujet. L'écart
Pouvez-vous ajouter quelqu'un à un groupe WhatsApp avec l'API Cloud ?
Non. L'API des groupes WhatsApp ne dispose pas de point de terminaison pour ajouter des participants. Les participants ne peuvent rejoindre le groupe que via un lien d'invitation partagé, et l'entreprise peut ensuite approuver ou rejeter la demande d'adhésion.
SUPPRIMER //participants supprime des personnes, rien n'en ajoute.Le seul chemin d'accès, du début à la fin
1
Créer le groupe
POST /groups renvoie un group_id et un premier lien d'invitation
2
Obtenir le lien d'invitation
GET ou POST /invite_link, réinitialisable à tout moment
3
Envoyez le lien
POST /messages, un modèle 1:1 envoyé au prospect
4
Ils demandent à rejoindre
Le fait de toucher le lien crée une entrée join_requests
Vous approuvez
POST /join_requests les confirme en tant que participant
# Étape 2 : obtenir ou réinitialiser le lien d'invitation du groupe
curl -X POST \ "https://graph.facebook.com/v21.0//invite_link" \ -H "Authorization : Bearer "
// 200 OK
{
"lien d'invitation": "https://chat.whatsapp.com/"
}C'est la seule façon d'entrer. Il n'y a pas d'importation en masse, pas de CSV de numéros de téléphone, pas de point de terminaison qui ajoute une liste de personnes à un groupe en un seul appel. Chaque personne doit appuyer sur un lien et attendre l'approbation, une par une. Pour une poignée de contacts VIP, c'est un mineur inconvénient. Pour un flux de produits récurrent, l'intégration de chaque nouveau client dans un groupe dédié, la dotation en personnel d'un canal de projet, la construction d'une cellule de support par compte, c'est une étape manuelle qui se produit en dehors de l'API pour chaque personne, à chaque fois.
Comparez cela à un API de lien WhatsApp utilisé pour la prospection 1:1, où le partage d'un lien constitue par conception le point d'entrée. Au sein d'un groupe, ce même mécanisme de lien d'invitation devient la seule porte disponible, qu'il corresponde ou non au parcours d'intégration réel du produit.
Un compte WhatsApp lié via Unipile ne comporte pas cette restriction : le même type d'action qui supprime un participant en a un équivalent qui en ajoute un directement, au nom de l'utilisateur authentifié. Tous les détails, y compris les points de terminaison, se trouvent plus bas sur cette page dans comment accéder aux groupes WhatsApp depuis le propre compte d'un utilisateur.
Non pris en charge
Qu'est-ce qui n'est pas pris en charge dans les groupes de l'API WhatsApp ?
Six types de messages, trois actions d'administration et une API sont indisponibles dans un groupe créé via l'API WhatsApp Group, alors que chacun d'eux fonctionne parfaitement dans une conversation 1:1 classique sur le même numéro.
Type
Non disponible
Types de messages
Appels, messages éphémères, médias visibles une seule fois, modèles d'authentification, messages commerciaux et messages interactifs
Actions d'administration
Masquer la liste des participants, modifier un message déjà envoyé au groupe et supprimer un message déjà envoyé au groupe
API
L'API Calling ne fonctionne pas dans une conversation de groupe
Analyse
Aucune mesure de performance par modèle n'est disponible pour les modèles utilisés dans un groupe. Meta recommande de séparer les modèles de groupe des modèles 1:1 pour cette raison.
Mode d'emploi
Comment envoyer un message à un groupe WhatsApp ?
Utilisez le même
POST //messages point de terminaison comme messagerie un à un, ensemble type_de_destinataire à centraliser, et mettez l'ID du groupe dans à. Il n'y a pas de point de terminaison distinct pour les messages de groupe.Message texte, curl
curl -X POST \ "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": "Bienvenue sur le canal du projet." }
}'Message de modèle, Node.js
const response = await fetch(
`https://graph.facebook.com/v21.0/${ID_NUMERO_DE_TELEPHONE_PROFESSIONNEL}/messages`,
{
méthode: "POST",
en-têtes: {
Authorization: `Bearer ${JETON_ACCÈS}`,
"Content-Type": "application/json",
},
corps: JSON.stringify({
produit_de_messagerie: "whatsapp",
type_de_destinataire: "groupe",
à: ID_GROUPE,
type: "modèle",
modèle: {
nom: "Bienvenue",
langue: { code: "en_US" },
},
}),
}
);Les messages multimédias suivent le modèle identique : faire référence au média téléchargé, puis l'envoyer avec
recipient_type: "group" de la même manière que du texte ou un modèle. La livraison, le formatage, les nouvelles tentatives et les codes d'erreur suivent tous les mêmes règles que n'importe quel autre message d'API Cloud, qu'il s'agisse ou non d'un groupe.Ce qui ne change pas sur l'API des groupes WhatsApp : il n'y a pas de limite de débit spécifique aux groupes documentée séparément des limites de messagerie standard, et aucun format de message spécifique aux groupes. Le seul nouveau champ est
type_de_destinataire.Webhooks
Quels webhooks se déclenchent lors d'événements de groupe WhatsApp ?
L'API du groupe WhatsApp ajoute quatre nouveaux champs de webhook pour couvrir l'activité des groupes, et tous les quatre nécessitent un abonnement séparé avant que tout événement de groupe n'atteigne votre point de terminaison. Aucun d'entre eux n'est couvert par le webhook de message standard que vous utilisez peut-être déjà pour les chats 1:1.
Champ de webhook
Se déclenche lorsque
mise_a_jour_cycle_de_vie_du_groupe
Un groupe est créé ou supprimé sur le numéro d'entreprise
mise_à_jour_des_participants_du_groupe
Modifications des adhésions : une demande d'adhésion est approuvée ou un participant est retiré
mise_à_jour_paramètres_groupe
Le sujet, la description ou la photo du groupe a été modifié
mise_a_jour_statut_groupe
Le statut général du groupe change sur la plateforme
Noms des champs et exigences d'abonnement selon la documentation de prise en main de l'API Groups de Meta, vérifiée en août 2026. Voir le référence complète de la charge utile du webhook pour les structures de champs exactes.
Tarifs
Combien coûte la messagerie de groupe WhatsApp ?
Par message, de la même manière que n'importe quelle autre conversation d'API Cloud. Il n'y a pas de grille tarifaire séparée et pas de remise de groupe.
Meta a basculé l'ensemble de la plateforme WhatsApp Business vers une tarification par message le 1er juillet 2025, remplaçant l'ancien modèle par conversation. Les messages de groupe envoyés via l'API WhatsApp Group sont facturés de la même manière : chaque message envoyé dans un groupe compte individuellement, au même tarif par message qu'un message individuel (1:1) dans la même catégorie et dans le même pays.
Il n'y a pas de rabais sur volume spécifique aux groupes et, comme indiqué plus haut sur cette page, aucun tableau de bord de performance distinct pour les modèles utilisés dans un groupe. Budgétiser un cas d'utilisation fortement axé sur les groupes signifie traiter chaque message de groupe exactement pour ce qu'il est sur la facture : un message de plus facturé au tarif standard par message.
Pour consulter la grille tarifaire complète par catégorie de conversation et par pays, voir notre Prix de l'API WhatsApp Business répartition.
Comptes liés
Comment accéder aux groupes WhatsApp depuis le propre compte d'un utilisateur ?
Un compte WhatsApp se connecte via Unipile de la même manière qu'une personne utiliserait WhatsApp Web : en Code QR ou code d'association, au nom de l'utilisateur authentifié, avec pas de vérification Meta Business requis. Une fois lié, ses groupes sont des chats standard, accessibles via les mêmes points de terminaison de chat et de messagerie que n'importe quelle autre conversation.
Unipile agit comme un intermédiaire technique indépendant entre un produit et WhatsApp : chaque appel ci-dessous s'exécute au nom de l'utilisateur authentifié qui a lié le compte, et non en tant qu'intégration permanente avec WhatsApp ou Meta.
Note sur le traitement des données
Limité à la session authentifiée
Les données de groupe récupérées via un compte WhatsApp lié ne sont pas stockées dans un système parallèle ni conservées en tant d'archive indépendante. L'accès est limité à la session du utilisateur authentifié qui a lié le compte, et toutes les actions de requête au nom de cet utilisateur.
Limites de la plateforme et utilisation responsable
Les propres limites de WhatsApp, relayées
Unipile relaie les propres limites de débit natives de WhatsApp sur le compte lié plutôt que d'en imposer une distincte. La fréquence à laquelle un message est envoyé à un groupe, et le nombre de groupes gérés par un compte, restent des décision côté client, effectués dans les limites de WhatsApp pour ce compte.
Une fois qu'un compte est associé, ses groupes apparaissent aux côtés de tous les autres chats. Le filtrage sur WhatsApp et la navigation par pages utilisent le même point de terminaison de liste de discussions que n'importe quelle autre conversation :
Lister tous les groupes et discussions WhatsApp sur un compte lié, curl
curl -X GET \ " https://.unipile.com:/api/v1/chats?account_type=WHATSAPP&account;_id=&limit;=50 "" \ -H "X-API-KEY: " \ -H "accept: application/json"Créer un nouveau groupe fonctionne de la même manière que pour n'importe quel chat à plusieurs destinataires : transmettez plus d'une entrée dans
attendees_ids, formaté de la même manière que WhatsApp identifie les contacts en interne.Démarrer un nouveau groupe WhatsApp, curl
curl -X POST \ " 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 "objet=Intégration du client Acme" \ -F "Bienvenue dans le groupe"Le SDK Node expose la même interface de chat pour voir qui est déjà dans un groupe :
Lister les participants d'un groupe, SDK Node.js
import { UnipileClient } from "unipile-node-sdk";
const client = new UnipileClient(BASE_URL, JETON_ACCÈS);
const participants = await client.messaging.obtenirTousLesParticipantsDuChat(chat_id);C'est là qu'un compte lié diffère de l'API des groupes WhatsApp :
PATCH /chats/{chat_id} prend en charge un ajouterUnParticipant action, aux côtés supprimerLeParticipant et obtenirLienInvitation, sur les discussions WhatsApp et Telegram. L'ajout d'une personne nécessite que le propriétaire du compte dispose de l'autorisation " Ajouter d'autres membres " du groupe dans WhatsApp même, la même autorisation qui s'appliquerait s'il ajoutait cette personne manuellement depuis son téléphone.Ajouter, supprimer ou inviter un participant, SDK Node.js
// Ajouter un participant (WhatsApp et Telegram uniquement)
await client.messaging.exécuterAction({
chat_id,
action: "ajouterUnParticipant",
valeur: "33600000009@s.whatsapp.net",
});
// Supprimer un participant
await client.messaging.exécuterAction({
chat_id,
action: "supprimerLeParticipant",
valeur: "33600000009@s.whatsapp.net",
});
// Obtenir le lien d'invitation du groupe
const { lien d'invitation } = await client.messaging.exécuterAction({
chat_id,
action: "obtenirLienInvitation",
});Il n'y a pas de limite publiée quant au nombre de personnes qu'un groupe peut contenir une fois qu'il est géré via un compte associé : le groupe fonctionne selon les mécanismes natifs de WhatsApp sur le compte lié, et non pas la limite de 8 participants de l'API Cloud. Unipile ne documente ni n'impose de limite distincte sur le nombre de participants en plus de celle-ci.
La référence complète des paramètres pour ces trois actions, incluant le format exact de l'ID du fournisseur par plateforme, se trouve dans l'Unipile point de terminaison d'action de chat la documentation.
Décision
API Groupes ou compte lié : lequel convient à votre produit ?
Les deux chemins, l'API des groupes WhatsApp et un compte lié, permettent de créer et d'envoyer des messages à des groupes WhatsApp. Ils conviennent à des produits différents, le bon choix dépend donc de la possibilité ou non pour le cas d'utilisation de s'accommoder d'une limite de 8 participants sur invitation uniquement.
Exigence
API Groupes Meta
Compte lié
Exigence relative au compte
Compte professionnel officiel, sur l'API Cloud
Compte WhatsApp existant, lié par QR code ou code d'association
Nombre maximal de participants
8 par groupe
Mécanismes de groupe natifs de WhatsApp, pas de limite Unipile séparée
Ajouter un participant directement
Non disponible : lien d'invitation et approbation uniquement
Disponible, via l'action addParticipant
Lien d'invitation
Générer et réinitialiser via l'API
Générer via l'action getInviteLink
Lire l'historique du groupe existant
Ne fait pas partie de l'API : les messages arrivent par webhook au fur et à mesure qu'ils se produisent
Synchronisation complète de l'historique et points de terminaison de la liste des messages
Liste des participants
Nombre de participants uniquement, via les métadonnées du groupe
Liste complète des participants, un seul appel
Types de messages
Texte, média, texte de modèle, média de modèle
Texte, médias et types de messages natifs de WhatsApp
Webhooks
4 champs de groupe dédiés, chacun étant un abonnement séparé
Webhooks de chat et de messages standard
Modèle de facturation
Par message, tarification standard des conversations de l'API Cloud
Abonnement Unipile, non facturé par message WhatsApp
À qui appartient la conversation
L'entreprise, en tant que titulaire du Compte Professionnel Officiel
L'utilisateur final, Unipile agit en leur nom
API de groupe WhatsApp - FAQ
Réponses aux questions que la documentation de l'API des groupes WhatsApp de Meta n'explique pas clairement.
Non. L'API des groupes WhatsApp est active sur l'API Cloud de la plateforme WhatsApp Business depuis 2026. La confusion vient du côté de l'écosystème : plusieurs platefromes de messagerie tierces n'ont pas encore implémenté la prise en charge des groupes, et certains centres d'aide ainsi que des demandes de fonctionnalités ouvertes décrivent toujours les groupes de l'API WhatsApp comme non pris en charge, alors même que la documentation de Meta confirme le contraire.
Non, pas pour l'API des groupes de Meta : un Compte professionnel officiel sur l'API Cloud est requis, et les numéros sur l'application WhatsApp Business ou dans les conversations multi-solutions sont exclus. Compte WhatsApp lié via Unipile est une voie différente : elle se connecte par code QR ou code d'appairage, au nom de l'utilisateur authentifié, sans aucune vérification Meta Business.
8 participants maximum par groupe sur l'API Groupes de l'API Cloud, et jusqu'à 10 000 groupes par numéro d'entreprise. Un compte WhatsApp lié via Unipile suit les mécanismes de groupes natifs de WhatsApp sur le compte lié au lieu de cette limite.
Meta renvoie l'ID du groupe lorsque le groupe est créé, via
POST //groups. Les identifiants de groupe existants sont répertoriés avec GET //groups. Sur un compte lié, le même identifiant apparaît comme étant le chat_id renvoyé lors de la liste des discussions ou du démarrage d'un nouveau groupe.Cela dépend du chemin d'accès. L'API Groups de l'API Cloud est pilotée par des webhooks : les messages arrivent au fur et à mesure, et il n'y a pas de point de terminaison pour récupérer l'historique passé d'un groupe. Un compte WhatsApp lié via Unipile peut récupérer les messages existants et resynchroniser l'historique complet d'une conversation pour le compte de l'utilisateur authentifié.
Non. Unipile est un intermédiaire technique indépendant et est non affilié à, approuvé par ou sponsorisé par WhatsApp ou Meta. Il connecte le propre compte WhatsApp d'un utilisateur en son nom et ne fonctionne pas en tant que fournisseur de solutions WhatsApp Business pour l'API Cloud décrite plus haut sur cette page.
Vous avez encore des questions ? Notre équipe est là pour vous aider.
FR 
EN 
ES 
DE 
IT 
BR 
NL 
PL 
TR