Dernière mise à jour : novembre 2026
En bref
- Connecter l’IA à l’API WhatsApp Business, c’est quatre tâches, pas une seule : associer le numéro, recevoir les messages, envoyer des réponses dans le respect des règles de Meta et transférer la conversation à une personne lorsque l’IA doit s’arrêter.
- Il existe trois façons de procéder : créer votre propre solution sur la Cloud API de Meta, confier la connexion à un fournisseur de solutions Business (BSP) ou utiliser une plateforme avec un agent IA, des modèles et une boîte de réception intégrés, comme Invent.
- La fenêtre de 24 heures est la règle qui fait échouer la plupart des configurations. Pendant cette période, l’IA peut répondre librement. Une fois celle-ci expirée, seul un modèle approuvé par Meta peut être envoyé.
- Un seul numéro peut servir à toute votre équipe. L’IA répond en premier, puis le routage par IA transfère la conversation à la bonne personne dans une boîte de réception partagée.
- Validez votre solution avec un petit projet pilote : un numéro, un cas d’usage et quatre tests avant de la déployer à plus grande échelle.
Vos clients vous écrivent déjà sur WhatsApp. La question, c’est qui leur répond à 2 h du matin, un dimanche ou le jour où 300 personnes demandent « Où est ma commande ? ». Un agent IA connecté à l’API WhatsApp Business peut leur répondre en quelques secondes, en s’appuyant sur vos propres règles et votre catalogue.
On pourrait croire qu’il suffit d’accomplir une seule tâche. En pratique, il y en a quatre : associer un numéro de téléphone, recevoir les messages des clients, envoyer des réponses dans le respect des règles de Meta et déterminer quand une personne doit prendre le relais. Si tout est bien configuré, les clients obtiennent des réponses rapides et exactes. Dans le cas contraire, les messages ne sont pas envoyés, les clients reçoivent des réponses en double ou l’IA continue de parler alors qu’elle aurait dû s’arrêter.
Ce guide présente les trois façons de connecter l’API, ce que chacune implique pour votre équipe et les vérifications à effectuer avant la mise en service.
Fonctionnement d’un agent IA avec l’API WhatsApp Business
L’API WhatsApp Business — que Meta appelle désormais la WhatsApp Business Platform, dont la version hébergée est la Cloud API — fonctionne comme un canal bidirectionnel. Les messages entrants arrivent par des webhooks. Les réponses sont envoyées au moyen d’appels API. L’IA se trouve entre les deux et décide quoi répondre.
Voici quelques termes que vous rencontrerez dans toutes les configurations :
- Compte WhatsApp Business (WABA) : le compte qui regroupe vos numéros, vos modèles et vos paramètres.
- Webhook : la notification envoyée par Meta à votre système lorsqu’un message arrive ou que son statut change (envoyé, remis, lu).
- Modèle de message : un message approuvé à l’avance par Meta, nécessaire pour démarrer ou reprendre une conversation.
- Fenêtre de service client : les 24 heures suivant le dernier message d’un client, pendant lesquelles vous pouvez répondre librement.
En termes simples, voici comment ça se passe : un client écrit, Meta transmet le message à votre webhook, votre système l’envoie à l’IA, qui rédige une réponse à partir de votre contenu, puis votre système la renvoie au client. Si l’IA n’est pas sûre d’elle ou si le client demande à parler à quelqu’un, la conversation est transférée à votre équipe.
La fenêtre de 24 heures : une règle incontournable
La fenêtre de service client de Meta dure 24 heures. Elle commence — et repart à zéro — chaque fois qu’un client vous envoie un message. Tant qu’elle est ouverte, votre IA peut envoyer des réponses classiques sous forme de texte, d’images, de documents ou de boutons. Une fois qu’elle se ferme, seul un modèle approuvé peut être envoyé au client.
Cette règle détermine le comportement de votre IA :
- Répondez immédiatement tant que la fenêtre est ouverte. C’est là qu’un agent IA devient rentable.
- Vérifiez que la fenêtre est ouverte avant chaque envoi. Si elle est fermée, l’IA ne peut pas envoyer un message libre improvisé.
- Utilisez un modèle pour tout message envoyé après la fermeture. Une mise à jour de livraison le lendemain, un rappel de rendez-vous ou un lien de paiement envoyé après 24 heures nécessite un modèle approuvé dans la catégorie adéquate : marketing, utilitaire ou authentification.
Meta facture chaque message selon sa catégorie et le pays du client, et vous envoie directement la facture. Depuis le 1er octobre 2026, chaque numéro WhatsApp bénéficie de 1 000 messages de service gratuits par mois : il s’agit des réponses envoyées pendant une fenêtre ouverte. À partir du 1 001e message, ces réponses sont également facturées, tandis que les modèles sont toujours payants. Consultez la grille tarifaire de Meta en vigueur avant de prévoir vos volumes. Notre guide sur les modèles WhatsApp explique le processus d’approbation et comment rouvrir la fenêtre.
Méthode 1 : créer votre solution sur la Cloud API de Meta
Cette option convient aux équipes qui disposent de développeurs et souhaitent garder un contrôle total sur chaque composant.
- Préparez vos ressources Meta. Vous avez besoin d’un portefeuille professionnel Meta vérifié et d’un numéro de téléphone capable de recevoir un code de vérification.
- Créez le WABA et associez le numéro. Le processus d’inscription intégrée de Meta (Embedded Signup) ou le tableau de bord développeur permet de créer le compte et d’enregistrer le numéro sur la Cloud API.
- Choisissez comment migrer le numéro. Un nouveau numéro est la solution la plus simple. Un numéro déjà utilisé avec l’application WhatsApp Business peut être transféré vers l’API (l’application cessera alors de fonctionner avec ce numéro) ou utilisé en coexistence, ce qui permet de conserver l’application et l’API sur le même numéro.
- Configurez le webhook. Publiez une URL de rappel, validez le contrôle du jeton de vérification de Meta et abonnez-vous aux événements de message et de statut.
- Protégez le jeton d’accès. Conservez-le dans un gestionnaire de secrets, jamais dans le code côté client.
- Configurez l’étape d’IA. Transmettez chaque message à votre modèle avec votre contenu, laissez-le appeler des fonctions (rechercher une commande, réserver un créneau), puis renvoyez la réponse finale par l’intermédiaire de l’API Messages.
- Gérez les cas particuliers. Les webhooks peuvent arriver en double : enregistrez chaque ID de message et ignorez les doublons. Réessayez les envois échoués. Surveillez l’indice de qualité du numéro.
L’avantage, c’est le contrôle. En contrepartie, votre équipe doit assurer la disponibilité, gérer les nouvelles tentatives et les modèles, fournir la boîte de réception utilisée par les agents et s’adapter à chaque modification de l’API par Meta.
Méthode 2 : confier la connexion à un fournisseur de solutions Business
Un fournisseur de solutions Business (BSP) est une entreprise approuvée par Meta pour connecter les entreprises à l’API. Le BSP héberge les webhooks, envoie les messages et gère souvent les modèles. Vous gagnez en rapidité et en assistance, mais perdez une partie du contrôle. En général, vous devez tout de même fournir l’IA.
Posez ces questions avant de signer :
- Où l’IA fonctionne-t-elle ? Est-elle intégrée ou devez-vous connecter votre propre modèle via leur API ?
- Comment la facturation fonctionne-t-elle ? Au message, au mois, par utilisateur ou avec une majoration des frais de Meta ?
- Que se passe-t-il en cas d’échec d’envoi ? Demandez comment le fournisseur relance les webhooks et les messages.
- Qui gère les modèles, et combien de temps faut-il pour corriger un modèle refusé ?
- Pouvez-vous partir ? Demandez comment transférer le numéro à un autre fournisseur par la suite.
- Sécurité : dispose-t-il d’un rapport SOC 2, de journaux d’audit et d’un engagement de disponibilité ?
Pour évaluer un BSP pendant un projet pilote, suivez ces indicateurs : délai avant le premier message, taux de remise, nombre de conversations transférées à une personne et coût par conversation.
Méthode 3 : utiliser une plateforme avec un agent IA intégré
La troisième méthode vous évite toute la plomberie technique. La plateforme connecte le numéro, fait fonctionner l’agent IA, gère les modèles et fournit une boîte de réception à votre équipe, le tout au même endroit.
Dans Invent, vous connectez le numéro à Meta depuis l’application grâce à Embedded Signup. Cette méthode fonctionne avec un nouveau numéro, un numéro transféré d’un autre fournisseur ou un numéro qui reste sur l’application WhatsApp Business grâce à la coexistence. Les modèles sont créés, soumis pour approbation et suivis au même endroit : plus besoin de tenir un tableur des approbations.
L’agent IA répond en s’appuyant sur votre site Web, vos documents et vos règles. Lorsqu’il doit s’arrêter, le routage par IA transfère la conversation à la bonne personne dans la boîte de réception partagée. Votre collègue voit toute la conversation, le motif du transfert et les informations que l’IA a retenues sur le client. La même boîte de réception regroupe WhatsApp, Instagram, TikTok et le chat Web : une seule équipe peut ainsi gérer tous les canaux.
Cette option convient aux équipes opérationnelles qui veulent fournir des réponses exactes et assurer des transferts fluides sans recruter d’ingénieurs. Si vous avez besoin d’une logique personnalisée qu’aucune plateforme ne prend en charge, la méthode 1 vous offre plus de possibilités.
Un seul numéro WhatsApp pour plusieurs personnes
On demande souvent si un seul numéro WhatsApp peut servir à toute une équipe. Avec l’API, oui. L’application WhatsApp Business limite le nombre d’appareils associés. L’API, elle, n’impose aucune limite : chaque message arrive dans votre système, et votre boîte de réception détermine qui y répond.
L’IA et les personnes se répartissent ainsi le travail :
- L’IA répond en premier, à toute heure, en s’appuyant sur votre contenu.
- Le routage par IA choisit la bonne personne lorsque la conversation nécessite du discernement, concerne un remboursement ou une réclamation, ou porte sur une vente qui demande une touche humaine.
- Votre équipe répond depuis le même numéro, de sorte que le client ne voit jamais la conversation transférée vers un autre contact.
Avec une plateforme, tout fonctionne dès le premier jour. Si vous créez votre propre solution, vous devez mettre en place une boîte de réception, des règles d’attribution et un mécanisme pour empêcher l’IA de répondre lorsqu’une personne prend le relais.
À quel moment l’IA doit-elle intervenir ?
L’IA ne doit jamais envoyer de messages directement sur WhatsApp. Votre processus vérifie l’état de la fenêtre, choisit le type de message et l’envoie. L’IA décide uniquement quoi dire ou quelle action effectuer : rechercher une commande, prendre un rendez-vous ou consulter une règle, par exemple.
Mettez en place ces trois garde-fous :
- Répondez uniquement à partir de votre contenu. Une IA limitée à vos documents et à votre site sait reconnaître ce qu’elle ignore.
- Demandez confirmation avant toute transaction. Pour les remboursements, les paiements et les réservations, demandez au client de confirmer dans la conversation.
- Transférez la conversation lorsque certains critères sont réunis. Un faible niveau de confiance, les sujets sensibles, les clients mécontents et les décisions liées à vos règles doivent être traités par une personne.
Les questions de votre équipe de sécurité
Si WhatsApp transmet des données client, votre évaluation de sécurité couvrira les mêmes points, quelle que soit la méthode choisie :
- Rapport SOC 2 Type II pour les entreprises clientes
- Authentification unique avec votre fournisseur d’identité
- Journaux d’audit indiquant qui a fait quoi, et rôles personnalisés définissant qui peut consulter quelles conversations
- Contrôle des dépenses, pour éviter que l’équipe financière ne soit prise au dépourvu pendant un mois chargé
- Des réponses claires sur l’emplacement et la durée de stockage des conversations, et sur leur éventuelle utilisation pour entraîner un modèle
Combien ça coûte ? Exemple détaillé
Les coûts WhatsApp se composent de deux factures : les frais facturés par Meta pour chaque message et le coût de la plateforme qui fait fonctionner votre agent IA. Voici comment se calcule la part de Meta pour une boutique.
Imaginons une boutique en ligne avec un seul numéro WhatsApp. En un mois, 3 000 clients lui écrivent et l’agent IA envoie environ deux réponses à chacun, soit 6 000 réponses pendant des fenêtres ouvertes. La boutique envoie également 500 mises à jour de commande le lendemain, après la fermeture de la fenêtre.
- Les 1 000 premières réponses sont gratuites. Chaque numéro bénéficie de 1 000 messages de service gratuits par mois, et le compteur est remis à zéro chaque mois.
- Les 5 000 autres réponses sont facturées au tarif de service de Meta applicable au pays de chaque client.
- Les 500 mises à jour de commande sont des modèles, facturés au tarif utilitaire de Meta applicable à chaque pays.
- Un point d’entrée gratuit : lorsqu’un client vous écrit depuis une publicité Click to WhatsApp, la plupart des messages sont gratuits pendant 7 jours.
Les tarifs varient selon les pays et Meta les met à jour. Consultez donc sa grille tarifaire en vigueur pour connaître le prix par message. En plus de la facture de Meta, vous payez l’IA et la plateforme. Des réponses moins nombreuses, mais de meilleure qualité, réduisent les deux factures. Voilà une raison de plus pour que les réponses de l’IA soient concises et exactes.
Erreurs courantes de l’API WhatsApp et solutions
La plupart des échecs d’envoi s’accompagnent d’un code d’erreur. Voici les plus fréquents et la solution proposée par Meta pour chacun :
- 131047, plus de 24 heures se sont écoulées depuis la réponse du client : la fenêtre est fermée. Envoyez plutôt un modèle approuvé.
- 132001, le modèle n’existe pas : le modèle n’a pas encore été approuvé, ou son nom ou sa langue ne correspond pas. Vérifiez ces deux éléments dans votre liste de modèles.
- 131026, message non distribuable : le numéro n’utilise peut-être pas WhatsApp, ou le client n’a pas accepté les dernières conditions ou mis à jour l’application.
- 131049, message non remis afin de préserver la qualité des échanges : Meta limite le nombre de messages marketing reçus par une même personne. Attendez au moins 24 heures avant de réessayer.
- 131056, trop de messages envoyés à la même personne : vous avez envoyé trop de messages à un client en peu de temps. Attendez, puis réessayez. Les autres clients ne sont pas concernés.
- 130429, limite de débit atteinte : vous envoyez trop de messages à l’échelle globale. Ralentissez le rythme et réessayez.
- 131042, problème de moyen de paiement : mettez à jour le moyen de paiement de votre compte WhatsApp Business dans Meta.
- 368, compte restreint : le compte a enfreint une règle WhatsApp. Consultez l’avis de Meta relatif à l’application de ses règles avant de réessayer d’envoyer des messages.
Dans Invent, l’erreur d’un message en échec s’affiche à côté de celui-ci dans la conversation. Votre équipe voit ainsi ce qui s’est passé sans avoir à consulter les journaux. Si vous développez votre propre solution, consignez chaque code avec l’ID du message et alertez une personne si le nombre d’échecs augmente.
Lancez un projet pilote avant le déploiement
Commencez avec un numéro WhatsApp et un seul cas d’usage, comme les questions sur les commandes ou la prise de rendez-vous. Effectuez ensuite ces quatre tests dans l’ordre :
- Le premier message entrant arrive une seule fois dans votre système, et non deux.
- La première réponse de l’IA est correcte et est envoyée pendant la fenêtre de 24 heures.
- Premier transfert à un agent arrive à la bonne personne avec l’intégralité de la conversation.
- Premier envoi de modèle est envoyé après la fermeture de la fenêtre.
Pendant deux semaines, suivez le délai de première réponse, le délai de résolution, le CSAT, le taux de transfert à un agent et le coût par conversation. Lisez manuellement 50 conversations et évaluez les réponses de l’IA ainsi que ses décisions de transfert. Prévoyez une procédure de retour en arrière : si quelque chose ne fonctionne pas comme prévu, mettez l’IA en pause et redirigez toutes les conversations vers votre équipe.
Côté coûts, une plateforme comme Invent est proposée à partir de 29 $ par mois, avec 29 $ d’utilisation inclus dans l’offre Business. À mesure que votre activité se développe, vous payez à l’utilisation, avec des réponses de l’IA à partir de 0,003 $ par message, selon le modèle. Les frais WhatsApp de Meta sont facturés séparément et directement par Meta. Une offre gratuite est disponible pour essayer la plateforme.
Choisissez la solution adaptée à votre équipe
Choisissez la solution 1 si vous avez des ingénieurs et souhaitez maîtriser chaque couche. Choisissez la solution 2 si vous voulez confier la connexion à un prestataire et que vous disposez déjà d’une IA. Choisissez la solution 3 si vous souhaitez réunir l’agent IA, les modèles et la boîte de réception de l’équipe au même endroit.
Quelle que soit votre solution, connectez un numéro, lancez le projet pilote, analysez les résultats, puis passez à l’échelle. Pour découvrir la procédure sans code, consultez comment créer un chatbot IA WhatsApp sans code.
FAQ
Comment connecter un assistant IA à l’API WhatsApp Business ?
Connectez votre numéro à la Cloud API de Meta, recevez les messages via un webhook, transmettez chaque message à l’IA, puis renvoyez sa réponse pendant la fenêtre de 24 heures. Une plateforme comme Invent prend en charge ces quatre étapes pour vous via l’inscription intégrée de Meta, sans aucun code.
Quelle plateforme API WhatsApp intègre une IA ?
Invent réunit l’API WhatsApp Business, un agent IA, des modèles approuvés, le routage par IA et une boîte de réception partagée. La plupart des prestataires de solutions métier ne gèrent que la connexion : vous devez donc ajouter l’IA vous-même.
Puis-je conserver l’application WhatsApp Business sur le même numéro ?
Oui, grâce à la coexistence. L’application et l’API utilisent le même numéro : vous pouvez continuer à répondre depuis votre téléphone pendant que l’IA traite le reste. Sans coexistence, le transfert d’un numéro vers l’API désactive l’application pour ce numéro.
Plusieurs agents peuvent-ils répondre depuis un même numéro WhatsApp ?
Oui, avec l’API. Tous les messages arrivent dans votre système et une boîte de réception partagée permet à autant de membres de l’équipe que nécessaire de répondre depuis le même numéro. L’application WhatsApp Business limite le nombre d’appareils associés.
Les modèles de messages WhatsApp doivent-ils être approuvés ?
Oui. Meta examine chaque modèle avant que vous puissiez l’envoyer, généralement en quelques minutes à une journée. Les modèles sont nécessaires pour démarrer une conversation ou pour envoyer un message à un client après la fermeture de la fenêtre de 24 heures.
Pourquoi mon message WhatsApp n’a-t-il pas été envoyé après 24 heures ?
La fenêtre de service client s’est refermée. Après 24 heures sans message du client, seul un modèle approuvé peut être envoyé. Envoyez un modèle : la fenêtre se rouvrira lorsque le client répondra.
Qu’est-ce qu’un agent IA WhatsApp ?
Un agent IA WhatsApp est un logiciel qui lit les messages des clients sur WhatsApp et y répond à partir du contenu de votre entreprise. Il peut aussi effectuer des actions, comme réserver un rendez-vous ou rechercher une commande. Il transmet la conversation à une personne lorsqu’il ne devrait pas répondre seul.
Combien coûte la connexion d’une IA à WhatsApp ?
Vous payez Meta par message, selon la catégorie et le pays. Les 1 000 premières réponses de service par numéro sont gratuites chaque mois. Vous payez aussi l’IA et la plateforme. L’offre Business d’Invent coûte 29 $ par mois et comprend 29 $ d’utilisation ; au-delà, vous payez à l’utilisation. Les réponses de l’IA coûtent à partir de 0,003 $ par message, selon le modèle. Meta facture ses frais séparément.
