Your AI Connector Docs

Connectez votre propre application Meta

Utilisez WhatsApp via votre propre application Meta et payez Meta directement aux tarifs qu’ils appliquent. Your AI Connector n’ajoute aucuns frais par message sur cette connexion, et il n’y a pas de compte Twilio intermédiaire. Comme le compte WhatsApp est le vôtre, vos clients ne voient que le nom de votre entreprise.

Il s’agit de l’option de connexion WhatsApp la plus technique : vous devrez créer une application sur le site développeur de Meta et copier quatre valeurs dans Your AI Connector. Prévoyez environ 20 minutes. Si cela vous semble trop complexe, la connexion gérée WhatsApp Business reste le moyen le plus simple de démarrer.

Ce dont vous avez besoin

  • Accès à votre compte Meta Business Manager.
  • Un numéro de téléphone qui n’est pas déjà utilisé sur l’application WhatsApp.
  • Environ 20 minutes.

Partie 1 — Configurez votre application dans Meta

Effectuez d’abord ces étapes du côté de Meta. Vous collecterez quatre valeurs en cours de route : un ID d’application, un Secret d’application, un Jeton d’accès et un ID de compte WhatsApp.

1. Créer une application

Allez sur developers.facebook.com, ouvrez Mes applications et appuyez sur Créer une application. Choisissez le type Entreprise et donnez-lui le nom de votre choix — ce nom n’est visible que par vous.

2. Ajouter WhatsApp à l’application

Sur le tableau de bord de l’application, recherchez WhatsApp dans la liste des produits et appuyez sur Configurer. Meta crée un compte WhatsApp de test avec un numéro de test gratuit afin que vous puissiez faire des essais avant de connecter un vrai numéro.

3. Activer les autorisations WhatsApp

C’est l’étape que la plupart des guides omettent, et l’ignorer est la raison la plus fréquente pour laquelle la connexion échoue par la suite.

Dans votre application, ouvrez Examen de l’application, puis Autorisations et fonctionnalités. Recherchez whatsapp_business_management. S’il est indiqué Aucun accès, appuyez sur Obtenir l’accès standard — Meta vous demandera de saisir à nouveau votre mot de passe et vous l’accordera immédiatement. Il n’y a pas de période d’attente ni d’examen de l’application ; il s’agit d’un simple bouton.

whatsapp_business_messaging dispose normalement déjà de l’accès standard. Les deux autorisations doivent afficher Accès standard avant l’étape suivante, sinon le jeton que vous générerez manquera de l’une d’entre elles.

4. Créer un utilisateur système

Dans les Paramètres d’entreprise Meta, ouvrez Utilisateurs, puis Utilisateurs système. Ajoutez-en un et donnez-lui un accès administrateur à la fois à votre application et à votre compte WhatsApp.

5. Générer un jeton pour cet utilisateur

Sélectionnez l’utilisateur système et cliquez sur Générer un jeton. Choisissez votre application, sélectionnez un jeton qui n’expire jamais, et cochez à la fois whatsapp_business_messaging et whatsapp_business_management. Meta affiche le jeton une seule fois — copiez-le immédiatement.

6. Trouver votre identifiant de compte WhatsApp

Dans les Paramètres d’entreprise, ouvrez Comptes, puis Comptes WhatsApp, et sélectionnez votre compte. Le long numéro sous son nom est l’identifiant.

Votre identifiant d’application (App ID) et votre clé secrète d’application (App secret) se trouvent dans les Paramètres de l’application, puis dans Général. Cliquez sur Afficher à côté de la clé secrète pour la révéler.

Partie 2 — Connectez-le dans Your AI Connector

Ouvrez Paramètres, puis Canaux, recherchez la carte WhatsApp Business API et appuyez sur Connecter WhatsApp. Choisissez Utiliser un numéro que vous possédez déjà, puis Votre propre application Meta. L’assistant s’ouvre sur un bref aperçu — appuyez sur Démarrer la configuration.

  1. Vos informations. Cette étape reprend les cinq étapes côté Meta de la Partie 1 à côté d’un formulaire pour vos quatre valeurs. Collez l’ID de l’application, le secret de l’application, le jeton d’accès et l’ID du compte WhatsApp exactement comme Meta les affiche, sans espaces supplémentaires, et appuyez sur Vérifier mes informations. Rien n’est enregistré tant que cela ne fonctionne pas — Your AI Connector les vérifie d’abord auprès de Meta.
  1. Choisissez le numéro à connecter. L’assistant liste chaque numéro de votre compte WhatsApp, chacun avec sa propre évaluation de qualité Meta. Choisissez celui avec lequel cet espace de travail doit envoyer et recevoir des messages et cliquez sur Connecter ce numéro.
  1. Activation et livraison. Your AI Connector active automatiquement le numéro pour l’API Cloud et enregistre son webhook auprès de Meta, afin que les messages entrants atteignent votre boîte de réception — dans la plupart des cas, vous arrivez directement sur la carte de connexion avec une confirmation “Numéro connecté”. Si l’étape automatique ne peut pas se terminer, l’assistant affiche l’URL de rappel et le jeton de vérification avec des boutons de copie et vous guide pour les ajouter vous-même dans Meta ; les mêmes valeurs restent visibles sur la carte de connexion au cas où Meta vous demanderait de les saisir à nouveau.
  2. L’assistant vérifie lui-même la connexion. À la dernière étape, il vérifie automatiquement la configuration — aucune attente de votre part. Une fois que la carte indique qu’elle est connectée, envoyez-vous un message WhatsApp depuis un autre téléphone et regardez-le arriver dans vos discussions : les conversations sur ce numéro arrivent désormais comme n’importe quel autre canal, et vos agents IA peuvent y répondre. Si la vérification détecte un élément dont Meta a encore besoin (par exemple, la vérification du numéro), la carte vous indique exactement lequel, et Vérifier la connexion relance la vérification une fois que vous avez corrigé le problème.

