Your AI Connector Docs

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 24 heures (voir Limites de messagerie ci-dessous). Vous en avez également besoin pour l’option Géré par nous : cette option fournit le numéro et achemine les messages, mais le numéro reste dans votre propre compte WhatsApp Business, vous terminez donc sa configuration dans une fenêtre contextuelle Meta. Le seul moyen de connecter WhatsApp sans aucun compte Meta est WhatsApp Web.
  • 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 dans Paramètres → Entreprise (groupe Espace de travail). L’opérateur valide cette adresse, elle doit donc être exacte et complète ; l’achat échouera tant qu’elle ne sera pas définie. Certains pays n’acceptent qu’une adresse postale située dans le même pays : lorsque le pays du numéro en exige une, le pays de l’adresse est verrouillé sur celui-ci (par exemple, un numéro luxembourgeois nécessite une adresse au Luxembourg), et un numéro de votre propre pays est le moyen d’utiliser votre propre adresse.

Remarque : Le numéro de téléphone que vous utilisez pour l’API WhatsApp Business ne peut pas être utilisé simultanément avec l’application WhatsApp classique. Si vous souhaitez continuer à utiliser votre WhatsApp personnel, achetez plutôt un nouveau numéro via la plateforme, ou utilisez WhatsApp Web, qui vous permet de connecter votre numéro existant en associant votre téléphone sans le retirer de l’application classique. Il s’agit de deux voies distinctes : un numéro que vous achetez ici est un numéro virtuel sans téléphone associé, il ne peut donc être utilisé que sur l’API Business — il ne pourra jamais être associé à WhatsApp Web.


É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.
  1. 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.
  1. Parcourez la liste des numéros disponibles qui s’affiche, chacun indiquant son coût d’achat unique et son coût mensuel.
  1. Cliquez sur un numéro et saisissez son Nom d’affichage — le nom commercial que les utilisateurs voient sur WhatsApp. Il doit contenir des lettres et correspondre au nom de votre entreprise ou de votre marque ; WhatsApp rejette les numéros de téléphone seuls ainsi que tout nom incluant le mot « WhatsApp ». Confirmez ensuite le coût indiqué 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.

Conseil : Choisissez un numéro situé dans le même pays que la majorité de vos clients. Cela renforce la confiance et peut réduire les coûts de messagerie.

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. Il arrive parfois que Meta maintienne le numéro en état « En attente » (« Pending »), ou que la fenêtre Meta se termine sur « La connexion WhatsApp n’a pas abouti » (« WhatsApp Connection Didn’t Complete ») alors même que la vérification de propriété a réussi. Laissez le numéro tel quel : il est revérifié toutes les dix minutes, et une inscription bloquée après une vérification de propriété réussie est automatiquement réinscrite pour vous, généralement dans le quart d’heure qui suit. Ne supprimez pas le numéro et ne recommencez pas la configuration (« Finish setup ») entre-temps. Si un numéro échoue à plusieurs reprises, WhatsApp peut le limiter temporairement — attendez 24 heures et réessayez, ou contactez le support s’il est toujours en attente après une heure. La seule exception est un compte WhatsApp Business verrouillé par Meta : voir Verrouillé par Meta ci-dessous.

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.

Avertissement : La suppression du compte supprime les discussions, les groupes et les sauvegardes du numéro sur le téléphone. Ne faites cela que si vous êtes certain que le numéro doit désormais être utilisé sur l’API. Si vous souhaitez continuer à utiliser le numéro dans l’application, connectez-le plutôt via WhatsApp Web ou achetez un nouveau numéro pour l’API.

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.

Qui paie les frais de messagerie dépend de la façon dont le numéro est connecté. Votre propre numéro Géré par nous envoie via notre compte de messagerie, donc ses frais de messagerie sont déduits de vos crédits, tout comme pour un numéro loué. Via votre propre application Meta, Meta facture les messages au moyen de paiement associé à votre compte WhatsApp Business. S’il n’y en a pas de valide, Meta bloque les diffusions et les messages modèles 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.

