WhatsApp API : les 2 façons de la brancher sur ton SaaS

Tu as commenté « WhatsApp API officiel » sous ma vidéo — voici le document que je t'ai promis. On va aller au fond des deux façons de brancher WhatsApp sur ton SaaS : ce que chacune permet, ce qu'elle coûte vraiment, et le risque que personne ne te dit avant que ce soit trop tard.

Il n'y a que 2 routes — pas dix

Peu importe le tutoriel que tu vas croiser, tout se ramène à deux mécanismes. Soit ton code se fait passer pour un téléphone et parle à WhatsApp par la porte de derrière, soit il parle à Meta par la porte d'entrée, avec une autorisation. Tout le reste — les noms d'outils, les prix, les SDK — n'est qu'une variation de ces deux-là.

• Route 1 — non officielle : une librairie open source qui simule WhatsApp Web. Gratuite, immédiate, réversible… et hors des règles de Meta.
• Route 2 — officielle : tu passes par un partenaire agréé Meta, tu obtiens un vrai accès API, et ton numéro est reconnu comme légitime.

Route 1 — Baileys : gratuit, open source, et ça marche vraiment

Baileys est une librairie TypeScript open source. Elle ne pilote pas un navigateur caché et n'a besoin ni de Chrome ni de Selenium : elle parle directement le protocole WebSocket multi-appareils de WhatsApp. Tu l'installes dans ton projet Node, tu la donnes à Claude pour qu'il te génère l'intégration, et en une soirée tu as un numéro qui répond tout seul.

La connexion se fait comme quand tu ouvres WhatsApp Web : un code QR à scanner, ou un code d'appairage à saisir depuis le téléphone. Ta session est ensuite sauvegardée en local et se rouvre toute seule.

• Envoyer et recevoir des messages texte, images, documents, audio
• Lire les accusés de réception et le statut « en ligne »
• Gérer des groupes, réagir, répondre en citation
• Brancher tout ça sur ton SaaS ou sur un workflow n8n
• Zéro coût par message, zéro abonnement

Et il n'y a pas que Baileys : whatsapp-web.js, Venom et WPPConnect fonctionnent sur le même principe. Plus loin, des services payants revendent exactement cette technique derrière une API propre, entre 6 et 45 $ par mois avec « messages illimités ». Même mécanisme, même risque — simplement emballé.

Le vrai problème : ce n'est pas Meta qui te parle

C'est le point que la plupart des tutoriels sautent. Ces librairies fonctionnent parce qu'elles imitent un vrai téléphone — donc elles violent les conditions d'utilisation de WhatsApp. Meta sait parfaitement que ces projets existent : le comportement d'un serveur ne ressemble pas à celui d'un humain, et il est détectable. Les fournisseurs qui revendent cette méthode l'écrivent eux-mêmes dans leurs propres avertissements.

Il n'y a pas de préavis, pas de support à contacter, pas de recours. Le numéro est suspendu ou banni, et l'historique de conversations part avec lui.

Le jour où le numéro saute, ce n'est pas ton code qui tombe. C'est le business de ton client — et c'est toi qu'il appelle.

Donc mon avis honnête : Baileys est excellent pour apprendre, pour un prototype, pour un outil interne, ou pour ton propre numéro secondaire dont tu acceptes de perdre l'accès. Le jour où tu le mets sur le numéro d'un client qui paye, tu ne vends plus une automatisation — tu vends une dette.

Route 2 — passer par un partenaire officiel Meta

L'autre route, c'est l'API officielle WhatsApp Business. Meta ne la distribue pas directement au premier venu : elle passe par des partenaires agréés, qui portent la conformité, la validation des modèles de message et la facturation. Tu envoies tes requêtes au partenaire, le partenaire parle à Meta, et ton trafic est légitime de bout en bout.

• Le numéro est déclaré chez Meta — il ne peut pas être banni pour usage automatisé
• Un vrai statut par message : envoyé, distribué, lu
• Des webhooks pour recevoir les messages entrants dans ton application
• Le badge de compte professionnel et le nom vérifié affiché au client
• Des volumes qui montent sans que le numéro devienne suspect

La contrepartie est réelle et je ne vais pas te la cacher : tu ne peux plus écrire n'importe quoi n'importe quand. Si le client t'a écrit dans les 24 dernières heures, tu réponds librement en texte brut. En dehors de cette fenêtre, tu dois passer par un modèle de message validé par Meta — et c'est ce modèle qui est facturé, au tarif que Meta publie lui-même.

Twilio — la référence mondiale, pensée pour ailleurs

Si tu cherches en anglais, tu tomberas sur Twilio en premier. C'est solide, la documentation est excellente, et personne ne peut leur reprocher leur fiabilité. Le problème n'est pas la qualité : c'est que rien là-dedans n'a été pensé pour un développeur qui construit pour l'Afrique.

• Aucun numéro local en vente au Cameroun ni au Sénégal — tu ne peux acheter que des numéros internationaux, à partir de 1,15 $ par mois. Ton client voit un indicatif étranger.
• Facturation en dollars, carte bancaire internationale obligatoire — pas de Mobile Money.
• Sur la vérification par SMS, Twilio Verify fait revenir un numéro camerounais à environ 220 FCFA le contrôle (0,05 $ + 0,317 $ de SMS aux tarifs officiels).
• Le support est sur un autre fuseau, dans une autre langue, et ne connaît pas ton marché.

