Connectez votre numéro WhatsApp Business à Chatwoot en utilisant l’API Cloud WhatsApp de Meta. Ce guide vous explique comment préparer votre compte Meta, générer le jeton d’accès requis et créer votre boîte de réception WhatsApp dans Chatwoot.
Récupérer vos informations API Cloud WhatsApp depuis Meta
WhatsApp Cloud API est hébergée par Meta et disponible pour les entreprises et les développeurs individuels. Elle vous permet de vous connecter directement à la plateforme WhatsApp Business sans avoir recours à un fournisseur tiers pour héberger l’API.
Pour créer une boîte de réception WhatsApp, vous avez besoin de trois informations fournies par Meta :
-
ID du compte WhatsApp Business
-
ID du numéro de téléphone
-
Jeton d’accès permanent ou jeton d’utilisateur système
Vous pouvez obtenir l’ID du compte WhatsApp Business et l’ID du numéro de téléphone à partir de votre application Meta.
Créer ou sélectionner une application Meta
Rendez-vous sur Meta for Developers et sélectionnez une application existante ou cliquez sur Créer une application.
Si vous créez une nouvelle application, saisissez un nom d’application et un e-mail de contact, puis cliquez sur Suivant.
Choisissez le cas d’utilisation WhatsApp
Sur l’écran de sélection, choisissez Se connecter avec les clients via WhatsApp, puis cliquez sur Suivant.
Choisissez un portefeuille d’entreprise
Sélectionnez le portefeuille d’entreprise qui possède ou détiendra votre compte WhatsApp Business.
Si vous n’avez pas encore de portefeuille d’entreprise, vous pouvez en créer un à cette étape ou continuer et le créer plus tard si Meta le permet.
Vérifiez les exigences de publication
Meta peut afficher les exigences de publication pour l’application et le cas d’utilisation sélectionnés. Passez-les en revue et cliquez sur Suivant.
Vérifiez et créez l’application
Vérifiez les détails de l’application, le cas d’utilisation WhatsApp sélectionné et le portefeuille d’entreprise rattaché. Cliquez sur Créer l’application pour terminer.
Accéder à la configuration de l’API WhatsApp
Après avoir créé ou sélectionné l’application :
-
Cliquez sur Cas d’utilisation dans la barre latérale.
-
Trouvez Se connecter avec les clients via WhatsApp.
-
Cliquez sur Personnaliser.
-
Cliquez sur API Setup.
Dans la nouvelle interface de l’application Meta, allez à Configuration de base → Étape 2. Configuration de production et ouvrez Enregistrez votre numéro WhatsApp.
Pour les anciennes applications Meta, ouvrez WhatsApp → API setup depuis la barre latérale gauche.
Ajouter ou sélectionner votre numéro WhatsApp
Si ce numéro est actuellement actif dans l’application WhatsApp Business, ne le supprimez pas ou ne l’enregistrez pas manuellement via ce processus. Utilisez le flux Embedded Signup/Coexistence de Chatwoot, ou contactez le support Chatwoot.
Dans la section Envoyer et recevoir des messages ou Enregistrez votre numéro WhatsApp, choisissez un numéro existant via le sélecteur De, ou cliquez sur Ajouter un numéro de téléphone.
Si vous ajoutez un nouveau numéro :
-
Renseignez le nom d’affichage WhatsApp Business et les détails de votre entreprise.
-
Saisissez le numéro de téléphone.
-
Choisissez la vérification par SMS ou appel téléphonique.
-
Entrez le code OTP reçu de Meta pour vérifier le numéro.
Copiez les identifiants nécessaires
Une fois le numéro ajouté ou sélectionné, copiez ces valeurs depuis la page de configuration de l’API :
-
ID du numéro de téléphone
-
ID du compte WhatsApp Business
Vous devrez les saisir lors du processus de configuration manuelle.
Dans l’ancienne interface Meta, ces valeurs s’affichent directement sous le sélecteur De dans WhatsApp → API setup.
Meta modifie fréquemment cette interface. Si votre écran diffère, cherchez la page de configuration de l’API WhatsApp et le numéro d’expéditeur sélectionné. L’ID du numéro de téléphone et l’ID du compte WhatsApp Business apparaissent en général à proximité du numéro De sélectionné.
Configurer un jeton d’accès permanent WhatsApp Cloud API
Vous avez également besoin d’un jeton d’accès d’utilisateur système permanent avec les autorisations WhatsApp. Ce jeton permet à Chatwoot de se connecter à votre numéro WhatsApp Cloud API, d’envoyer et de recevoir des messages, et de synchroniser les modèles de messages.
Ouvrir les utilisateurs système dans les paramètres Meta Business
-
Ouvrez Meta Business Settings.
-
Sélectionnez le portefeuille d’entreprise qui possède votre compte WhatsApp Business.
-
Accédez à Utilisateurs → Utilisateurs système.
-
Si vous avez déjà un utilisateur système pour Chatwoot, sélectionnez-le.
-
Si ce n’est pas le cas, cliquez sur Ajouter.
Créez un utilisateur système
-
Saisissez un nom pour l’utilisateur système, par exemple
Chatwoot WhatsApp. -
Sélectionnez Admin comme rôle de l’utilisateur système.
-
Cliquez sur Créer un utilisateur système.
Générez un jeton
-
Sélectionnez l’utilisateur système.
-
Cliquez sur Attribuer des ressources.
-
Attribuez l’application Meta et le compte WhatsApp Business.
-
Accordez le niveau de contrôle requis.
-
Cliquez sur Générer un jeton.
Sélectionnez l’application Meta
Choisissez l’application Meta que vous avez créée ou sélectionnée plus tôt pour la configuration de l’API Cloud WhatsApp, puis cliquez sur Suivant.
Définir l’expiration du jeton
Sélectionnez Jamais comme expiration du jeton, puis cliquez sur Suivant.
Attribuer les autorisations
Sélectionnez les autorisations WhatsApp requises :
-
whatsapp_business_messaging -
whatsapp_business_management
Puis continuez pour générer le jeton.
Copiez le jeton
Après que Meta ait généré le jeton, cliquez sur Copier et conservez-le en lieu sûr.
Gardez ce jeton privé. Toute personne y ayant accès pourrait utiliser votre connexion WhatsApp Cloud API.
Connecter Votre Compte Chatwoot
Connectons maintenant votre compte Chatwoot avec votre API Cloud WhatsApp. Connectez-vous à votre compte Chatwoot, allez dans Paramètres > Boîte de réception > Sélectionnez le flux manuel.
Saisissez votre numéro de téléphone, l’ID du numéro, l’ID d’entreprise et le jeton d’accès que vous avez obtenu à l’étape précédente.
Ajoutez des membres à votre équipe pour votre boîte de réception WhatsApp
Copiez l’URL du webhook et le jeton de vérification du webhook fournis ici
Configurer Votre Webhook
Nous devons configurer le webhook WhatsApp pour recevoir les messages entrants envoyés à votre numéro d’entreprise.
Votre URL de callback doit suivre le format https://app.chatwoot.com/webhooks/whatsapp/{phone_number}.
Connectez-vous à votre compte développeur Facebook et rendez-vous sur WhatsApp > Configuration
Collez ici l’URL de webhook Chatwoot et le jeton de vérification, puis cliquez sur "Vérifier et enregistrer"
Définissez les autorisations du webhook en vous abonnant aux messages
Voilà, tout est prêt ! Vous pouvez maintenant commencer à envoyer des messages WhatsApp via Chatwoot.
FAQs
Comment configurer plusieurs numéros sous une seule application Meta ?
Une application Meta ne permet de configurer qu’un seul point de terminaison Webhook. Créez donc des boîtes de réception dans Chatwoot pour tous les numéros nécessaires. Vous devrez configurer l’URL du Webhook fournie pour une seule de ces boîtes de réception dans l’application Meta afin que toutes les autres boîtes de réception fonctionnent.
Quels types de modèles WhatsApp sont pris en charge par Chatwoot ?
Veuillez consulter la documentation pour plus de détails sur les modèles.
Quels sont les types de médias pris en charge ?
