La plupart des projets d'intégration WhatsApp s'enlisent au même endroit, et jamais sur la partie budgétée. La messagerie fonctionne dès le premier après-midi. Ce qui prend les semaines restantes, c'est la plomberie autour : quel numéro vous pouvez utiliser, à qui il appartient, où vit la preuve du consentement, sur quelle identité vous rattachez les clients, et ce que votre système doit savoir d'une horloge de 24 heures qu'il ne contrôle pas.
Ce guide décrit ce qu'exige réellement le raccordement de l'API WhatsApp Business à une stack existante : les décisions coûteuses à défaire, les contraintes qui se comportent comme des problèmes d'ingénierie plutôt que comme des règles, et les cas où il ne faut pas intégrer du tout.
Le numéro est un engagement, pas un réglage
Un numéro de téléphone ne peut être relié qu'à un seul Business Solution Provider à la fois. Ce seul fait commande la plupart des décisions initiales.
Utilisez un numéro dédié qui n'est pas déjà actif sur WhatsApp. Un numéro qui fait déjà tourner l'application grand public ou l'application WhatsApp Business doit être migré, et migrer signifie une interruption sur ce numéro. Y faire passer votre ligne principale sans planification, c'est découvrir la contrainte un lundi matin.
Attendez-vous à une étape de vérification avant les vrais volumes. La vérification d'entreprise dans le Business Manager de Meta est ce qui vous fait dépasser le palier de départ : tant qu'elle n'est pas passée, vous êtes limité à un petit nombre de destinataires uniques par jour — suffisant pour tester, inutile pour une campagne. Lancez-la tôt : elle réclame des documents d'entreprise et un site vérifiable, et c'est l'étape la plus susceptible d'attendre quelqu'un d'autre.
Décidez à qui appartient l'actif. Si le BSP détient le numéro pour votre compte, partir plus tard exige une portabilité, pas un export. Posez la question avant de signer, pas quand vous voulez sortir. Les mécaniques du changement sont dans choisir un BSP WhatsApp.
Le consentement est un enregistrement, pas une case
Toute intégration a besoin d'un endroit où vit l'opt-in, et ce doit être un enregistrement que vous pourriez montrer : qui a consenti, quand, depuis quelle surface, à quel texte.
L'erreur est de stocker un booléen. Un booléen dit que le client est inscrit ; il ne dit pas si vous pouvez le prouver, et il ne résiste pas à la question du canal — un consentement recueilli pour l'e-mail ne s'étend pas à WhatsApp. Conservez l'horodatage, la source et le texte exact affiché, et rattachez le tout au contact plutôt qu'à un journal de formulaires que personne ne peut interroger.
Les règles elles-mêmes, et la façon de les documenter sous le RGPD, sont dans notre guide de l'opt-in WhatsApp.
Le problème d'identité que personne n'anticipe
WhatsApp est indexé sur le numéro de téléphone. La plupart des stacks e-commerce et des CRM sont indexés sur l'e-mail. Intégrer les deux revient à décider, explicitement, ce qu'est un client.
Les doublons apparaissent immédiatement : la même personne en fiche e-mail seule et en fiche téléphone seule. Vous trouverez des numéros enregistrés dans cinq formats, certains sans indicatif, qui ne correspondent à rien tant qu'ils ne sont pas normalisés en E.164. Et vous trouverez des clients dont le numéro WhatsApp n'est pas celui de la commande.
Normalisez à l'écriture, pas à la lecture, et décidez d'emblée si la clé primaire d'une conversation est le numéro ou l'identifiant CRM. Le faire après quelques milliers de conversations, c'est une migration.
La fenêtre de 24 heures est une contrainte d'ingénierie
Les documents de politique décrivent la fenêtre de service client comme une règle. Dans votre système, elle se comporte comme un état : quand un client vous écrit, une fenêtre s'ouvre, et tant qu'elle est ouverte vous répondez librement ; une fois fermée, le joindre à nouveau exige un modèle pré-approuvé, qui coûte de l'argent et possède une catégorie.
Votre application doit donc savoir si une fenêtre est ouverte avant de décider comment envoyer. Les systèmes qui sautent cette étape envoient tout en modèle et paient des messages qui pouvaient être gratuits, ou tentent des réponses libres qui échouent silencieusement. Dans les deux cas, le bug reste invisible sur un tableau de bord jusqu'à l'arrivée de la facture.
Les modèles ajoutent leur propre état : chacun est soumis à approbation, et l'approbation n'est pas instantanée. Mettez en file tout ce qui est daté bien avant l'échéance. Les mécaniques de la fenêtre et des types de messages sont dans la fenêtre de 24 heures et le marketing via l'API WhatsApp Business.
Ce qui revient, et où cela doit atterrir
Une intégration qui ne fait qu'envoyer est à moitié construite. Décidez avant le lancement de ce que reçoit le reste de la stack :
L'état de remise et de lecture par message, rattaché au client — sinon vous ne distinguez pas une campagne ratée d'une campagne impopulaire.
Les messages entrants, routés là où un humain les voit. C'est l'exigence que les équipes sous-estiment : ouvrir un canal crée l'obligation d'y répondre.
La conversation elle-même, ou au moins un résumé, sur la fiche client. Des conseillers qui ne voient pas ce que l'assistant automatique a déjà dit le contrediront.
Ce qui casse au deuxième mois
La note de qualité. Meta note votre numéro selon la réaction des destinataires : blocages et signalements la font baisser, et une note faible réduit vos limites d'envoi. C'est le mécanisme qui sanctionne les listes achetées et le sur-envoi, et il se dégrade progressivement au lieu d'échouer bruyamment.
Le modèle refusé au pire moment. Un modèle qui sonne marketing mais a été soumis en utilitaire est refusé ou reclassé, et la campagne qui en dépendait rate sa fenêtre.
Personne pour répondre. L'échec le plus courant est organisationnel, pas technique : le volume entrant arrive et il n'y a pas de permanence. Un WhatsApp sans réponse est pire, pour le client, que pas de WhatsApp du tout.
Quand ne pas intégrer
Si vos volumes mensuels sont faibles et que votre usage est la conversation individuelle, l'application WhatsApp Business gratuite suffit et l'API n'est qu'une complexité inutile. L'API se justifie quand il faut de l'automatisation, plusieurs agents sur un même numéro, ou un lien avec vos données de commande.
Si personne ne peut tenir la boîte, ne l'ouvrez pas. Si votre liste n'a pas été collectée avec un consentement pour ce canal, ne l'importez pas : la note de qualité vous rattrapera. Et si le seul objectif est la diffusion de masse, vérifiez d'abord l'équation économique : chaque message initié par l'entreprise a un prix, traité dans ce que coûte l'API WhatsApp Business.
L'ordre qui marche
Numéro et vérification d'abord, car ils comportent des délais externes. Enregistrement du consentement ensuite, car une preuve ne se reconstitue pas après coup. Normalisation des identités en troisième, avant que le volume n'en fasse une migration. Puis l'envoi conscient de la fenêtre, puis les modèles, puis l'automatisation. Les équipes qui inversent cet ordre livrent une démo en une semaine et passent un trimestre à la rendre sûre.
Pour la couche de conciergerie qui vient par-dessus une fois la plomberie en place, voir le WhatsApp AI Concierge de TikJoy.