Twilio dans vos paramètres Meta Business

Lorsque vous connectez un numéro Géré par nous, Meta ajoute Twilio à votre entreprise Meta en tant que partenaire. Il apparaît sous le nom de Twilio dans les Paramètres Meta Business. Twilio est le service qui achemine vos messages WhatsApp entre WhatsApp et Your AI Connector, il doit donc y rester.

Ne supprimez pas Twilio. S’il est supprimé, aucun message ne sera reçu ou envoyé sur ce numéro : les messages des clients ne vous parviendront jamais et vos réponses échoueront. Your AI Connector détecte cela, marque le numéro comme Hors ligne sous Paramètres → Canaux et vous envoie un e-mail. Pour résoudre ce problème, reconnectez le numéro sous Paramètres → Canaux, ce qui rajoutera Twilio.


É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 :
Champ Description
Photo de profil Le logo ou la photo de votre entreprise (recommandé : carré, au moins 640x640px)
Catégorie La catégorie qui décrit le mieux votre entreprise (par ex. Restaurant, Commerce de détail, Santé) — obligatoire
Description Une description de votre entreprise
À propos Une courte ligne sur votre entreprise
E-mail L’e-mail de contact de votre entreprise
Site web L’URL du site web de votre entreprise
Adresse L’adresse de votre entreprise
  1. Enregistrez pour mettre à jour votre profil.

Conseil : Remplissez tous les champs du profil. Les clients sont plus enclins à interagir avec des entreprises disposant d’un profil professionnel complet.


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 écrit, quelle que soit la manière dont chaque numéro est connecté : un numéro géré, un numéro sur notre application Meta et un numéro sur votre propre application Meta peuvent coexister sur un même compte, et un nouveau numéro ne prend en charge que les conversations qui débutent sur celui-ci. Détails : Points d’entrée → Un agent par numéro WhatsApp. Si un client a écrit à un numéro WhatsApp qui se trouve dans votre entreprise Meta mais qui n’est pas connecté à ce compte, une réponse ne sera pas envoyée depuis l’un de vos autres numéros (WhatsApp la refuserait) ; le message explique pourquoi, et la connexion de ce numéro vous permet d’y répondre. Les modèles sont toujours envoyés.

Votre numéro principal

Lorsqu’un contact n’a jamais envoyé de message à aucun de vos numéros, une réponse lui est envoyée depuis votre numéro principal. Pour le modifier, ouvrez Paramètres → Canaux, recherchez le numéro sur la carte WhatsApp Business API et cliquez sur Définir comme principal. Seul un numéro dont la connexion à WhatsApp est terminée peut envoyer des messages : un numéro affichant encore Configuration non terminée ne peut pas envoyer de messages, et l’application utilise un numéro connecté à la place. Les autres numéros restent sur votre compte en tant que numéros secondaires, et un numéro acheté est facturé chaque mois, que sa configuration soit terminée ou non. Veillez donc à terminer sa configuration ou à le supprimer si vous n’en avez pas besoin.

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.

Remarque : Depuis octobre 2025, les limites de messagerie sont appliquées au niveau du portefeuille d’entreprise et non par numéro de téléphone. Tous les numéros de téléphone de votre portefeuille partagent la même limite.

Système de paliers

Palier Contacts uniques par 24 heures Comment y parvenir
Non vérifié 250 Par défaut pour les nouvelles entreprises non vérifiées
Vérifié 2 000 Terminez la vérification de l’entreprise
Palier 2 10 000 Maintenez une messagerie de haute qualité
Palier 3 100 000 Qualité élevée et constante à grande échelle
Illimité Aucune limite Historique de qualité exceptionnelle

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.

Important : Ces limites s’appliquent uniquement aux conversations initiées par l’entreprise (messages modèles). Les conversations initiées par le client, où celui-ci vous envoie un message en premier, ne sont pas comptabilisées dans votre limite.


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

Emplacements partagés