Et ce n'est pas propre à Twilio. La majorité des plateformes officielles internationales — Wati, 360dialog, Bird et les autres — ajoutent en plus un abonnement de plateforme de 29 à 249 $ par mois, qui se cumule au prix par message. Tu payes pour exister avant d'avoir envoyé un seul message.

Geskap — l'API officielle, sur ton propre numéro, en FCFA

C'est la route que j'utilise tous les jours, et je ne t'en parle pas en théorie. Geskap est partenaire Meta et distribue l'API officielle — donc exactement la même porte d'entrée que Twilio, mais branchée sur le numéro camerounais que ton client a déjà, avec un tarif en FCFA, un paiement Mobile Money, et un interlocuteur qui répond dans ta langue et sur ton fuseau.

Pour un développeur, l'accès se fait par une API REST classique. Tu crées une clé sk_live_, tu appelles `wa-api.geskap.com` — la référence complète des endpoints est publique — et tu construis ce que tu veux par-dessus.

• POST /v1/messages — envoyer un modèle approuvé à un destinataire, réponse 202, avec idempotence et remboursement automatique en cas d'échec
• POST /v1/messages/reply — répondre librement dans la fenêtre de 24h, et c'est gratuit
• Gestion complète de tes modèles : création, soumission à Meta, statut en direct
• Webhooks signés en HMAC : message.status et message.inbound arrivent directement dans ton application
• Solde en jetons prépayés, rechargeable par Mobile Money (CamPay) ou par carte
• Une clé peut être limitée à un seul numéro — pratique quand tu gères plusieurs clients

Deux précisions d'honnêteté technique, parce que je préfère que tu le saches avant d'écrire ton code plutôt qu'après. Il n'y a pas d'endpoint de diffusion de masse : c'est ta plateforme qui boucle sur POST /v1/messages, et c'est très bien ainsi, tu gardes le contrôle du rythme. Et l'agent qui répond, c'est toi qui l'écris — l'API te livre le message entrant sur ton webhook, la logique t'appartient.

Ce que ça coûte, concrètement

Le modèle est simple à comprendre parce qu'il n'y a pas d'abonnement de plateforme : tu payes ce que tu envoies. Le jeton coûte environ 50 FCFA, et chaque catégorie de message consomme un nombre de jetons connu à l'avance.

• Message utilitaire (confirmation de commande, suivi de livraison, rappel) — 1 jeton, soit environ 50 FCFA de frais de plateforme
• Message marketing — 3 jetons, soit environ 150 FCFA
• Réponse dans la fenêtre de 24h — gratuite
• Vérification de numéro par code (OTP) — de 10 à 5 FCFA selon le palier, contre environ 220 FCFA par SMS chez un fournisseur international
• Aucun abonnement de plateforme, aucune commission sur les ventes que ton application génère

Si tu veux un ordre de grandeur qui parle : la vérification de numéro revient entre 20 et 44 fois moins cher que le SMS classique. Sur une application qui inscrit des utilisateurs tous les jours, ce seul poste change la viabilité du produit.

Le comparatif, sans enrobage

• Baileys et les librairies open source — coût zéro, mise en route en une soirée, aucune limite de format. En échange : hors conditions Meta, numéro bannissable du jour au lendemain, aucun recours, aucun statut de livraison fiable. À réserver aux prototypes et aux outils internes.
• Twilio et les grandes plateformes internationales — officiel et fiable, mais aucun numéro local au Cameroun, facturation en dollars par carte, et souvent un abonnement de plateforme de 29 à 249 $ par mois en plus du prix par message.
• Geskap — la même API officielle Meta, sur le numéro local que ton client possède déjà, facturée en FCFA au message sans abonnement, payable en Mobile Money, avec un support qui parle ta langue.

Ce que je te conseille de faire maintenant

Monte ton prototype avec Baileys si tu veux comprendre le mécanisme — c'est formateur et ça ne coûte rien. Mais le jour où un client paye, bascule sur l'officiel. Ce n'est pas une question de prix, c'est une question de ce que tu es capable de garantir : un numéro qui ne saute pas. C'est exactement ce qu'on construit ensemble dans ma formation n8n + Claude + WhatsApp.

Et si tu veux voir la route officielle construite en entier plutôt que décrite — de la création du compte au premier message réellement envoyé, avec n8n par-dessus — c'est exactement ce que je fais dans cette vidéo.

Pour demander ton accès développeur à l'API officielle, la liste d'attente est sur geskap.com/api-meta. L'accès s'ouvre par vagues, et le plus simple pour être pris dans la prochaine reste de laisser ton besoin en clair dans le formulaire.

Pour aller plus loin

• La formation n8n + Claude + WhatsApp — la route officielle construite de bout en bout, avec 4 cas d'usage réels
• Toutes mes vidéos — les tutoriels WhatsApp, n8n et automatisation, classés par problème
• Le bloc sur les 3 outils IA pour créer du contenu — si c'est le contenu et pas l'API qui te bloque
• La communauté — là où je réponds aux questions techniques entre deux vidéos

La vraie différence entre les deux routes n'est pas le prix. C'est de savoir si tu peux dormir la nuit où ton client lance sa campagne.