API WhatsApp Business #

Connectez votre entreprise à WhatsApp via l’API officielle WhatsApp Business. Ce canal est le choix recommandé pour les entreprises qui ont besoin d’une messagerie WhatsApp fiable et à haut volume, avec des modèles de message pré-approuvés et un suivi de livraison.

Aucun compte Twilio distinct n’est requis. Twilio est le service de téléphonie et de messagerie qui achemine vos messages WhatsApp en arrière-plan. La plateforme crée automatiquement un compte Twilio géré pour vous, vous n’avez donc pas besoin de vous inscrire vous-même sur Twilio ni de le connecter manuellement à Meta. L’achat d’un numéro ou la connexion d’un numéro existant s’effectue entièrement au sein de l’application. Si vous avez spécifiquement besoin d’utiliser votre propre compte Twilio (par exemple, si vous y avez déjà des numéros actifs et des modèles approuvés), ouvrez la carte Compte Twilio sur la page Canaux et basculez vers votre propre compte, puis rattachez votre expéditeur existant — ces deux étapes sont décrites dans Fournisseur SMS (Apportez votre propre compte Twilio). La plupart des utilisateurs devraient conserver la configuration gérée.

Prérequis #

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un compte Meta Business (business.facebook.com) — la vérification de l’entreprise est facultative : les entreprises non vérifiées peuvent activer un numéro, faire approuver des modèles et envoyer des diffusions, en commençant par la limite de 250 contacts uniques par tranche de 24 heures (voir Limites de messagerie ci-dessous)
• Un compte avec des crédits suffisants
• Un numéro de téléphone qui n’est pas déjà enregistré sur WhatsApp (application personnelle ou Business), et qui n’est pas déjà un numéro Twilio provenant d’un autre compte

Ajoutez d’abord le nom et l’adresse de votre entreprise. Avant de pouvoir acheter votre premier numéro, renseignez le nom et l’adresse de votre entreprise sous Paramètres → Entreprise (groupe Espace de travail). L’opérateur valide cette adresse, assurez-vous donc qu’elle soit exacte et complète — l’achat échouera tant qu’elle ne sera pas définie.

Étape 1 : Acheter un numéro de téléphone #

1. Dans la barre latérale gauche, cliquez sur Paramètres près du bas.
2. Dans le menu de gauche des paramètres, sous Canaux, cliquez sur Canaux.
3. Trouvez la carte WhatsApp Business API et cliquez sur le bouton vert Connecter WhatsApp.
4. Choisissez Obtenir un nouveau numéro auprès de nous, puis Géré par nous.

4. Une fenêtre contextuelle Acheter un numéro de téléphone s’ouvre. Choisissez un pays — les numéros et les tarifs en temps réel proviennent directement de notre opérateur pour ce pays — et filtrez éventuellement par Contient des chiffres.

5. Parcourez la liste des numéros disponibles qui s’affiche, chacun indiquant son coût d’achat unique et son coût mensuel.

6. Cliquez sur un numéro et remplissez son Nom d’affichage — le nom de l’entreprise que les gens voient sur WhatsApp. Il doit contenir des lettres ; un numéro de téléphone seul est rejeté. Confirmez ensuite le coût affiché et finalisez l’achat.

Un numéro acheté ici est destiné à WhatsApp, pas aux SMS. Les numéros achetés via la plateforme sont utilisés pour WhatsApp Business. Ce ne sont pas des numéros SMS, et ce ne sont pas non plus des numéros d’appel : un appel entrant aboutit sur un répondeur automatique (présent pour répondre à l’appel de vérification de WhatsApp lors de la configuration), il n’y a pas de boîte vocale à consulter, et vous ne pouvez pas émettre d’appels depuis ce numéro. Les SMS fonctionnent sur votre propre compte Twilio — voir SMS. Ne dites pas aux clients qu’un numéro acheté peut faire les deux ; ce n’est pas le cas.

Des crédits sont déduits de votre compte pour l’achat. Chaque numéro a ensuite un loyer mensuel pour rester actif : au moins 50 crédits par mois, et les numéros premium coûtent plus cher, conformément aux tarifs de l’opérateur. La carte du numéro dans Paramètres → Canaux affiche toujours son prix mensuel exact, et la boîte de dialogue d’achat l’indique avant que vous ne confirmiez.

Ce loyer est le seul frais mensuel pour le numéro — il inclut la connexion WhatsApp, il n’y a donc rien de plus à payer pour conserver le numéro sur WhatsApp. Si vous louez déjà des numéros ici, ils passeront à ce tarif lors de leur prochain cycle de facturation. Voir Numéros de téléphone.

