Si Chatwoot ne parvient pas à récupérer les derniers modèles de messages depuis votre compte WhatsApp Business, vous pouvez fournir un jeton de gestion d’entreprise Meta pour la boîte de réception concernée.
Cette fonctionnalité est disponible uniquement sur Chatwoot Cloud pour les boîtes de réception WhatsApp créées via l’inscription intégrée, y compris les boîtes de réception coexistantes de l’application WhatsApp Business. Elle n’est pas disponible pour les boîtes de réception WhatsApp configurées manuellement.
Pourquoi Chatwoot a-t-il besoin de ce jeton ?
Chatwoot utilise normalement les identifiants créés lors de l’intégration WhatsApp pour synchroniser les modèles de messages. Dans certains cas, cet identifiant peut continuer à autoriser l’envoi et la réception de messages sans toutefois avoir les autorisations nécessaires pour lire ou gérer les actifs professionnels WhatsApp.
Un jeton de gestion d’entreprise fournit l’autorisation supplémentaire whatsapp_business_management requise pour récupérer les modèles depuis le compte WhatsApp Business.
Chatwoot utilise ce jeton uniquement pour la synchronisation des modèles. Il n’est pas utilisé pour :
-
Envoyer ou recevoir des messages WhatsApp
-
La livraison des webhooks
-
L’enregistrement de numéros de téléphone
-
Changer votre compte WhatsApp Business
-
Gérer votre portefeuille professionnel Meta
Avant de commencer
Assurez-vous que :
-
Vous êtes administrateur du portefeuille professionnel Meta qui possède le compte WhatsApp Business.
-
Vous pouvez accéder au compte WhatsApp Business concerné dans les paramètres d’entreprise Meta.
-
Votre entreprise dispose d’une application Meta associée à ce compte WhatsApp.
-
Vous êtes administrateur du compte Chatwoot.
-
La boîte de réception a été créée à l’aide de l’inscription intégrée WhatsApp sur Chatwoot Cloud.
Traitez le jeton comme un mot de passe. Ne l’envoyez pas par e-mail, chat ou conversation de support. Les administrateurs de compte Chatwoot peuvent voir et copier le jeton enregistré depuis l’onglet Configuration de la boîte de réception. Limitez l’accès administrateur et traitez ce jeton comme un identifiant sensible.
Étape 1 : Créer ou sélectionner un utilisateur système
-
Ouvrez Paramètres d’entreprise Meta.
-
Sélectionnez le portefeuille professionnel qui possède le compte WhatsApp Business.
-
Accédez à Utilisateurs → Utilisateurs système.
-
Sélectionnez un utilisateur système administrateur existant.
Si vous n’en avez pas :
-
Cliquez sur Ajouter.
-
Saisissez un nom reconnaissable, comme
Chatwoot template sync. -
Sélectionnez Admin comme rôle de l’utilisateur système.
-
Cliquez sur Créer un utilisateur système.
Utilisez un utilisateur système dédié lorsque c’est possible. Cela facilite la rotation ou la révocation du jeton sans affecter d’autres intégrations.
Étape 2 : Attribuer le compte WhatsApp Business
L’utilisateur système doit avoir accès au même compte WhatsApp Business utilisé par votre boîte de réception Chatwoot.
-
Sélectionnez l’utilisateur système.
-
Ouvrez Actifs attribués.
-
Cliquez sur Attribuer des actifs.
-
Sélectionnez Comptes WhatsApp.
-
Choisissez le compte WhatsApp Business connecté à Chatwoot.
-
Accordez la permission de gérer le compte ou activez le contrôle total.
-
Enregistrez vos modifications.
Attribuez uniquement le compte WhatsApp Business concerné. Évitez de donner accès à des ressources professionnelles non liées.
Étape 3 : Générer le jeton
-
Sélectionnez l’utilisateur système.
-
Cliquez sur Générer un jeton.
-
Sélectionnez l’application Meta associée à votre compte WhatsApp Business.
-
Cliquez sur Suivant.
Étape 4 : Choisir la durée de validité
Meta peut proposer des options comme :
-
60 jours : Plus sûr, mais vous devrez remplacer le jeton à expiration.
-
Jamais : Réduit la maintenance opérationnelle, mais exige un stockage sécurisé et une rotation manuelle.
Choisissez l’option qui suit la politique de sécurité de votre organisation.
Même un jeton sans expiration peut cesser de fonctionner si l’utilisateur système, l’application, la permission ou la relation d’actif/d’entreprise est modifiée ou révoquée.
Étape 5 : Sélectionner la permission requise
Sélectionnez :
whatsapp_business_management
C’est la permission que Chatwoot valide et utilise pour synchroniser les modèles de messages.
Vous n’avez pas besoin de sélectionner whatsapp_business_messaging ou whatsapp_business_manage_events pour ce jeton de synchronisation des modèles.
Si whatsapp_business_management n’est pas disponible, vérifiez que :
-
L’application sélectionnée est bien configurée pour WhatsApp.
-
L’utilisateur système a accès à l’application.
-
Le compte WhatsApp Business est attribué à l’utilisateur système.
-
Votre entreprise et votre application répondent aux exigences d’accès Meta.
Étape 6 : Copier le jeton
-
Finalisez le processus de génération du jeton.
-
Cliquez sur Copier.
-
Enregistrez temporairement le jeton dans un gestionnaire de mots de passe sécurisé ou un coffre de secrets.
Meta peut n’afficher le jeton complet qu’une seule fois.
Étape 7 : Ajouter le jeton dans Chatwoot
-
Dans Chatwoot, allez dans Paramètres → Boîtes de réception.
-
Sélectionnez la boîte de réception WhatsApp concernée.
-
Ouvrez l’onglet Configuration.
-
Recherchez Mettre à jour le jeton de gestion d’entreprise.
-
Collez le jeton.
-
Cliquez sur Mettre à jour.
Chatwoot vérifie que le jeton contient la permission accordée whatsapp_business_management avant de l’enregistrer.
Après avoir enregistré le jeton, cliquez sur Synchroniser les modèles. Vos modèles WhatsApp approuvés devraient apparaître une fois la synchronisation terminée. Pour remplacer le jeton, générez un nouveau jeton dans les paramètres d’entreprise Meta et soumettez-le via le même champ de configuration Chatwoot. Chatwoot utilisera le nouveau jeton pour les synchronisations futures.
Révoquer le jeton enregistré dans Meta sans le remplacer dans Chatwoot provoquera l’échec de la synchronisation des modèles.
Dépannage
Le jeton n’a pas la permission requise
Vérifiez que whatsapp_business_management a bien été sélectionné et accordé lors de la génération du jeton.
Vous n’avez pas la permission d’accéder à ce champ
Il se peut que l’utilisateur système n’ait pas accès au compte WhatsApp Business cible, ou que l’application sélectionnée ne soit pas autorisée pour celui-ci. Vérifiez à nouveau les actifs attribués à l’utilisateur système et la relation avec l’application.
Le jeton est invalide ou ne peut pas être validé
Le jeton a peut-être expiré, été révoqué ou généré pour une autre application ou entreprise. Générez un nouveau jeton et réessayez.
Le jeton est accepté, mais les modèles ne peuvent toujours pas être synchronisés
Vérifiez que :
-
L’utilisateur système a accès exactement au compte WhatsApp Business utilisé par la boîte de réception.
-
L’ID du compte professionnel configuré dans Chatwoot est correct.
-
Les modèles existent dans ce compte WhatsApp Business.
-
Les modèles n’ont pas été supprimés ou déplacés vers un autre compte.
La permission peut être valide alors que l’accès à la ressource WhatsApp spécifique manque encore.
Les messages fonctionnent, mais la synchronisation des modèles échoue
Les opérations de messagerie et de gestion d’entreprise utilisent des permissions différentes. Un identifiant peut continuer à envoyer et recevoir des messages sans pour autant avoir accès à la récupération des modèles.