API WhatsApp : Types, Accès, Tarifs et limites
// Lier un compte WhatsApp existant
const compte = await client.compte.connecterWhatsapp();
// account.qrCodeString -> l'afficher à l'utilisateur
// ou passez un pairing_phone_number à la place
const chats = await client.chats.list({
account_type: 'WhatsApp'
});
Qu'est-ce que l'API WhatsApp ?
| Nom | Qu'est-ce que c'est | Qui l'exploite | Conditions d'accès |
|---|---|---|---|
| Plateforme WhatsApp Business (API Cloud) | L'API officielle de Meta pour provisionner de nouveaux numéros de téléphone professionnels et envoyer des messages modèles à grande échelle | Méta | Application de développeur Meta, WABA, numéro de téléphone professionnel, vérification pour les niveaux supérieurs |
| Accès Fournisseur de Solutions Commerciales (BSP) | Un tiers (Twilio, 360dialog et similaires) revendant la même API Cloud, intégrée dans son propre tableau de bord et sa propre facturation | Infrastructure Meta, gérée par BSP | Mêmes exigences sous-jacentes de Meta, provisionnées par le BSP |
| API de session unifiée (Unipile) | Connecte un compte WhatsApp, professionnel ou personnel, de la même manière que WhatsApp Web, par code QR ou code d'appairage | Unipile, au nom de l'utilisateur authentifié | Pas de vérification Meta Business, pas de nouveau numéro, pas d'approbation de modèle |
Quels sont les différents types d'API WhatsApp ?
| Type | Approvisionnement | Meilleur pour | Fonctionne avec un compte existant |
|---|---|---|---|
| API dans le nuage | Nouveau numéro de téléphone professionnel + vérification Meta Business pour un volume plus élevé | Les entreprises qui envoient des messages marketing ou des notifications en grande quantité et à grande échelle | Non, nécessite un nouveau numéro |
| API sur site | Obsolète. Meta l'a retiré et a incité à migrer vers l'API Cloud | Intégrations existantes uniquement | Non |
| WhatsApp Business App | Application grand public gratuite, configuration manuelle sur un seul appareil | Petites entreprises gérant les discussions à la main | Oui, mais manuellement, un appareil, pas par programmation |
| API de session unifiée (Unipile) | Associe le compte de la même manière que WhatsApp Web, sans nouveau numéro | Des plateformes SaaS intégrant le propre compte WhatsApp de chaque utilisateur dans leur produit | Oui, c'est le cas d'utilisation principal |
L'écosystème de l'API WhatsApp
Meta propose deux API officielles qui permettent aux entreprises d'intégrer WhatsApp dans leurs logiciels. Les deux sont conçues pour permettre la messagerie à haut volume avec des fonctionnalités telles que les messages modèles, le partage de médias et les outils de support client.
WhatsApp Business API
L'API Business a été la première solution lancée par Meta pour aider les entreprises à interagir avec leurs clients sur WhatsApp. Elle est généralement auto-hébergée ou gérée par un fournisseur agréé, ce qui permet aux entreprises de mieux contrôler leur infrastructure. Elle prend en charge les messages sortants modélisés, les réponses des clients et les formats multimédias, ce qui la rend adaptée aux entreprises qui ont besoin d'intégrer WhatsApp directement dans leur CRM, leur centre de contact ou leur système d'assistance.
WhatsApp Cloud API
Lancée plus tard, l'API Cloud est entièrement hébergée par Meta. Les entreprises n'ont plus besoin de gérer des serveurs ou une infrastructure lourde. L'API Cloud offre des fonctionnalités de base similaires, telles que l'envoi et la réception de messages, la gestion des modèles et la prise en charge des médias, tout en étant plus facile à déployer pour les développeurs. Elle se positionne comme un moyen plus rapide d'accéder à WhatsApp de manière programmatique, en particulier pour les entreprises qui souhaitent une évolutivité sans les frais généraux d'un hébergement sur site.
La complexité de l'intégration de WhatsApp
Bien que les API Business et Cloud de Meta offrent des fonctionnalités puissantes, leur intégration est loin d'être simple. Les développeurs doivent gérer la vérification de l'entreprise, l'approbation des modèles et les quotas de messages avant même de pouvoir utiliser la plateforme. L'hébergement ou la connexion à l'API Cloud nécessite également de gérer les webhooks, le cryptage et la conformité avec des règles d'opt-in strictes. Ces obstacles retardent souvent les projets et limitent l'accès aux petits fournisseurs de SaaS qui souhaitent ajouter rapidement WhatsApp à leurs plateformes.