Mexique et Argentine : seuls les numéros mobiles sont proposés pour ces pays. WhatsApp traite les numéros de ces pays comme des numéros mobiles, et seul un numéro mobile peut recevoir le code de vérification de WhatsApp — les numéros de type ligne fixe ne le peuvent pas, ils ne sont donc pas listés. Cela signifie également que l’indicatif de ville peut différer du vôtre ; cela n’affecte pas le fonctionnement de votre WhatsApp.

Étape 2 : Connecter le numéro à Meta #

Un numéro acheté doit encore être activé auprès de Meta avant de pouvoir envoyer et recevoir des messages :

1. Sur la page Canaux, la carte WhatsApp Business API affiche votre nouveau numéro dans sa liste.
2. Cliquez sur l’action de connexion propre au numéro (Terminer la configuration) — une fenêtre contextuelle Meta s’ouvre où vous terminez la connexion avec le compte Meta qui possède votre compte WhatsApp Business, en suivant les instructions de Meta.
3. Lorsque Meta confirme la connexion, le numéro est automatiquement mis en ligne — il n’y a pas d’étape d’« annonce » distincte. Son statut passe automatiquement à Actif une fois la connexion établie.

Il vous sera demandé de vous connecter à votre compte Meta Business et d’autoriser la plateforme à envoyer et recevoir des messages WhatsApp en votre nom.

L’activation est généralement automatique. Cela prend quelques minutes, et dans la plupart des cas, vous n’aurez pas besoin d’appel ou de code de vérification. Parfois, Meta garde le numéro en statut « En attente » ; si cela se produit, suivez l’invite à l’écran pour vérifier par appel téléphonique. Si un numéro échoue à plusieurs reprises lors de l’enregistrement, WhatsApp peut le limiter temporairement — attendez 24 heures et réessayez, ou contactez le support.

Vous avez déjà votre propre numéro Meta Cloud API ? #

Vous n’êtes pas obligé d’acheter via la plateforme. Sur la carte WhatsApp Business API, cliquez sur Connecter WhatsApp, choisissez Utiliser un numéro que vous possédez déjà, puis Géré par nous pour ouvrir la fenêtre modale Connecter WhatsApp Business API :

1. Saisissez le numéro de téléphone au format international (par ex. +1 555 123 4567).
2. Vous pouvez également saisir un nom d’affichage — le nom qui sera visible par les personnes que vous contactez sur WhatsApp.
3. Cliquez sur Continuer vers WhatsApp pour terminer la connexion dans la fenêtre de Meta.

Nous vous recommandons vivement de NE PAS connecter votre numéro WhatsApp Business personnel actif — le connecter ici pourrait perturber votre application WhatsApp existante. Utilisez un nouveau numéro.

Dans la fenêtre de Meta, ajoutez et vérifiez votre propre numéro. Ne choisissez pas le numéro de test gratuit de Meta (il commence par +1 555) — il ne peut envoyer des messages qu’à une poignée de contacts de test ajoutés manuellement, il ne pourra donc jamais atteindre de vrais clients. Si vous saisissez ou sélectionnez le numéro de test de Meta, la connexion sera rejetée.

Déplacer un numéro actuellement utilisé sur l’application WhatsApp #

Un numéro activement enregistré dans l’application WhatsApp ou WhatsApp Business ne peut pas être connecté à l’API ; vous devez d’abord le libérer de l’application. Procédez dans cet ordre :

1. Enregistrez d’abord tout ce dont vous avez besoin depuis l’application. L’historique des discussions n’est pas transféré vers l’API, et la suppression du compte est définitive : exportez ou sauvegardez les conversations importantes avant de continuer.
2. Désactivez la vérification en deux étapes dans l’application (Paramètres → Compte → Vérification en deux étapes), afin que l’ancien code PIN n’interfère pas avec l’enregistrement sur l’API.
3. Supprimez le compte dans l’application : Paramètres → Compte → Supprimer mon compte. Cela libère le numéro ; un numéro ne peut être utilisé que sur l’application ou sur l’API, jamais les deux en même temps.
4. Attendez quelques minutes que la libération soit effective, puis suivez les étapes de connexion ci-dessus pour connecter le numéro.

Vous souhaitez votre propre compte WhatsApp Business sans la configuration développeur ? #

Via notre application Meta est une autre réponse à la deuxième question du même bouton Connecter WhatsApp. Vous conservez votre propre compte WhatsApp Business, mais vous ne créez rien sur le site développeur de Meta — vous utilisez notre application Meta. Meta facture les conversations directement sur votre propre compte WhatsApp Business. Si vous apportez votre propre numéro : 50 crédits par mois de notre part pour la connexion. Si vous louez votre numéro ici : aucun supplément, car la location du numéro couvre déjà la connexion. Voir Connecter via notre application Meta.

