L’équipe Periskope
L’API Groupes WhatsApp permet aux entreprises de créer et de gérer des groupes WhatsApp par programmation, via la WhatsApp Business Platform.
Pour y accéder, il faut un Official Business Account (OBA, compte professionnel officiel) et un numéro Cloud API compatible. L’API impose aussi des limites strictes sur la taille des groupes, leur création, la gestion des participants et l’envoi de messages.
Ce guide fait le point sur l’éligibilité à l’API Groupes, les conditions du statut OBA, les limites actuelles, les tarifs et les solutions si l’API ne correspond pas à votre usage.
En bref : l’API Groupes WhatsApp en un coup d’œil
Qui peut utiliser l’API Groupes WhatsApp ?
Pour utiliser l’API Groupes, votre entreprise doit disposer d’un Official Business Account (OBA).
Attention : un compte Meta Business vérifié, un nom d’affichage WhatsApp validé ou un accès à la WhatsApp Business Platform ne font pas automatiquement de vous un OBA.
1. Que signifie OBA ?
Meta réserve le statut OBA aux entreprises établies et reconnues sur WhatsApp. L’examen du dossier OBA tient compte notamment de :
La vérification de l’entreprise
Un nom d’affichage validé
La vérification en deux étapes sur le numéro de téléphone
L’ancienneté de l’entreprise sur la WhatsApp Business Platform
Une présence notoire et authentique
L’éligibilité au statut OBA ne se limite donc pas à la vérification de l’entreprise (Business Verification).
2. Le badge OBA et le statut réel côté API
Un autre point mérite votre attention si vous vérifiez l’éligibilité via l’API.
WhatsApp expose plusieurs champs liés au statut du compte professionnel, dont is_official_business_account et oba_status. Ils ne disent pas toujours la même chose.
Un compte peut apparaître comme compte professionnel officiel dans un champ alors que son oba_status n’indique pas de statut OBA actif.
Si vous automatisez la vérification d’éligibilité, ne vous fiez pas à un seul champ booléen. Contrôlez le statut OBA réellement renvoyé pour l’entreprise et assurez-vous que le numéro et le compte remplissent les conditions de l’API Groupes.
Sinon, un tableau de bord ou une intégration peut afficher une entreprise comme « officielle » alors que son compte n’a toujours pas accès à l’API Groupes.
3. Il vous faut un numéro Cloud API
L’API Groupes fonctionne avec les numéros WhatsApp Cloud API.
Un numéro utilisé dans l’app WhatsApp Business ne peut pas utiliser l’API Groupes. Meta ne prend pas non plus en charge l’API Groupes en mode Coexistence pour l’instant.
Une entreprise qui gère aujourd’hui son numéro dans l’app WhatsApp Business ne peut donc pas brancher cette configuration telle quelle sur l’API Groupes. Le numéro doit passer par une configuration Cloud API compatible.
Check-list d’éligibilité Avant de construire quoi que ce soit autour de l’API Groupes, vérifiez que :
|
|---|
Try Periskope
Gérez vos groupes, conversations et numéros WhatsApp à grande échelle
Limites et restrictions de l’API Groupes WhatsApp
Une fois votre entreprise éligible, reste à savoir si l’API correspond vraiment à votre façon de travailler.
1. 8 participants maximum par groupe
Un groupe créé via l’API Groupes accepte 8 participants au maximum, numéro de l’entreprise compris. Il reste donc de la place pour 7 autres participants.
L’API se prête ainsi mieux à de petites conversations ciblées qu’à de grandes communautés de clients.
Par exemple :
Un client + l’équipe support
Une petite équipe projet
Un concessionnaire + ses chargés de compte
Un petit groupe de clients en cours d’onboarding
S’il vous faut un groupe WhatsApp de 50 ou 500 membres, cette limite exclut d’office l’API Groupes.
2. Jusqu’à 10 000 groupes par numéro professionnel
Un même numéro professionnel WhatsApp API peut créer jusqu’à 10 000 groupes via l’API Groupes.
Autre règle à connaître : un groupe ne peut appartenir qu’à une seule entreprise Cloud API. Deux comptes professionnels différents ne peuvent pas partager ni cogérer le même groupe.
3. Les participants rejoignent le groupe sur invitation
L’API Groupes ne permet pas à l’entreprise d’ajouter directement des participants à un groupe.
À la création d’un groupe, WhatsApp génère un lien d’invitation. Vous l’envoyez aux personnes concernées, et vous pouvez activer l’approbation des demandes d’adhésion si vous voulez valider chaque arrivée.
Une entreprise peut par exemple créer un groupe pour un nouveau client et lui envoyer le lien d’invitation dans un modèle WhatsApp validé.
4. 3 messages épinglés au maximum
L’API Groupes prend en charge les messages épinglés, avec un maximum de 3 messages épinglés par groupe.
Si vous épinglez un quatrième message, WhatsApp désépingle automatiquement le plus ancien. Chaque épinglage reste actif de 1 à 30 jours.
5. L’API Groupes a ses propres limites de débit
Les opérations de l’API Groupes sont soumises à leurs propres limites de débit. Si un numéro enchaîne trop d’opérations sur les groupes en peu de temps, l’API peut renvoyer l’erreur 131208, Group Rate Limit Hit.
Cette limite est distincte du débit d’envoi général de la Cloud API. Un débit de messagerie élevé ne lève pas les limites propres aux opérations de l’API Groupes.
6. Meta peut suspendre temporairement la création de groupes
Meta peut empêcher temporairement une entreprise de créer de nouveaux groupes si elle détecte un excès de messages marketing envoyés par le WABA dans la fenêtre de service client au cours des 7 derniers jours.
Cela se traduit par l’erreur 131214.
Si votre organisation repose beaucoup sur la création de nouveaux groupes, mieux vaut anticiper cette limite.
Comment fonctionne la tarification de l’API Groupes WhatsApp ?
Avec la tarification classique de la WhatsApp Cloud API, vous payez chaque message délivré à la personne que vous contactez (depuis le 1er juillet 2025, Meta facture au message et non plus par conversation de 24 heures).
Une personne, un message facturé.
Les groupes fonctionnent autrement.
Quand vous envoyez un message dans un groupe, WhatsApp le facture comme un envoi distinct à chaque membre du groupe, et non comme un seul message.
Envoyer une mise à jour dans un groupe complet de 8 personnes (votre entreprise plus 7 autres) compte donc pour 7 envois facturés, et non 1.
Exemple : une entreprise qui envoie 100 mises à jour par mois dans un groupe complet de 8 personnes ne paie pas 100 messages. Elle paie jusqu’à 700 envois facturés, soit le même montant que 700 messages individuels.
Le coût augmente avec le nombre total de personnes touchées dans tous vos groupes, pas avec le nombre de fois où vous appuyez sur « Envoyer ». Depuis le 1er octobre 2026, les messages de service (réponses libres envoyées dans la fenêtre de 24 heures) sont eux aussi facturés au-delà des 1 000 gratuits par numéro professionnel et par mois, au tarif « utility » du marché concerné. Voir ce qui a changé le 1er octobre.
Que faire si vous n’êtes pas éligible ou si les limites vous bloquent ?
Si votre entreprise n’a pas encore le statut OBA, utilise l’app WhatsApp Business ou fonctionne en Coexistence, l’API Groupes ne vous est pas accessible pour le moment, aussi solide que soit le reste de votre configuration.
Et même avec le statut OBA, le plafond de 8 participants exclut tout ce qui dépasse un petit groupe structuré.
Une escalade support avec quelques personnes, oui. Une communauté, une promotion ou un groupe de clients d’une taille un peu sérieuse, non.
Si vous avez déjà des groupes WhatsApp actifs, Periskope permet à vos équipes de les gérer à grande échelle.
L’outil connecte vos numéros WhatsApp et WhatsApp Business classiques via les appareils connectés de WhatsApp : vos équipes gèrent les groupes et discussions que ces numéros utilisent déjà.
Vous réunissez ces conversations dans un espace de travail partagé, attribuez tickets et tâches, orientez les messages vers les bons collaborateurs, automatisez vos workflows et gérez des milliers de groupes WhatsApp depuis un seul endroit.
C’est la solution adaptée aux entreprises qui ont déjà des groupes WhatsApp actifs et veulent les gérer en équipe, plutôt que d’en créer de nouveaux via l’API Groupes.
Pour une comparaison détaillée des deux approches, consultez Groupes WhatsApp classiques vs API Groupes WhatsApp.
Questions fréquentes
1. Que signifie avoir un Official Business Account (OBA) sur WhatsApp ?
L’OBA est un statut que Meta accorde aux entreprises établies et reconnues sur la WhatsApp Business Platform.
Il faut une entreprise vérifiée, un nom d’affichage validé, la vérification en deux étapes et un historique sur la plateforme. Remplir ces conditions ne garantit pas pour autant d’obtenir le statut OBA.
2. Mon entreprise apparaît comme vérifiée, pourquoi n’ai-je pas accès à l’API Groupes ?
La vérification de l’entreprise et le statut OBA sont deux choses différentes. Consultez directement le champ oba_status plutôt que de vous fier à un badge, qui peut s’afficher via Meta Verified sans validation OBA complète.
3. Puis-je utiliser l’API Groupes WhatsApp avec l’app WhatsApp Business ?
Non. L’API Groupes exige un numéro Cloud API standard. Elle n’est pas disponible pour les numéros de l’app Business ni pour les configurations en Coexistence.
4. L’API Groupes WhatsApp exige-t-elle 100 000 messages par jour ?
Non. La documentation actuelle de Meta sur l’API Groupes ne mentionne aucun seuil de 100 000 messages comme condition à part. Le statut OBA est la condition d’éligibilité essentielle côté compte professionnel, avec la configuration Cloud API requise.
5. Combien de groupes un numéro WhatsApp professionnel peut-il créer ?
Jusqu’à 10 000 groupes par numéro professionnel.
6. Comment est calculé le prix de l’API Groupes WhatsApp ?
Par destinataire, et non par message envoyé. Un message dans un groupe de 8 personnes est facturé jusqu’à 7 envois, pas une seule.
7. Pourquoi ne puis-je pas ajouter directement un participant à un groupe de l’API Groupes ?
Il n’existe pas d’endpoint pour ajouter un participant. Les participants rejoignent le groupe via un lien d’invitation, qu’ils doivent accepter eux-mêmes.
8. Puis-je transférer un groupe WhatsApp existant vers l’API Groupes ?
Non. L’API Groupes sert à créer de nouveaux groupes gérés par l’API et ne permet pas d’importer un groupe WhatsApp existant ni sa liste de membres. Si vous avez déjà des groupes WhatsApp actifs, Periskope les gère tels quels, sans migration.
Essayez gratuitement Periskope pour voir ce que cela donne sur vos propres groupes.
