API WhatsApp officielle vs non officielles (WAHA, Baileys…)

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

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.

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.

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.
• 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, 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.

Comment passer d'une API non officielle à l'API officielle ?

Que change le code d'envoi ?

Avant, avec une session WAHA, un message libre part vers n'importe quel numéro :

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": "[email protected]",
    "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 -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..." } }

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 sur vos webhooks. Tous les types de messages sont décrits dans Envoyer des 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.

Sources

Consultées le 8 octobre 2026.

• WhatsApp, Conditions d'utilisation
• WhatsApp, politique de messagerie WhatsApp Business
• Baileys, dépôt GitHub et README
• Baileys, ticket #2850 : comptes bannis après des envois en masse
• whatsapp-web.js, dépôt GitHub et README
• WAHA, présentation
• WAHA, moteurs
• WAHA, envoyer des messages
• Evolution API, dépôt GitHub et README
• Green API, présentation et tarifs
• Green API, avant de commencer
• Green API, protéger un numéro contre le bannissement
• Whapi.Cloud, présentation et FAQ
• Whapi.Cloud, tarifs
• Meta, templates de message
• Meta, limites d'envoi
• Meta, présentation de la WhatsApp Business Platform (Cloud API)
• Meta, Groups API
• Meta, onboarding des utilisateurs de l'application WhatsApp Business (coexistence)
• Meta, tarifs de la WhatsApp Business Platform
• Meta, facturation des messages de service à partir du 1er octobre 2026
• WATI, Understanding Wati's pricing structure (1 000 messages de service gratuits par numéro et par mois)
• Trengo, changements de tarifs WhatsApp au 1er octobre 2026