Vous préférez utiliser WhatsApp sur votre propre application Meta ? #

Il existe une autre option pour les utilisateurs techniques et les agences : créez votre propre application sur le site développeur de Meta et connectez-la directement. Meta vous facture à ses propres tarifs, il n’y a pas de frais par message de notre part, et vos clients ne voient que le nom de votre entreprise. La procédure complète se trouve dans Connectez votre propre application Meta.

Sur toute connexion utilisant votre propre compte WhatsApp Business, Meta facture les messages — pas nous. Cela inclut la connexion de votre propre numéro Géré par nous ci-dessus, Via notre application Meta, et votre propre application Meta. Meta facture le mode de paiement associé à ce compte WhatsApp Business, et s’il n’y en a pas de valide, Meta bloque les diffusions, les campagnes et les modèles de messages jusqu’à ce que vous en ajoutiez un. Lisez Coûts WhatsApp et le changement d’octobre 2026 avant votre premier envoi — cela couvre également le changement de tarification prévu pour le 1er octobre 2026.

Pièges à éviter lors de la connexion #

Quelques problèmes piègent la plupart des nouveaux utilisateurs lors du processus de connexion à Meta. Lisez ceci avant de commencer l’activation.

Choisissez votre propre numéro, pas le numéro de test de Meta #

Pendant le processus de connexion à Meta, Meta vous proposera un numéro de téléphone de test (un numéro exemple dans la plage +1 555) ainsi que l’option d’utiliser le vôtre. Utilisez toujours le vôtre. Le numéro de test de Meta peut recevoir des messages, mais ne peut en envoyer qu’à une poignée de numéros que vous ajoutez manuellement dans Meta. Il ne pourra donc jamais envoyer de messages à de vrais clients — chaque réponse échoue silencieusement. L’application bloque cela : si vous saisissez ou sélectionnez le numéro de test de Meta, la connexion est rejetée et vous êtes invité à utiliser un vrai numéro à la place.

Votre numéro doit se trouver dans le compte WhatsApp Business #

C’est la raison la plus fréquente pour laquelle une connexion échoue à la toute dernière étape. Choisir le numéro de test de Meta, ou ignorer l’étape du numéro de téléphone, laisse le compte WhatsApp Business que vous avez sélectionné sans votre numéro — et il n’y a alors rien à connecter pour nous.

À l’étape du numéro de téléphone dans la fenêtre Meta :

1. Choisissez d’ajouter un nouveau numéro.
2. Saisissez votre numéro.
3. Vérifiez-le avec le code que Meta vous envoie par SMS ou par appel.

Une fois l’opération effectuée correctement, votre numéro apparaît sous Numéros de téléphone dans ce compte dans le Gestionnaire WhatsApp, marqué comme vérifié. Si la connexion échoue, l’application vous indique exactement ce qui s’est passé.

En cas d’échec, ne supprimez pas et ne recréez pas les éléments #

Lorsqu’une connexion échoue, il est tentant de supprimer le compte WhatsApp Business et de recommencer. Ne le faites pas. Supprimer un compte auquel votre numéro est rattaché rend généralement le problème plus difficile à résoudre, et des tentatives de connexion répétées peuvent entraîner le blocage temporaire d’un numéro par WhatsApp — ce qui peut devenir permanent. Lisez le message d’erreur : il nomme le problème spécifique et l’étape suivante. Si la connexion ne fonctionne toujours pas, contactez le support avec le numéro de téléphone et l’erreur.

Chaque compte nécessite son propre compte WhatsApp Business #

Un compte WhatsApp Business ne peut être lié qu’à un seul compte de messagerie à la fois. Vous ne pouvez donc pas connecter un second numéro via le même compte WhatsApp Business à partir d’un compte différent ici — c’est le cas le plus fréquent pour une agence et l’un de ses sous-comptes, ou deux sous-comptes, pointant tous vers le même compte Business. Meta indique toujours que la connexion est réussie, car le numéro est effectivement vérifié et actif dans ce compte Business, mais l’activation s’arrête ici avec un message nommant le compte qui l’utilise déjà.

Deux solutions possibles :

• Connectez le numéro sur le compte qui utilise déjà ce compte WhatsApp Business. L’ajout de numéros supplémentaires fonctionne normalement à cet endroit.
• Attribuez à ce compte son propre compte WhatsApp Business. Recommencez la connexion et choisissez de créer un nouveau compte WhatsApp Business au lieu de sélectionner celui qui existe déjà. Supprimez d’abord le numéro de l’ancien compte Business dans le Meta Business Manager, car un numéro ne peut appartenir qu’à un seul d’entre eux.