Lorsqu’un contact partage un emplacement (le trombone → Localisation dans WhatsApp, une épingle ou un lieu enregistré), l’IA le reçoit sous forme de texte dans la conversation : le nom du lieu et l’adresse lorsque WhatsApp les envoie, ainsi que les coordonnées, sous la forme [THE CONTACT SHARED A LOCATION] Playa Delfines, Cancún (21.1619, -86.8515). L’agent peut citer l’adresse en retour, l’utiliser dans ses instructions (« si le contact est en dehors de notre zone de livraison, signalez-le ») ou transmettre la latitude et la longitude à une fonction personnalisée ou à un webhook dans le cadre de la conversation. La même structure est utilisée, que le numéro soit connecté de la manière par défaut (un numéro fourni par nos soins), via notre application Meta, via votre propre application Meta ou sur WhatsApp Web. Les localisations en direct (temps réel) arrivent une seule fois, avec la position au moment du partage ; l’application ne suit pas l’épingle en mouvement.

Dans Chats, vous le voyez sous forme de carte, et non comme cette ligne de texte : une épingle avec le nom du lieu et l’adresse, ainsi qu’un lien Ouvrir dans Google Maps qui ouvre l’endroit exact dans un nouvel onglet. Une légende saisie par le contact s’affiche en dessous. La liste des discussions affiche une épingle et le nom du lieu en tant que dernier message.

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.

Remarque : L’approbation d’un modèle prend généralement de quelques minutes à quelques heures, mais peut prendre jusqu’à 24 heures dans certains cas.


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.
Scénario Ce que vous pouvez envoyer
Le client vient de vous envoyer un message (dans les 24 heures) Tout type de message — texte, images, documents, etc.
Plus de 24 heures depuis le dernier message du client Uniquement des modèles de messages approuvés
Le client a répondu à votre modèle Tout type de message (nouvelle fenêtre de 24 heures ouverte)

Conseil : Un agent IA gérant ce canal répond automatiquement dans la fenêtre de 24 heures. Pour relancer la conversation après la fermeture de cette fenêtre, configurez des modèles de suivi dans les paramètres de votre diffusion ou de votre agent — voir Agents IA.

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.

En attente car Meta examine toujours un nouveau compte WhatsApp Business

Si la fenêtre Meta a créé un tout nouveau compte WhatsApp Business, Meta effectue sa propre vérification automatique de ce compte avant de permettre au numéro d’être mis en ligne. Tant que l’examen n’est pas approuvé, le numéro s’affiche comme En attente dans l’application et dans le gestionnaire WhatsApp (WhatsApp Manager). Il n’y a rien à soumettre pour cet examen et aucun moyen de l’accélérer depuis l’application. Laissez le numéro tel quel : l’application continue de vérifier, et le numéro se connecte automatiquement une fois que Meta a approuvé le compte, même si cela prend plusieurs jours. La vérification de l’entreprise est une étape distincte ; elle augmente votre limite de messagerie, mais ce n’est pas ce que cet examen attend.

Verrouillé par Meta

Parfois, Meta verrouille le compte WhatsApp Business auquel un numéro est associé, par exemple en attendant que vous terminiez la vérification de l’entreprise ou pour résoudre un examen. Un numéro sur un compte verrouillé ne peut pas se connecter : l’application l’affiche comme Verrouillé par Meta, et le survol du badge vous indique la marche à suivre. La réinscription ne sert à rien dans ce cas, donc l’application ne tente pas de le faire. Ouvrez le Support Business (« Business Support Home ») dans Meta Business Suite, suivez les étapes de Meta pour déverrouiller le compte (et terminez la vérification de l’entreprise si Meta le demande), puis laissez le numéro tel quel. L’application continue de vérifier, et le numéro se connecte de lui-même une fois que Meta a levé le verrouillage ; il n’est pas nécessaire de se reconnecter ou de recommencer la configuration (« Finish setup »).

