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.

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 texte simple sera accepté par Meta mais ne sera pas distribué.
  • Meta vous facture directement les conversations aux tarifs nationaux publiés, sur 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.
  • Gardez un mode de paiement valide sur ce compte WhatsApp. Sans cela, Meta bloque chaque conversation que votre entreprise initie — diffusions, campagnes et tout message modèle — et affiche l’erreur dans WhatsApp Manager. Sur cette connexion, une diffusion ou une campagne refuse de se lancer tant que c’est le 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 passent toujours pour le moment, mais à partir du 1er octobre 2026, Meta facturera également ces dernières. Un compte sans mode de paiement fonctionnel deviendra donc totalement silencieux à cette date. L’ensemble des informations se trouve sur Coûts WhatsApp & le changement d’octobre 2026.
  • Votre estimation de coût est différente ici. Comme ces frais ne touchent jamais vos crédits, l’estimation à l’étape de révision d’une diffusion (et à l’étape de lancement d’une campagne) 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 de crédits.
  • Les numéros de test sont gratuits. Le numéro de test que Meta donne à chaque nouvelle application peut envoyer des messages à jusqu’à cinq destinataires vérifiés sans frais — un moyen pratique d’essayer la configuration complète avant d’y pointer 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 détails » — copiez à nouveau chaque valeur ; un espace parasite est la cause habituelle. Le message inclut la réponse de Meta, qui nomme généralement la valeur incorrecte.
  • 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 détails. Régénérer le jeton sans 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 messages que vous initiez n’arrivent pas — vérifiez la note sur la fenêtre de 24 heures ci-dessus : en dehors de cette fenêtre, seuls les messages modèles sont 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 le numéro est 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’un élément.
  • « 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 (On-Premises) » — 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.