Ne supprimez pas le compte WhatsApp Business existant pour le libérer — le numéro qui l’utilise déjà cesserait de fonctionner.

Ne réutilisez pas un compte WhatsApp Business déjà lié à un autre BSP #

Si votre compte WhatsApp Business (WABA) est déjà lié à un autre BSP (Business Service Provider — une autre plateforme qui s’y est connectée précédemment), la connexion échouera ici et ne pourra pas être corrigée en réessayant ; l’activation s’arrête avec un message indiquant que le compte Business est déjà lié ailleurs. Pour éviter cela, créez un nouveau compte WhatsApp Business dans le Meta Business Manager pour cette connexion, plutôt que d’en réutiliser un qui a été configuré ailleurs.

Étape 3 : Configurez votre profil WhatsApp Business #

Votre profil WhatsApp Business est ce que les clients voient lorsqu’ils interagissent avec votre entreprise.

1. Sur la page Canaux, trouvez votre numéro actif sur WhatsApp et ouvrez son éditeur de profil.
2. Remplissez :

3. Enregistrez pour mettre à jour votre profil.

Un agent par numéro #

Si votre compte possède plusieurs numéros WhatsApp Business API, chacun peut être pris en charge par un agent IA différent. Le panneau Qui répond aux nouvelles conversations sur la page des agents IA affiche un bloc par numéro pour WhatsApp avec un sélecteur pour chaque numéro connecté : Identique à WhatsApp suit l’agent du canal ; choisir un autre agent (ou Personne ne répond) s’applique uniquement à ce numéro. Les réponses sont toujours envoyées depuis le numéro auquel le client a envoyé un message. Détails : Points d’entrée → Un agent par numéro WhatsApp.

Comprendre les limites de messagerie #

WhatsApp impose des limites de messagerie pour protéger les utilisateurs contre le spam. Ces limites déterminent le nombre de contacts uniques auxquels vous pouvez envoyer des messages au cours d’une période glissante de 24 heures.

Système de paliers #

Comment augmenter vos limites #

• Faites vérifier votre entreprise sur Meta Business Manager pour dépasser la limite initiale de 250 contacts et atteindre 2 000.
• Maintenez une qualité de message élevée — évitez d’être signalé ou bloqué par les destinataires.
• Envoyez des messages de manière cohérente — WhatsApp augmente automatiquement votre niveau lorsque vous atteignez environ la moitié de votre limite actuelle avec de bonnes évaluations de qualité, généralement dans les 6 heures suivant le respect des critères.

Types de messages #

Messages de session (format libre) #

Texte régulier, images, vidéos, documents et autres médias que vous pouvez envoyer dans une fenêtre de conversation active.

• Peut inclure n’importe quel contenu
• Ne peut être envoyé que dans la fenêtre de messagerie de 24 heures (voir ci-dessous)
• Aucune pré-approbation requise

Messages modèles #

Formats de messages pré-approuvés qui vous permettent d’initier des conversations avec les clients en dehors de la fenêtre de 24 heures.

• Doivent être soumis à Meta pour approbation avant utilisation
• Prennent en charge des variables pour la personnalisation (par ex. nom du client, numéro de commande)
• Requis pour initier de nouvelles conversations ou relancer après 24 heures
• Disponibles en plusieurs langues

Les modèles disposent désormais de leur propre page — consultez Modèles de message WhatsApp pour une présentation complète.

La fenêtre de messagerie de 24 heures #

WhatsApp impose une fenêtre de conversation de 24 heures pour protéger les utilisateurs :

• Lorsqu’un client vous envoie un message, une fenêtre de 24 heures s’ouvre. Durant cette période, vous pouvez envoyer librement tout type de message (messages de session).
• Après 24 heures d’inactivité (aucun message du client), la fenêtre se ferme. Vous ne pouvez reprendre contact qu’en utilisant un modèle de message approuvé.
• Lorsque vous envoyez un modèle de message, une nouvelle fenêtre de 24 heures s’ouvre dès que le client répond.

Les réponses dans cette fenêtre ne seront plus gratuites à partir du 1er octobre 2026. Meta a annoncé qu’à compter de cette date, les réponses libres envoyées par une entreprise dans la fenêtre de 24 heures seront facturées par message, au tarif de chaque marché — soit le même tarif que celui appliqué aux modèles utilitaires et d’authentification. Elles étaient gratuites depuis novembre 2024. Chaque numéro de téléphone bénéficie d’abord de 1 000 messages de service gratuits par mois, et seul le 1 001e message et les suivants seront facturés ; le tarif correspond au tarif utilitaire du marché, qui figure déjà sur la grille tarifaire de Meta. Ce que cela signifie pour vous et ce qu’il convient de vérifier avant cette date est disponible sur Coûts WhatsApp et le changement d’octobre 2026.

