Rejoindre la communauté Slack
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 | Définition | Opérateur | 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 | Mise en service | Idéal pour | Compatible 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.
Pouvez-vous intégrer WhatsApp dans votre propre logiciel ?
Comment obtenir l'accès à l'API WhatsApp ?
De quoi avez-vous besoin avant de pouvoir utiliser l'API WhatsApp Cloud ?
Quelles sont les limites de l'API WhatsApp ?
| Limite | Valeur | Notes |
|---|---|---|
| Débit | 80 messages / seconde | Taux d'envoi à l'échelle de la plateforme |
| Limite de taux de l'API | 200 à 5 000 requêtes / heure | S'adapte en fonction du statut et de la qualité du compte |
| Limite de taux d'appariement | 1 message / 6 secondes | Par destinataire, empêche d'envoyer du spam au même utilisateur |
| Niveau de messagerie | 250 → 2 000 → 10 000 → 100 000 → illimité | Destinataires uniques par période glissante de 24 h, commence à 250 non vérifiés |
Pouvez-vous utiliser l'API WhatsApp avec un compte personnel ou WhatsApp Business App existant ?
Comment connecter un compte WhatsApp à Unipile ?
// SDK Node.js
const { qrCodeString, code } = await client.compte.connecterWhatsapp();
// afficher qrCodeString à l'utilisateur sous forme d'imagePOST /api/v1/accounts
X-API-KEY : votre_clé_d_api
{
"provider": "WHATSAPP",
"numéro_de_téléphone_de_jumelage": "33612345678"
}
// 201 Créé
{
"objet": "CompteCréé",
"account_id": "e-ma1oQ..."
}POST /api/v1/chats/{chat_id}/messages
X-API-KEY : votre_clé_d_api
{
"texte": "Bonjour ! Votre commande a été expédiée."
}
// 201 Créé
{
"objet": "Message envoyé",
"message_id": "msg_9f2c..."
}{
"account_id": "e-ma1oQ...",
"type_de_compte": "WHATSAPP",
"event": "message_reçu",
"chat_id": "chat_182...",
"message_id": "msg_9f2c...",
"message": "Bonjour, cette commande est-elle toujours disponible ?",
"sender": { "id_fournisseur_participant": "33612345678@s.whatsapp.net" },
"horodatage": "2026-08-04T10:15:02Z"
}Que pouvez-vous construire avec l'API WhatsApp ?
| Fonctionnalité | Rôle | Notes |
|---|---|---|
| Envoyer des messages | Texte, médias, notes vocales, documents | Notes vocales : .mp3/.m4a. typing_duration simule la saisie |
| Lister et synchroniser les discussions | Enregistrer chaque conversation dans votre propre base de données | Pagination basée sur les curseurs, filtrer par compte |
| Réagir aux messages | Ajouter une réaction avec un emoji à un message | WhatsApp et LinkedIn |
| Transférer des messages | Transférer un message dans une autre discussion | WhatsApp uniquement |
| Modifier / supprimer des messages | Modifier ou supprimer un message que vous avez envoyé | Supprimer : WhatsApp + LinkedIn. Modifier : WhatsApp + LinkedIn Classic |
| Webhooks en temps réel | Événements push : reçus, réaction, lu, modifié, supprimé, délivré | Aucun sondage requis |
Liste de tous les chats WhatsApp dans votre logiciel
GET /api/v1/chats?account_id=e-ma1oQ...&account_type=WHATSAPP&limit=50
X-API-KEY : votre_clé_d_api
// 200 OK
{
"objet": "Liste de diffusion",
"articles": [
{
"id": "chat_182...",
"account_id": "e-ma1oQ...",
"nom": "Jordan Miles",
"nombre_de_messages_non_lus": 2,
"archivé": faux
}
],
"curseur": "eyJsYXN0X2..."
}Comment Unipile aide les développeurs à connecter instantanément WhatsApp à leur logiciel
Unipile offre une voie alternative aux éditeurs de logiciels en tant que service (SaaS) qui souhaitent intégrer WhatsApp sans passer par le programme officiel de partenaire de Meta. Nous sommes pas un partenaire MetaAu lieu de cela, nous proposons une API de messagerie unifiée qui permet aux développeurs de connecter instantanément des comptes WhatsApp personnels ou professionnels par le biais d'un flux d'authentification par code QR. Cette approche permet d'ajouter WhatsApp à d'autres canaux en quelques étapes seulement.
WhatsAppClassique
WhatsAppBusiness
Intégration de messagerie WhatsApp avec Unipile
Avec Unipile, les développeurs peuvent intégrer toutes les fonctionnalités de base de la messagerie WhatsApp directement dans leur logiciel en quelques étapes seulement. L'API prend en charge les messages texte simples, les médias et la synchronisation en temps réel afin que vos utilisateurs ne manquent jamais une interaction.
LinkedIn
Gmail
Gérer les groupes WhatsApp avec Unipile API
L'API WhatsApp d'Unipile permet aux développeurs d'intégrer gestion complète du groupe directement dans leurs applications. Vos utilisateurs peuvent créer ou rejoindre des groupes WhatsApp, envoyer et répondre à des messages de groupe, et synchroniser les conversations en temps réel.
Qu'il s'agisse de coordonner une session de recrutement, de gérer des discussions commerciales ou d'animer des interactions communautaires, chaque interaction de groupe peut être centralisée dans votre CRM ou ATS. Grâce à la prise en charge du texte, des images, des documents et des notes vocales, les équipes restent connectées et productives sans quitter votre plateforme.
Lister tout Discussions sur WhatsApp dans votre logiciel
curl --demande GET --url https://api1.unipile.com:13111/api/v1/chats --en-tête 'accept : application/json'
L'API d'Unipile permet de récupérer facilement chaque chat WhatsApp lié à un compte utilisateur. Qu'il s'agisse de messages individuels, de discussions de groupe ou de fils d'archives, les développeurs peuvent extraire les liste complète des conversations avec une seule demande. Cela garantit que votre plateforme SaaS peut centraliser toutes les interactions WhatsApp en temps réel, offrant aux utilisateurs une expérience de boîte de réception complète et unifiée.
Fonctionnalités de l'API WhatsApp avec Unipile
Intégrez la messagerie WhatsApp à votre CRM, ATS ou outil de prospection avec une seule API. Synchronisez les conversations, les groupes et les contacts en temps réel, pour le compte de vos utilisateurs authentifiés, sans quitter votre plateforme.
Messages
10 points finaux disponibles
Connexion au compte
2 points finaux disponibles
Pièces jointes
2 points finaux disponibles
Webhooks
3 événements disponibles
L'API WhatsApp prend-elle en charge la messagerie de groupe ?
Quels outils et API d'automatisation WhatsApp devriez-vous utiliser en 2026 ?
| Profil | Besoin | Approche recommandée |
|---|---|---|
| Intégration de comptes possédés par les utilisateurs dans un SaaS / CRM | Chaque utilisateur final connecte le WhatsApp (et souvent LinkedIn, Instagram, l'email) qu'il possède déjà, au sein de votre produit | API de session unifiée, pas de vérification Meta par utilisateur |
| Diffusion d'entreprise à grande échelle | Un numéro d'entreprise vérifié envoyant des modèles de marketing ou d'utilité à un large public | directement par l'API Cloud de Meta, ou par l'intermédiaire d'un BSP |
| Prototypage de développeur | Chemin le plus rapide possible vers une intégration fonctionnelle avant de s'engager sur l'infrastructure | API de session pour les comptes possédés par les utilisateurs, sandbox Cloud API pour un seul numéro d'entreprise |
Quelles sont les meilleures pratiques pour l'API WhatsApp de Meta ?
Où aller ensuite avec l'API WhatsApp
Pourquoi choisir Unipile plutôt que de construire avec Meta ?
Dépasser les limitations des API de Meta. Voici comment Unipile se compare en termes de vitesse, d'effort et d'accès, afin que vous puissiez vous concentrer sur la création plutôt que sur la lutte avec la configuration.
| Critères | API Meta | Unipile |
|---|---|---|
| Le temps d'intégration | Semaines ou mois | 2-3 jours |
| Effort de développement | Elevé | Faible (REST + SDK) |
| Maintenance | Manuelle | Gestion complète |
| Accès aux fonctionnalités | Partiel (après approbation) | Complet, instantané |
| Support | Libre-service uniquement | Équipe technique dédiée |
| Critères | API Meta | Unipile |
|---|---|---|
| Le temps d'intégration | Semaines/mois | 2-3 jours |
| Effort de développement | Elevé | Faible (REST + SDK) |
| Maintenance | Manuelle | Gestion complète |
| Accès aux fonctionnalités | Partiel (après approbation) | Complet, maintenant |
| Support | Libre-service uniquement | Équipe technique dédiée |
Intégration rapide et simplifiée
Avec Unipile, l'intégration de WhatsApp ne prend que quelques minutes. Les développeurs peuvent authentifier leurs comptes grâce à un QR-code sécurisé, commencer à envoyer et à recevoir des messages immédiatement, et bénéficier d'une assistance dédiée pendant l'installation. Cette approche réduit considérablement le temps de mise sur le marché, ce qui permet aux éditeurs de SaaS de lancer plus facilement de nouvelles fonctionnalités de messagerie.
Fonctionnalités complètes de messagerie
L'API Unipile offre un accès complet aux fonctions essentielles de WhatsApp : envoi et réception de messages, notes vocales, images, vidéos, documents et synchronisation des conversations en temps réel. Toutes les communications sont centralisées dans une inbox unifiée, ce qui permet de ne rien manquer. Au-delà de WhatsApp, la même API connecte LinkedIn, Instagram, Telegram, Messenger, X/Twitter, Gmail et Outlook.
Un tableau de bord pour toutes vos intégrations
Gérez tous vos comptes LinkedIn, WhatsApp, Gmail et autres à partir d'une interface unique et intuitive.
veulent se connecter
Comptes
03/01/2025
02/15/2025
02/10/2025
03/01/2025
02/28/2025
02/20/2025
03/01/2025
02/25/2025
03/01/2025
02/22/2025
02/14/2025
02/12/2025
02/08/2025
02/05/2025
03/01/2025
02/15/2025
03/01/2025
02/22/2025
Intégration rapide de l'API WhatsApp avec authentification par QR code.
Avec Unipile, la connexion d'un compte WhatsApp ne prend que quelques minutes. Le processus est simple, sécurisé et évite la longue procédure d'approbation commerciale de Meta. Voici comment cela fonctionne :
1. Demander un code QR
Votre application génère un code QR unique via l'API Unipile. Il suffit aux utilisateurs de le scanner avec WhatsApp pour lancer l'authentification.
2. Afficher le code QR
Le QR code peut être affiché directement dans votre application à l'aide de bibliothèques standard (PHP ou JS). Les utilisateurs le scannent avec leur téléphone pour lier leur compte.
3. Confirmer l'authentification
Une fois le code scanné, le statut du compte devient connecté. Vous pouvez récupérer cet événement soit en interrogeant l'état du compte, soit en configurant un webhook pour une confirmation en temps réel.
4. Lancer la messagerie
Dès que le compte est actif, vous pouvez envoyer et recevoir des messages texte, partager des images, des vidéos, des documents et des notes vocales. Des webhooks en temps réel vous informent également des nouveaux messages, des réactions et des accusés de réception.
Cas d'utilisation : Ajouter WhatsApp à Votre Produit
Intégrez la messagerie WhatsApp native dans les outils que vos utilisateurs utilisent déjà, de la vente au recrutement en passant par la prospection multicanal.
CRM / Outils de vente
Transformez les conversations en opportunités. Faites entrer les messages WhatsApp directement dans votre CRM. Centralisez les discussions avec les clients, répondez plus rapidement, partagez des documents ou des notes vocales et déclenchez des suivis automatisés, le tout à partir d'un seul endroit et sans changer d'outil.
WhatsApp pour CRMATS / Recrutement
Entrez en contact avec les candidats là où ils se trouvent. Synchronisez les conversations des candidats sur WhatsApp et gérez-les dans une boîte de réception partagée. Attribuez des fils de discussion à des coéquipiers, collaborez facilement et gardez chaque échange visible dans votre ATS pour accélérer les décisions d'embauche.
WhatsApp pour ATSPlatesformes d'outreach
Le multicanal en toute simplicité. Créez des campagnes qui combinent WhatsApp, LinkedIn et l'email dans un workflow unifié. Envoyez des séquences personnalisées, suivez les réponses en temps réel et restez conforme tout en gérant chaque conversation au sein de votre outil de sensibilisation.
Outil WhatsApp for OutreachEn savoir plus avec
notre API de messagerie
Unipile ne s'arrête pas à WhatsApp. Notre API unifiée se connecte également à LinkedIn, Instagram, Messenger, X (Twitter) et Telegram. En centralisant tous ces canaux en un seul endroit, vos utilisateurs peuvent gérer chaque conversation de manière transparente. Des DM aux commentaires en passant par les chats de groupe, tout est accessible dans une seule boîte de réception, ce qui aide les équipes à répondre plus rapidement, à suivre l'engagement et à offrir une expérience utilisateur cohérente sur toutes les plateformes.
Assistance à l'intégration et ressources pour la réussite de l'API WhatsApp
L'installation technique simplifiée
Intégrez rapidement les fonctionnalités de messagerie WhatsApp grâce à notre API entièrement documentée et à nos exemples de SDK. Qu'il s'agisse d'envoyer des messages, de partager des médias ou de synchroniser des conversations, nos outils sont conçus pour vous aider à être opérationnel en quelques jours au lieu de quelques semaines.
L'appui d'un expert pour un déploiement en douceur
Notre équipe technique travaille directement avec vos développeurs pour garantir une intégration transparente. De l'authentification par QR-code à la gestion des webhooks et au débogage des flux de messages en temps réel, les experts d'Unipile guident votre intégration à chaque étape du processus.
Améliorations continues et compatibilité
Nous alignons continuellement nos end points de l'API WhatsApp sur les dernières mises à jour. Cela permet à votre produit de bénéficier des nouvelles fonctionnalités sans changements ou interruptions inattendus. Vous restez à jour et conforme, sans aucune charge de maintenance.
Conclusion
WhatsApp est devenu un canal essentiel pour l'engagement client, le support et les ventes, avec des milliards d'utilisateurs actifs dans le monde entier. Bien que les API officielles Business et Cloud de Meta offrent des capacités robustes, elles s'accompagnent souvent de complexité : intégration longue, vérification de l'entreprise, quotas et règles de conformité strictes. Pour de nombreux éditeurs de SaaS, cela crée des frictions et des retards dans la fourniture de valeur à leurs utilisateurs.
Unipile élimine ces obstacles grâce à une API de messagerie unifiée cela rend l'intégration de WhatsApp rapide, sécurisée et conviviale pour les développeurs. Grâce à une simple authentification par code QR, les entreprises de logiciels peuvent activer la messagerie texte, le partage de médias, les notes vocales et les conversations de groupe en quelques minutes seulement, sans devenir un partenaire Meta ni héberger d'infrastructure. Les webhooks en temps réel, la synchronisation des messages et la compatibilité multi-canal garantissent une expérience transparente sur WhatsApp, LinkedIn, Instagram, Telegram, Gmail et Outlook.
En choisissant Unipile, les plateformes SaaS peuvent fournir une véritable communication omnicanaleUnipile : une API, une intégration, un potentiel illimité. Que vous construisiez un CRM, un ATS ou une solution de sensibilisation, Unipile accélère votre temps de mise sur le marché, réduit les coûts de maintenance et garantit la conformité avec la loi sur les marchés numériques.
Le moment est venu de transformer WhatsApp en un atout puissant pour votre produit. Commencez dès aujourd'hui à construire avec Unipile et offrez à vos utilisateurs l'expérience de communication qu'ils attendent.
API WhatsApp - Foire aux questions
message_received événement webhook en temps réel, avec le texte du message, l'expéditeur et les pièces jointes, de sorte que vous n'avez jamais à interroger les nouveaux messages.
