Connectez un numéro WhatsApp Business grâce aux identifiants de l'API Meta Cloud et à des webhooks signés.
Connectez un numéro WhatsApp Business grâce aux identifiants de l'API Meta Cloud et à des webhooks signés.
Préparer l'application Meta et le numéro#
Suivez le guide de démarrage de l'API WhatsApp Cloud officiel de Meta pour créer ou sélectionner une application Meta, ajouter le produit WhatsApp, puis associer un compte WhatsApp Business et un numéro de téléphone.
Récupérez ces trois valeurs à partir de la même application et du même numéro :
| Champ Make Agent Fast | Valeur du fournisseur | Remarques |
|---|---|---|
| Phone number ID | Identifiant numérique du numéro de téléphone (Phone Number ID) | Il ne s'agit ni du numéro de téléphone visible commençant par +, ni de l'identifiant WABA |
| Access token | Jeton d'accès de l'API Cloud | Les jetons temporaires du tableau de bord expirent ; utilisez un jeton d'utilisateur système de longue durée adapté à la production |
| App secret | Clé secrète de l'application Meta | Une clé secrète hexadécimale de 32 caractères, utilisée pour vérifier la signature des webhooks |
N'accordez que les autorisations nécessaires au numéro et au flux de messagerie. Séparez les ressources de développement/test du numéro de production.
Enregistrer et valider les identifiants#
Ouvrez la page Canaux de l'agent, sélectionnez WhatsApp, saisissez les trois valeurs, choisissez Répondre par la voix si nécessaire, puis sélectionnez Connecter.
Make Agent Fast valide le numéro via l'API Graph à l'aide du jeton d'accès et de appsecret_proof ; cela permet de détecter un numéro, un jeton ou une clé secrète d'application incorrects avant le début du trafic webhook. La carte du connecteur affiche alors une URL du webhook et un Jeton de vérification uniques.
Configurer le webhook Meta#
Dans la même application Meta :
- Ouvrez la configuration du webhook WhatsApp.
- Collez l'URL du webhook du connecteur comme URL de rappel.
- Collez le Jeton de vérification du connecteur à l'identique ; il est sensible à la casse.
- Terminez la vérification.
- Abonnez le compte WhatsApp Business ou le numéro au champ de webhook
messages. - Vérifiez que l'application et les ressources de l'entreprise sont accessibles aux utilisateurs de test ou de production concernés.
Le jeton de vérification prouve que vous êtes propriétaire lors de la requête GET de vérification. Les requêtes POST en cours d'exécution sont authentifiées séparément par la signature de la clé secrète de l'application Meta ; ne substituez pas l'un à l'autre.
Tester le texte et la voix#
Envoyez d'abord un message depuis un numéro de test autorisé. En mode développement Meta, les utilisateurs non enregistrés peuvent ne pas pouvoir joindre l'application. Vérifiez le fil et le canal dans Conversations et surveillez Dernier message sur la carte du connecteur.
Les messages entrants texte et vocaux sont pris en charge. Lorsque Répondre par la voix est activé et que la synthèse vocale est configurée, Make Agent Fast téléverse l'audio généré via l'API Cloud et l'envoie en complément de la réponse textuelle. Les images, les localisations, les contacts et les autres types de messages non pris en charge sont ignorés.
Prêt pour la production#
Avant de communiquer le numéro, effectuez la vérification de l'entreprise auprès de Meta, la révision de l'application, la validation du nom d'affichage, les modèles de messages et les étapes liées à la politique de messagerie requises pour votre cas d'usage. Ces exigences sont contrôlées par Meta et peuvent évoluer indépendamment de Make Agent Fast.
Utilisez un identifiant de production avec un responsable clairement désigné et une procédure d'expiration/rotation. Notez quelle application Meta, quel utilisateur système, quel WABA et quel Phone Number ID correspondent à ce connecteur afin qu'un opérateur puisse effectuer la rotation sans tâtonner.
Effectuer la rotation ou déconnecter#
Créez un jeton de remplacement avec les mêmes accès aux ressources, mettez à jour le connecteur, envoyez un message de test, et ne révoquez l'ancien jeton qu'ensuite. Si la clé secrète de l'application change, mettez-la à jour immédiatement dans Make Agent Fast, sinon tous les webhooks entrants signés échoueront.
Désactiver ou supprimer le connecteur ne désabonne pas et ne supprime pas la configuration du webhook Meta. Supprimez également l'abonnement côté fournisseur lorsque vous mettez définitivement le numéro hors service.
Dépannage#
| Symptôme | Solution |
|---|---|
| Identifiants rejetés | Vérifiez que le jeton peut lire le Phone Number ID exact et que la clé secrète provient de la même application |
| Meta ne parvient pas à vérifier l'URL de rappel | Utilisez l'URL HTTPS copiée et le jeton de vérification exact ; assurez-vous que le connecteur existe toujours |
| La vérification réussit mais aucun message n'arrive | Abonnez-vous à messages, vérifiez l'association WABA/numéro, le mode de l'application, l'accès des utilisateurs de test et les journaux de livraison du fournisseur |
| Les webhooks renvoient une erreur d'autorisation | Saisissez à nouveau la bonne clé secrète de l'application ; les signatures POST de Meta n'utilisent pas le jeton de vérification |
| Les réponses sortantes échouent | Vérifiez l'expiration du jeton, les autorisations du numéro, la politique/la fenêtre de messagerie du destinataire et les erreurs de l'API Graph |
| Le texte fonctionne mais pas l'audio | Vérifiez les clés des fournisseurs de transcription/synthèse vocale et l'accès du jeton au téléversement/téléchargement de médias |
N'exposez jamais le jeton d'accès ni la clé secrète de l'application dans du code côté navigateur. Utilisez l'API publique uniquement depuis un serveur de confiance lorsque vous automatisez la création de connecteurs.