Vous pouvez revenir sur cette même page à tout moment pour vérifier l’état de la connexion, vous Reconnecter avec de nouveaux détails, ou appuyer sur Déconnecter — votre numéro, votre compte Meta et votre facturation restent les vôtres.

Passer de la connexion gérée

Vous pouvez commencer avec la connexion WhatsApp Business gérée et passer à votre propre application Meta plus tard. Les deux coexistent sur le même compte, il n’y a donc rien à reconstruire.

  • Vos contacts et votre historique de chat sont conservés. Les contacts, les conversations, les étiquettes, les agents et la base de connaissances appartiennent à votre compte, et non à la connexion. Supprimer ou remplacer un numéro ne supprime rien de tout cela, et lorsqu’une personne qui vous a déjà écrit envoie à nouveau un message au numéro, celui-ci arrive dans la même conversation.
  • Le numéro doit d’abord être transféré du côté de Meta. WhatsApp permet à un numéro de n’exister qu’à un seul endroit à la fois. Demandez au support de libérer le numéro de la configuration gérée, ajoutez-le à votre propre compte WhatsApp Business dans le Gestionnaire WhatsApp, puis suivez les étapes indiquées sur cette page. Attendez-vous à ce que le numéro soit hors ligne pendant une courte période durant le transfert.
  • Utilisez un numéro dont vous êtes propriétaire si vous prévoyez de changer. Un numéro loué via Your AI Connector est une ligne virtuelle qui appartient à la configuration gérée et ne peut pas être simplement transférée vers votre propre application Meta ; changer signifierait donc obtenir un nouveau numéro WhatsApp.
  • Les modèles doivent être approuvés à nouveau. Meta approuve les modèles par compte WhatsApp Business, vous devez donc recréer ceux que vous utilisez sous votre propre compte (voir Modèles ci-dessous).
  • Agences : chaque sous-compte connecte sa propre application Meta, de sorte que les clients peuvent effectuer la transition un par un.

Bon à savoir

  • La fenêtre de 24 heures s’applique, comme pour toute connexion WhatsApp Business. Vous pouvez toujours répondre librement aux personnes qui vous ont envoyé un message au cours des dernières 24 heures. En dehors de cette fenêtre, WhatsApp autorise uniquement les entreprises à entamer des conversations avec un modèle de message approuvé — un message en texte brut sera accepté par Meta mais ne sera pas distribué.
  • Meta vous facture directement les conversations aux tarifs nationaux publiés, via le mode de paiement associé à votre compte WhatsApp dans Meta. Your AI Connector ne facture pas par message sur cette connexion ; l’utilisation de l’IA est facturée en crédits comme d’habitude.
  • Conservez un mode de paiement valide sur ce compte WhatsApp. Sans cela, Meta bloque toutes les conversations initiées par votre entreprise — diffusions et tout message modèle — et affiche l’erreur dans le Gestionnaire WhatsApp. Sur cette connexion, une diffusion refuse de se lancer dans ce cas, et vous demande d’ajouter un mode de paiement plutôt que d’échouer message par message. Les réponses aux personnes qui vous ont contacté en premier sont toujours envoyées pour le moment, mais à partir du 1er octobre 2026, Meta facturera également celles-ci. Par conséquent, un compte sans mode de paiement fonctionnel deviendra totalement silencieux à cette date. L’ensemble des détails est disponible sur Coûts WhatsApp et le changement d’octobre 2026.
  • Votre estimation de coût est différente ici. Étant donné que ces frais ne sont jamais prélevés sur vos crédits, l’estimation lors de l’étape de révision d’une diffusion affiche le nombre de contacts et la répartition par pays avec une note indiquant que Meta les facture sur votre compte WhatsApp Business, au lieu d’un total en crédits.
  • Les numéros de test sont gratuits. Le numéro de test que Meta attribue à chaque nouvelle application peut envoyer des messages à jusqu’à cinq destinataires vérifiés sans frais — un moyen pratique de tester l’ensemble de la configuration avant d’y associer un vrai numéro.