Si vous préférez ne pas attendre, vous pouvez utiliser le numéro sur WhatsApp Web à la place. Supprimez d’abord le numéro dans Paramètres → Canaux, puis supprimez-le du compte WhatsApp Business dans le gestionnaire WhatsApp (un numéro qui n’a jamais été mis en ligne peut y être supprimé). Ensuite, enregistrez-le dans l’application WhatsApp Business sur un téléphone et connectez-le avec le code QR. Le déplacer ultérieurement vers l’API signifie supprimer à nouveau le compte dans l’application, comme décrit dans Déplacer un numéro actuellement sur l’application WhatsApp.

Le numéro est hors ligne

Un badge Hors ligne sur le numéro sous Paramètres → Canaux signifie que WhatsApp a lui-même empêché le numéro d’envoyer des messages. Survolez le badge pour en connaître la raison. La cause la plus fréquente est la désactivation par Meta du compte WhatsApp Business associé au numéro, généralement en raison d’un problème de politique ; le badge l’indique alors et vous renvoie vers le Meta Business Manager, où vous pouvez consulter l’avis et faire appel.

Le badge passe également à Hors ligne lorsque Twilio a été supprimé de votre entreprise Meta (voir Twilio dans vos paramètres Meta Business) ; pour corriger cela, reconnectez le numéro sous Paramètres → Canaux.

Tant qu’un numéro est hors ligne, les diffusions qui en proviennent sont mises en attente au lieu d’échouer message par message, et les réponses automatisées ne peuvent pas non plus être envoyées. Nous vérifions chaque numéro connecté via cette configuration auprès de WhatsApp une fois par jour. Lorsqu’un numéro qui fonctionnait passe hors ligne avec uniquement une erreur WhatsApp générale (sans motif lié à la politique), cette vérification le réenregistre automatiquement, et vous ne recevez un e-mail que si cela ne permet pas de le rétablir. Pour toute autre raison, vous recevez un e-mail la première fois que le numéro passe hors ligne. Dès que WhatsApp signale qu’il est de nouveau en ligne, le badge redevient vert automatiquement, au plus tard lors de la vérification quotidienne suivante. Si le numéro reste hors ligne après que vous avez résolu le problème du côté de Meta, contactez le support et nous effectuerons une nouvelle vérification pour vous. Les messages qui n’ont pas pu être envoyés parce que le numéro était hors ligne ne sont pas facturés.

Le numéro indique « Non distribué »

Un badge Non distribué sur le numéro sous Paramètres → Canaux signifie que le numéro est toujours connecté et que les messages qui vous sont envoyés arrivent bien, mais que WhatsApp ne distribue pas les messages que vous envoyez depuis ce numéro. Les réponses, y compris celles de votre agent, restent en file d’attente pendant des heures avant d’échouer. Dans le Gestionnaire WhatsApp, cela apparaît comme un numéro sans limite de messagerie ; les causes habituelles sont une restriction ou une révision du numéro ou du compte WhatsApp Business, ou un moyen de paiement manquant. Survolez le badge pour en connaître la raison.

Vérifiez le numéro dans le Gestionnaire WhatsApp et résolvez le problème indiqué par Meta. Tant que le badge est affiché, les diffusions depuis ce numéro sont retenues avant d’être envoyées. Nous vérifions chaque numéro connecté via cette configuration une fois par jour et vous envoyons un e-mail la première fois que cela se produit ; une fois que WhatsApp distribue à nouveau les messages depuis ce numéro, le badge devient vert automatiquement. Dans une discussion, une réponse qui est toujours en attente d’envoi après 15 minutes affiche une horloge orange, afin que vous puissiez la distinguer d’un message qui est simplement en cours d’acheminement.

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 n’a pas de mode 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, tout modèle) tant qu’un mode de paiement valide n’est pas sur le compte, et signale l’erreur dans le Gestionnaire WhatsApp.

L’application interrompt désormais une diffusion avant son envoi dans cette situation et vous demande d’ajouter un mode de paiement, au lieu de laisser chaque message échouer. Ajoutez ou corrigez le mode de paiement dans le Gestionnaire WhatsApp et renvoyez — 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.