# API WhatsApp officielle vs non officielles (WAHA, Baileys…) URL: https://wa.genuka.com/docs/compare/unofficial-whatsapp-apis Language: French > Whapi.Cloud, WAHA, Green API, Baileys : comment marchent les API WhatsApp non officielles, leurs risques et ce qui change avec l'API officielle. Une API WhatsApp non officielle (Whapi.Cloud, WAHA, Green API, Evolution API en mode Baileys, Baileys, whatsapp-web.js) pilote un compte WhatsApp comme le ferait WhatsApp Web, après le scan d'un QR code. C'est rapide et sans validation de Meta, mais contraire aux Conditions d'utilisation de WhatsApp, et le numéro peut être banni. L'API officielle passe par la Cloud API de Meta. *Mis à jour le 8 octobre 2026* > [!NOTE] > **Comment cette page a été écrite** > > Genuka vend un accès à l'API officielle : nous avons un intérêt dans cette comparaison. Pour rester > juste, chaque affirmation sur un outil vient de sa propre documentation, et chaque règle de > WhatsApp de ses textes officiels, consultés à la date ci-dessus et listés dans les > [Sources](#sources). Nous n'avons trouvé aucun taux de bannissement publié, ni par WhatsApp ni > par ces projets : nous n'en citons donc aucun. ## Comment fonctionne une API WhatsApp non officielle ? WhatsApp permet de lier des appareils secondaires à un compte : c'est ainsi que fonctionne WhatsApp Web. Une API non officielle se fait passer pour l'un de ces appareils. Vous scannez un QR code depuis **Appareils connectés** sur votre téléphone, ou vous saisissez un code d'appairage, et l'outil envoie et reçoit les messages du compte comme le ferait un navigateur. Deux techniques coexistent : * **Piloter le vrai WhatsApp Web dans un navigateur.** whatsapp-web.js et les moteurs WEBJS et WPP de WAHA lancent Chromium avec Puppeteer et appellent les fonctions internes de WhatsApp Web. * **Parler directement le protocole de WhatsApp Web.** Baileys, ainsi que les moteurs NOWEB et GOWS de WAHA, ouvrent une connexion WebSocket, sans navigateur. Par-dessus, certains projets ajoutent une API HTTP et des webhooks : WAHA et Evolution API s'installent sur votre serveur, Green API et Whapi.Cloud sont des services hébergés qui gardent la session pour vous. | Outil | Type | Connexion à WhatsApp | Prix affiché | Ce qu'en dit le projet | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | Baileys | Bibliothèque TypeScript, licence MIT | WebSocket, QR code ou code d'appairage | Gratuit | « not affiliated \[…] with WhatsApp » ; « Do not spam people with this » | | whatsapp-web.js | Bibliothèque Node.js, licence Apache 2.0 | WhatsApp Web piloté par Puppeteer | Gratuit | « it is not guaranteed you will not be blocked by using this method » | | WAHA | Serveur HTTP auto-hébergé (Docker), licence Apache 2.0 | Navigateur (WEBJS, WPP) ou WebSocket (NOWEB, GOWS), QR code | Gratuit ; soutien facultatif à 5 $ par mois | « WhatsApp does not allow bots or unofficial clients on their platform » | | Evolution API | Serveur REST auto-hébergé, licence Apache 2.0 avec conditions supplémentaires (mention d'usage obligatoire, sinon licence commerciale) | Au choix : Baileys (WhatsApp Web) ou la Cloud API officielle de Meta | Gratuit | Le mode Baileys « may have limitations compared to official APIs » | | Green API | Service hébergé | QR code via Appareils connectés ; le téléphone reste chargé et connecté, ou hébergé chez eux | Developer gratuit, Business 12 $ par mois, Chatbot 24 $ par mois | « The decision to block an account is made by WhatsApp » | | Whapi.Cloud | Service hébergé | Session d'appareil lié, QR code ou code d'appairage | Sandbox gratuit et limité ; Developer Premium à 29 $ par mois et par numéro (affiché barré à 40 $) | « Any automation can carry a risk of WhatsApp restrictions » | Evolution API n'est non officielle qu'en mode Baileys : son connecteur Cloud API passe par la plateforme de Meta, avec les mêmes règles que Genuka WA. ## Pourquoi les développeurs choisissent-ils une API non officielle ? * **Démarrer en quelques minutes.** Un scan de QR code suffit : pas de portefeuille d'entreprise Meta, pas d'Embedded Signup, pas de template à faire valider. * **Écrire à n'importe qui, n'importe quand.** Whapi.Cloud met en avant « No templates or approvals ». Sur l'API officielle, un message envoyé hors de la fenêtre de 24 heures doit être un template validé par Meta. * **Un prix fixe, sans frais par message.** Whapi.Cloud n'applique « no per-message, per-conversation, or per-request fees » ; WAHA est gratuit, sans limite de messages. Sur l'API officielle, Meta facture les templates et, depuis le 1er octobre 2026, les réponses libres au-delà de 1 000 messages de service gratuits par numéro et par mois. * **Les groupes, les Chaînes et les Statuts.** Whapi.Cloud et WAHA les exposent. L'API de Genuka WA ne gère pas les groupes. * **Garder son téléphone.** La session s'ajoute aux appareils existants ; l'application continue de fonctionner comme avant. Ce sont de vraies raisons. La question est ce qu'elles coûtent. ## Quels sont les risques d'une API WhatsApp non officielle ? ### Que disent les Conditions d'utilisation de WhatsApp ? Les Conditions d'utilisation de WhatsApp interdisent les communications qui impliquent « bulk messaging, auto-messaging, auto-dialing, and the like », ainsi que tout « non-personal use of our Services unless otherwise authorized by us ». Elles interdisent aussi d'exploiter le service « through automated or other means » de façon non autorisée, et de « create software or APIs that function substantially the same as our Services and offer them for use by third parties in an unauthorized manner ». En cas de manquement, WhatsApp peut « modify, suspend, or terminate your access ». Les projets le reconnaissent eux-mêmes : whatsapp-web.js et WAHA écrivent que WhatsApp n'autorise pas les bots ni les clients non officiels, et les mainteneurs de Baileys disent ne cautionner aucun usage contraire aux Conditions de WhatsApp. ### Mon numéro peut-il être banni ? Oui, et aucun de ces outils ne prétend le contraire. Green API écrit que la décision de bloquer un compte appartient à WhatsApp et ne dépend pas de son service. Il cite les signes d'automatisation, les plaintes des destinataires et le taux de réponse, recommande de « chauffer » un nouveau numéro pendant au moins 10 jours et de ne pas écrire à plus de 200 clients par jour. Whapi.Cloud reconnaît que toute automatisation comporte un risque de restriction. Sur le dépôt de Baileys, des utilisateurs signalent encore des comptes bannis après des envois en masse (ticket ouvert le 7 octobre 2026). Un bannissement ne coûte pas seulement l'intégration : il coûte le numéro que vos clients connaissent, avec ses conversations. ### Pourquoi l'absence de templates pose-t-elle problème ? Sur la plateforme officielle, la politique WhatsApp Business exige l'accord du destinataire : « You may only contact people on WhatsApp if: (a) they have given you their mobile phone number \[…]; and (b) you have received opt-in permission \[…] ». Hors de la fenêtre de 24 heures, seul un template relu par Meta peut partir, et chaque portefeuille d'entreprise a une limite d'envoi, partagée par ses numéros, qui augmente quand les messages sont de bonne qualité et que la moitié de la limite est utilisée. Sur une session non officielle, aucun de ces garde-fous n'existe : rien ne vous empêche d'écrire à une liste froide. Or les plaintes des destinataires font partie des causes de blocage que cite Green API. ### Une session peut-elle se déconnecter ? Oui. Whapi.Cloud indique qu'il faut en général utiliser WhatsApp sur le téléphone au moins une fois tous les 14 jours pour garder la session active, et que WhatsApp peut malgré tout réinitialiser les sessions liées et exiger une nouvelle autorisation. Green API rappelle que l'envoi passe par le téléphone, qui doit rester chargé et connecté, sauf à louer un téléphone hébergé chez eux. WAHA prévient que les réponses d'API et les webhooks diffèrent sensiblement d'un moteur à l'autre. Pour des notifications de commande ou des codes de connexion, c'est un point de défaillance à prévoir. ### Qui a accès à vos conversations ? Un appareil lié reçoit les conversations du compte, pas seulement celles de votre intégration : Baileys documente même la récupération de l'historique complet. Avec un service hébergé, c'est ce prestataire qui détient la session de votre numéro. ## Quand une API non officielle peut-elle avoir du sens ? Ces usages restent hors du cadre prévu par WhatsApp. Le risque est le même partout ; ce qui varie, c'est ce qu'il vous coûte. Il reste supportable quand perdre le numéro ne coûte presque rien : * **Automatiser votre propre compte** : rappels personnels, archivage de vos messages, notifications envoyées à vous-même. * **Un prototype ou une démo**, sur un numéro dédié que vous acceptez de perdre, avec des destinataires qui savent qu'ils testent. * **Un outil interne à faible volume**, entre personnes qui vous connaissent et vous ont écrit. Dès que des clients, des codes de connexion ou des paiements dépendent du numéro, ou que vous écrivez à des gens qui ne vous ont rien demandé, le calcul s'inverse. ## En quoi l'API officielle via Genuka WA est-elle différente ? La Cloud API est la voie que Meta prévoit pour les entreprises. Genuka est Meta Tech Provider : vous connectez votre propre numéro WhatsApp Business par l'Embedded Signup de Meta, puis vous envoyez notifications, codes à usage unique et campagnes en HTTP, sans déposer vous-même de dossier de fournisseur auprès de Meta. | | API officielle, via Genuka WA | API non officielle | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | Autorisée par WhatsApp | Oui, c'est la plateforme prévue pour les entreprises | Non : les Conditions d'utilisation interdisent l'accès automatisé non autorisé | | Connexion du numéro | Embedded Signup de Meta, sur votre propre compte WhatsApp Business (WABA) | Scan d'un QR code, comme un appareil lié | | Écrire en premier à un client | Template validé par Meta | N'importe quel message | | Volume | 250 destinataires uniques par 24 heures pour un nouveau portefeuille d'entreprise, puis 2 000, 10 000, 100 000 et illimité | Aucun plafond publié ; Green API recommande de ne pas dépasser 200 clients par jour | | Débit | Plafond Meta de 80 messages par seconde et par numéro par défaut, 20 en coexistence | Celui de la session | | Groupes, Chaînes, Statuts | Non pris en charge par Genuka WA | Oui, selon l'outil | | Statuts de livraison | Webhooks signés en HMAC-SHA256, relancés, rejouables | Webhooks de l'outil | | Coût | Frais Meta par message, facturés à votre WABA, plus un abonnement Genuka par numéro | Abonnement fixe, ou gratuit en auto-hébergé | | Principal risque | Template refusé ; note de qualité en baisse si les destinataires se plaignent | Bannissement du numéro, session déconnectée | Ce que vous perdez, honnêtement : * Vous ne pouvez pas écrire en premier sans template validé par Meta. * Le volume démarre bas : 250 destinataires uniques par 24 heures. Il passe à 2 000 après la vérification de l'entreprise par Meta, ou après 2 000 messages livrés hors fenêtre en 30 jours avec des templates de bonne qualité, puis augmente automatiquement. Voir [ce qui marche sans vérification Meta](https://wa.genuka.com/docs/guides/without-meta-verification). * Les templates ont un coût Meta, selon leur catégorie et le pays du destinataire. Depuis le 1er octobre 2026, Meta facture aussi les réponses libres envoyées dans la fenêtre de 24 heures, au-delà de 1 000 messages de service gratuits par numéro et par mois. * Genuka WA n'envoie ni dans les groupes, ni dans les Chaînes, ni dans les Statuts. Ce que vous gagnez : * Vous êtes dans le cadre prévu par WhatsApp. Le risque qui reste est celui de la qualité : des messages mal reçus font baisser la note du numéro, et Meta peut le restreindre. * Ni téléphone, ni navigateur, ni QR code à maintenir en vie. * Les réponses et les statuts (`sent`, `delivered`, `read`, `failed`) arrivent sur des [webhooks signés](https://wa.genuka.com/docs/webhooks), relancés 5 fois et rejouables depuis le journal. * Les désinscriptions marketing sont appliquées : Genuka WA refuse un template marketing connu de votre espace vers un contact désinscrit (`403 recipient_opted_out`), et une campagne marketing écarte ces contacts (statut `skipped`). * Meta facture vos messages directement, sans marge de Genuka. L'abonnement commence à 5 000 FCFA ou 19 $ par mois et par numéro, avec 7 jours d'essai sans carte. Voir la [page des tarifs](https://wa.genuka.com/#pricing). ## Comment passer d'une API non officielle à l'API officielle ? 1. ### Identifiez l'application derrière le numéro * **Le numéro tourne sur l'application WhatsApp Business** : gardez-le. C'est la **coexistence** de Meta : l'application continue de fonctionner en un-à-un, et l'historique se synchronise. Il faut l'application en version 2.24.17 ou plus récente, et la synchronisation doit se faire dans les 24 heures. À la connexion, Meta délie tous les appareils secondaires du compte, session non officielle comprise : ne la reliez pas ensuite. * **Le numéro est inscrit sur WhatsApp classique** : il doit d'abord être libéré, en supprimant le compte WhatsApp de ce numéro, ou bien vous utilisez un autre numéro. En coexistence, Meta précise que les discussions de groupe ne sont pas synchronisées et que les listes de diffusion de l'application sont désactivées. Le détail est dans le guide [Coexistence](https://wa.genuka.com/docs/guides/coexistence). 2. ### Connectez le numéro à Genuka WA Créez un compte : l'onboarding vous propose de connecter un numéro. Ensuite, c'est **Numéros** > **Ajouter un numéro** > **Connecter WhatsApp**, qui ouvre l'Embedded Signup de Meta. Le numéro, son WABA et ses templates apparaissent dans votre espace. Ajoutez un moyen de paiement au compte WhatsApp Business : c'est Meta qui facture les messages. Voir [Connecter un numéro](https://wa.genuka.com/docs/onboarding). 3. ### Soumettez vos templates Chaque message que vous envoyez en premier (confirmation de commande, rappel, promotion) devient un template à faire valider par Meta : soumettez-les tôt. Les codes à usage unique passent par la catégorie `AUTHENTICATION`, réservée aux entreprises vérifiées par Meta (ou passées par l'une de ses autres voies de montée en charge) : voir [envoyer un code OTP depuis Node.js](https://wa.genuka.com/docs/guides/whatsapp-otp-nodejs). 4. ### Recueillez l'accord de vos contacts N'écrivez qu'aux personnes qui ont accepté de recevoir vos messages sur WhatsApp, et arrêtez dès qu'elles se désinscrivent : la désinscription vous arrive par webhook. 5. ### Remplacez l'appel d'envoi et branchez les webhooks Créez une clé API, remplacez votre appel d'envoi (voir ci-dessous), puis déclarez l'URL de vos [webhooks](https://wa.genuka.com/docs/webhooks) et vérifiez leur signature avant de traiter quoi que ce soit : voir [recevoir messages et statuts par webhook](https://wa.genuka.com/docs/guides/receive-messages-webhooks). ### Que change le code d'envoi ? Avant, avec une session WAHA, un message libre part vers n'importe quel numéro : ```bash curl -X POST https://waha.example.com/api/sendText \ -H "X-Api-Key: $WAHA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "session": "default", "chatId": "237699001122@c.us", "text": "Bonjour Awa, votre commande CMD-1042 est expédiée." }' ``` Avec Genuka WA, le même message devient un template approuvé, dont vous ne fournissez que les variables : **curl** ```bash curl -X POST https://wa.genuka.com/api/v1/messages \ -H "Authorization: Bearer $GENUKA_WA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "connectionId": "cnx_...", "to": "+237699001122", "template": { "name": "confirmation_commande", "language": "fr", "variables": ["Awa", "CMD-1042"] } }' # { "data": { "messageId": "wamid.HBg..." } } ``` **Node.js** ```js const res = await fetch("https://wa.genuka.com/api/v1/messages", { method: "POST", headers: { Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ connectionId: "cnx_...", to: "+237699001122", template: { name: "confirmation_commande", language: "fr", variables: ["Awa", "CMD-1042"], }, }), }); const body = await res.json(); if (!res.ok) { // Par exemple 403 recipient_opted_out, 402 plan_limit_messages ; `message` est facultatif throw new Error(`${res.status} ${body.error}${body.message ? `: ${body.message}` : ""}`); } console.log(body.data.messageId); // "wamid.HBg..." ``` **Python** ```python import os import requests res = requests.post( "https://wa.genuka.com/api/v1/messages", headers={"Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}"}, json={ "connectionId": "cnx_...", "to": "+237699001122", "template": { "name": "confirmation_commande", "language": "fr", "variables": ["Awa", "CMD-1042"], }, }, timeout=10, ) res.raise_for_status() print(res.json()["data"]["messageId"]) # "wamid.HBg..." ``` **PHP** ```php true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("GENUKA_WA_API_KEY"), "Content-Type: application/json", "User-Agent: ma-boutique/1.0", ], CURLOPT_POSTFIELDS => json_encode([ "connectionId" => "cnx_...", "to" => "+237699001122", "template" => [ "name" => "confirmation_commande", "language" => "fr", "variables" => ["Awa", "CMD-1042"], ], ]), ]); $body = json_decode(curl_exec($ch), true); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($status !== 200) { $msg = $body['message'] ?? ''; throw new RuntimeException(trim("$status {$body['error']} $msg")); } echo $body["data"]["messageId"]; // "wamid.HBg..." ``` Pour répondre à un client qui vous a écrit dans les dernières 24 heures, remplacez `template` par `text` : un message libre suffit. Hors de cette fenêtre, l'API répond quand même `200`, avec un champ `warning` (`outside_service_window`, ou `unverified_service_window` si aucun message entrant de ce contact n'est enregistré). Meta ne livre pas le message, et le signale en général ensuite par un statut `failed` avec l'erreur [`131047`](https://wa.genuka.com/docs/errors/131047) sur vos webhooks. Tous les types de messages sont décrits dans [Envoyer des messages](https://wa.genuka.com/docs/messages). ## FAQ ### Une API WhatsApp non officielle est-elle légale ? Elle enfreint les Conditions d'utilisation de WhatsApp, que WhatsApp fait respecter en suspendant ou en résiliant l'accès au service. Pour le reste, comme la protection des données ou la prospection, les règles de votre pays s'appliquent quel que soit l'outil. ### Mon numéro sera-t-il forcément banni ? Non, mais personne ne peut vous garantir le contraire, et nous n'avons trouvé aucun taux de bannissement publié. Les outils eux-mêmes citent les facteurs qui l'augmentent : un numéro récent, des envois en masse, des destinataires qui ne répondent pas ou qui se plaignent. ### Peut-on garder son numéro en passant à l'API officielle ? Oui si le numéro tourne sur l'application WhatsApp Business : la coexistence de Meta le connecte à la Cloud API sans toucher à l'application. Un numéro inscrit sur WhatsApp classique doit d'abord être libéré. Dans les deux cas, la session non officielle doit disparaître. ### L'API officielle permet-elle d'écrire dans des groupes WhatsApp ? Oui, dans une certaine mesure : Meta propose une Groups API sur la Cloud API, ouverte aux comptes Official Business Account, avec 8 participants au plus par groupe, qui rejoignent par lien d'invitation. Elle n'est pas disponible sur un numéro qui utilise aussi l'application WhatsApp Business. Genuka WA ne l'expose pas : il envoie des messages individuels, des templates et des campagnes. En coexistence, les discussions de groupe de l'application ne sont pas synchronisées. ### Combien coûte l'API officielle avec Genuka WA ? Deux étages : Meta facture vos messages payants à votre compte WhatsApp Business, selon leur catégorie et le pays du destinataire, et Genuka facture un abonnement par numéro, à partir de 5 000 FCFA ou 19 $ par mois, sans marge sur les messages. Voir [Forfaits et facturation](https://wa.genuka.com/docs/billing). ## Sources Consultées le 8 octobre 2026. * [WhatsApp, Conditions d'utilisation](https://www.whatsapp.com/legal/terms-of-service) * [WhatsApp, politique de messagerie WhatsApp Business](https://whatsappbusiness.com/policy/) * [Baileys, dépôt GitHub et README](https://github.com/WhiskeySockets/Baileys) * [Baileys, ticket #2850 : comptes bannis après des envois en masse](https://github.com/WhiskeySockets/Baileys/issues/2850) * [whatsapp-web.js, dépôt GitHub et README](https://github.com/pedroslopez/whatsapp-web.js) * [WAHA, présentation](https://waha.devlike.pro/) * [WAHA, moteurs](https://waha.devlike.pro/docs/how-to/engines/) * [WAHA, envoyer des messages](https://waha.devlike.pro/docs/how-to/send-messages/) * [Evolution API, dépôt GitHub et README](https://github.com/EvolutionAPI/evolution-api) * [Green API, présentation et tarifs](https://green-api.com/en/) * [Green API, avant de commencer](https://green-api.com/en/docs/before-start/) * [Green API, protéger un numéro contre le bannissement](https://green-api.com/en/docs/faq/how-to-protect-number-from-ban/) * [Whapi.Cloud, présentation et FAQ](https://whapi.cloud/) * [Whapi.Cloud, tarifs](https://whapi.cloud/price) * [Meta, templates de message](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview) * [Meta, limites d'envoi](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits) * [Meta, présentation de la WhatsApp Business Platform (Cloud API)](https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform) * [Meta, Groups API](https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/) * [Meta, onboarding des utilisateurs de l'application WhatsApp Business (coexistence)](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) * [Meta, tarifs de la WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing) * [Meta, facturation des messages de service à partir du 1er octobre 2026](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/non-template-messages) * [WATI, Understanding Wati's pricing structure (1 000 messages de service gratuits par numéro et par mois)](https://support.wati.io/en/articles/11462993-understanding-wati-s-pricing-structure) * [Trengo, changements de tarifs WhatsApp au 1er octobre 2026](https://help.trengo.com/article/whatsapp-pricing-changes-from-1-october-2026)