Modèles

Les modèles de message fonctionnent sur cette connexion et sont hébergés dans votre propre compte WhatsApp Business. Créez-en un sur la page Modèles ; il sera alors créé sur ce compte et examiné par Meta, le résultat (approuvé, en attente ou rejeté) vous étant renvoyé ici. Les modèles que vous possédez déjà dans le Gestionnaire WhatsApp apparaissent automatiquement dans la liste, et un bouton Synchroniser depuis Meta permet d’importer toute modification effectuée là-bas. L’envoi fonctionne comme pour toute autre connexion WhatsApp : choisissez un modèle approuvé pour démarrer une conversation ou en rouvrir une en dehors de la fenêtre de 24 heures. Les détails sont disponibles dans Utilisation de modèles avec votre propre compte Meta WhatsApp.

Si quelque chose ne fonctionne pas

  • « Nous n’avons pas pu nous connecter avec ces informations » — copiez à nouveau chaque valeur ; un espace superflu en est généralement la cause. Le message inclut la réponse de Meta, qui indique généralement la valeur erronée.
  • L’erreur indique que le jeton est manquant whatsapp_business_management — votre application n’a pas encore reçu cette autorisation. Revenez à la partie 1, étape 3, appuyez sur Obtenir l’accès standard, puis générez un nouveau jeton avec les deux autorisations cochées et vérifiez à nouveau vos informations. Régénérer le jeton sans effectuer cette étape continuera de produire la même erreur.
  • Votre jeton a disparu — Meta n’affiche un jeton qu’une seule fois. Générez-en un nouveau à partir du même utilisateur système ; l’ancien continue de fonctionner jusqu’à ce que vous le révoquiez, mais seul le nouveau est visible.
  • Les réponses échouent avec « Cette conversation a été reçue sur le numéro WhatsApp Business …, qui n’est pas le numéro connecté » — votre application Meta possède plusieurs numéros et les utilisateurs envoient des messages à un numéro qui n’est pas celui connecté ici. Leurs messages s’affichent toujours, car Meta envoie les messages de l’application pour chaque numéro, mais les réponses ne peuvent être envoyées qu’à partir du numéro connecté, donc l’IA n’y répond pas. La carte WhatsApp sur la page Canaux affiche un avertissement mentionnant ce numéro alors que ses messages continuent d’arriver. La ligne du numéro sur cette carte ne comporte pas de bouton Reconnecter (seulement Définir comme principal et supprimer) : ouvrez à nouveau votre page de connexion à l’application Meta (Connecter WhatsApp sur la carte WhatsApp Business API, puis Utiliser un numéro que vous possédez déjà, puis Votre propre application Meta), appuyez sur Reconnecter sur la carte de connexion à cet endroit et choisissez le numéro auquel vos clients écrivent réellement. Le jeton de l’utilisateur système doit avoir accès à ce compte WhatsApp. Si ce numéro ne doit pas du tout atteindre Your AI Connector, supprimez-le (ou son compte WhatsApp) de votre application Meta à la place.
  • Les messages que vous initiez n’arrivent pas — vérifiez la remarque sur la fenêtre de 24 heures ci-dessus : en dehors de cette fenêtre, seuls les modèles de messages sont délivrés.
  • Rien n’arrive du tout — le numéro n’est probablement pas encore activé pour l’API Cloud. Un numéro ne peut être utilisé qu’à un seul endroit à la fois. Si vous êtes toujours connecté à l’application WhatsApp Business sur un téléphone, supprimez-le d’abord, puis appuyez sur Vérifier la connexion sur la carte de connexion. Your AI Connector l’active pour vous et vous indique immédiatement si Meta a encore besoin d’informations.
  • « Ce numéro possède déjà un code PIN de vérification en deux étapes » — le numéro a été configuré ailleurs auparavant et a conservé son code PIN. Désactivez la vérification en deux étapes pour ce numéro dans le Gestionnaire WhatsApp, puis appuyez sur Reconnecter.
  • « Meta n’a pas encore vérifié ce numéro » — terminez la vérification du numéro dans le Gestionnaire WhatsApp (Meta lui envoie un code), puis appuyez sur Reconnecter.
  • « Ce numéro est hébergé sur l’API sur site » — il fonctionne sur l’ancien produit auto-hébergé de WhatsApp, qui ne peut pas partager un numéro avec l’API Cloud. Migrez-le d’abord vers l’API Cloud dans le Gestionnaire WhatsApp.