Tester votre configuration #

Avant de vous lancer avec vos clients, vérifiez que tout fonctionne :

1. Envoyez un message de test. Ouvrez l’agent IA ou la diffusion assignée à ce numéro et utilisez son panneau Essayer pour vous envoyer un message de test, ou envoyez-le directement depuis Chats.
2. Testez les messages entrants. Envoyez un message WhatsApp depuis votre téléphone personnel vers votre numéro professionnel et confirmez qu’il apparaît dans Chats.
3. Testez les réponses de l’IA. Confirmez que l’agent répond dans les délais attendus et que ses réponses correspondent à vos instructions et à votre base de connaissances.
4. Testez les modèles de messages. Créez et faites approuver un modèle simple, envoyez-le à votre numéro de test et confirmez qu’il arrive avec toutes les variables remplies.

Dépannage #

Le numéro n’apparaît pas comme actif #

• Assurez-vous d’avoir terminé le processus d’activation complet, y compris la connexion à votre compte Meta Business et l’octroi des autorisations.
• Vérifiez que votre compte Meta Business est en règle.
• Attendez quelques minutes et actualisez la page — l’activation peut prendre du temps.

Les messages ne sont pas envoyés #

• Vérifiez que vous disposez de crédits suffisants sur votre compte.
• Vérifiez si vous avez atteint votre palier de limite de messagerie.
• Assurez-vous que le numéro de téléphone du destinataire est au format international correct (par ex. +1234567890).
• Si vous envoyez un message en dehors de la fenêtre de 24 heures, assurez-vous d’utiliser un modèle approuvé.

Diffusions et modèles bloqués, mais les réponses fonctionnent toujours #

Ce schéma — vous pouvez répondre aux personnes qui vous contactent en premier, mais aucun message que vous initiez ne part — signifie presque toujours que le compte WhatsApp Business associé au numéro ne dispose d’aucun moyen de paiement valide, et cela ne s’applique qu’aux connexions utilisant votre propre compte WhatsApp Business. Meta bloque les conversations initiées par l’entreprise (diffusions, campagnes, tout modèle) jusqu’à ce qu’un moyen de paiement valide soit associé au compte, et signale l’erreur dans le Gestionnaire WhatsApp.

L’application interrompt désormais une diffusion ou une campagne avant l’envoi dans cette situation et vous demande d’ajouter un moyen de paiement, au lieu de laisser chaque message échouer. Ajoutez ou corrigez le moyen de paiement dans le Gestionnaire WhatsApp et réessayez l’envoi — reconnecter le numéro ici ne résoudra pas le problème. Consultez Coûts WhatsApp et le changement d’octobre 2026.

Modèle rejeté #

• Consultez les directives de Meta concernant les modèles — les modèles ne peuvent pas contenir de contenu promotionnel dans certaines catégories.
• Vérifiez les problèmes de formatage, tels que les espaces réservés non correspondants.
• Lisez la raison du refus fournie par Meta, révisez et soumettez à nouveau — consultez Modèles de message WhatsApp.

Mauvaise évaluation de la qualité des messages #

• Vérifiez la pertinence et la valeur du contenu de vos messages pour les destinataires.
• Évitez de contacter des personnes qui n’ont pas donné leur consentement.
• Réduisez la fréquence des messages si les destinataires vous signalent ou vous bloquent.

Erreur « Numéro de téléphone introuvable » #

• Le numéro de téléphone n’est peut-être pas correctement lié à votre compte Meta Business.
• Essayez de réactiver le numéro de téléphone via le flux de connexion WhatsApp.
• Contactez le support si le problème persiste.

Bonnes pratiques #

• Obtenez toujours le consentement avant d’envoyer des messages aux clients sur WhatsApp.
• Répondez rapidement aux messages des clients pour tirer le meilleur parti de la fenêtre de 24 heures.
• Soyez concis et pertinent dans vos modèles : les modèles de haute qualité sont approuvés plus rapidement et sont plus performants.
• Surveillez votre évaluation de qualité dans Meta Business Manager pour éviter les déclassements de niveau.
• Laissez un agent IA gérer les réponses pour garantir une réactivité 24h/24 et 7j/7 dans la fenêtre de messagerie — voir Agents IA.