WhatsApp¶
WhatsApp est une application de messagerie instantanée et de VoIP qui permet aux utilisateurs d’envoyer des messages, de passer des coups de fil et de partager du contenu. Les entreprises peuvent utiliser WhatsApp Business pour envoyer des messages à leurs clients, envoyer des documents et fournir de l’assistance.
Avertissement
WhatsApp is an Odoo Enterprise-only application that does not work in Odoo Community edition. To sign up for Odoo Enterprise edition, click here: Odoo Free Trial.
Pour plus d'infos
For more information on migrating from Odoo Community version to Odoo Enterprise version see this documentation: Basculer de Community à Enterprise.
Avec l’application Odoo WhatsApp, une entreprise peut lier un compte WhatsApp Business (WABA) à une base de données Odoo, qui permet les choses suivantes :
Recevoir des messages WhatsApp et y répondre directement à partir d’une base de données Odoo
Créer de nouveaux modèles dans des placeholders/variables dynamiques
Envoyer des modèles pré-approuvés qui utilisent des variables dynamiques tels que :
Des devis provenant de l’application Ventes
Des reçus et des factures de l’application Point de Vente
Des tickets de l’application Événement
Pour plus d'infos
WhatsApp is est un service de messagerie exploité par Meta, la société mère de Facebook. WhatsApp est couramment utilisé comme outil de communication dans de nombreux pays et par de nombreuses entreprises. Cette documentation couvre l’intégration d’un compte WhatsApp Business avec Odoo. Le compte Meta de l’entreprise est configuré dans Odoo via une connexion API.
Le connecteur WhatsApp prend en charge deux flux : celui initié par l’entreprise et celui initié par le client. Une entreprise peut lancer une discussion en envoyant un modèle à une ou plusieurs personnes. Une fois le modèle envoyé, le destinataire peut répondre afin de déclencher une discussion entre l’expéditeur et le destinataire (une fenêtre de Discussion s’ouvre si le client répond dans les 15 jours).
Si la conversation est initiée par le client (par ex. par l’envoi d’un message au numéro WhatsApp public de l’entreprise), Odoo ouvre une discussion de groupe avec tous les opérateurs responsables de ce canal WhatsApp.
Astuce
Il est recommandé de créer plusieurs comptes WhatsApp pour différents départements. Par exemple, l’équipe d’assistance et les équipes commerciales peuvent discuter sur des canaux différents.
Configuration WhatsApp dans Meta¶
L’intégration WhatsApp à Odoo utilise une connexion API standard et peut être configurée sur Meta selon les étapes suivantes :
Créer un compte Meta business
Créer un compte développeur sur Meta
Configurer une app et un produit WhatsApp sur la console développeur de Meta
Tester la connexion API
Une fois la connexion établie, les messages sont envoyés et reçus via l’application Discussion d’Odoo à l’aide de l”API de WhatsApp.
Configuration du compte Meta business¶
Pour créer un compte Business avec Meta (propriétaire de Facebook), allez à Facebook Business Manager. Commencez par cliquez sur Créer un compte, puis saisissez le nom de l’entreprise, le nom de l’administrateur et une adresse email professionnelle. Cliquez ensuite sur Suivant et une fenêtre contextuelle s’ouvre et vous invite à confirmer l’adresse email. Après confirmation, cliquez sur Fait pour fermer la fenêtre.
Suivez ensuite les instructions dans l’email envoyé par Facebook pour confirmer la création du compte Business et d’achever le processus de configuration.
Pour plus d'infos
Important
Si le compte business est lié à un compte personnel de Facebook, l’administrateur doit passer du compte personnel au compte business pour le reste de la configuration.
Pour passer au compte business, allez à la Console développeur de Facebook et cliquez sur le nom du compte dans le coin supérieur droit. Dans la section Comptes business, cliquez sur l’entreprise souhaitée pour laquelle la configuration de WhatsApp doit avoir lieu. Ce sera le compte pour lequel Odoo enverra et recevra des messages WhatsApp.
Important
Afin de créer un compte Meta business, l’utilisateur doit déjà avoir un compte Facebook personnel existant depuis au moins une heure avant la configuration du compte Business Facebook. Toute tentative de créer un compte business avant l’écoulement de ce laps de temps se soldera par un message d’erreur.
Création de l’application¶
Sur le tableau de bord Meta for Developers, connectez-vous avec le compte développeur de Meta. Si aucun compte n’est encore configuré, liez un compte Facebook pour créer un compte développeur sur Meta.
Note
Un compte développeur Facebook est différent d’un compte business Facebook. Tandis que les comptes de développeur sont constitués de comptes Facebook personnels, les comptes business ne le sont pas, car ils représentent une entreprise et gèrent tous les actifs de l’entreprise dans Meta, tels que les applications.
Pour plus d'infos
Cliquez sur Mes apps dans le coin supérieur droit après vous être connecté au compte développeur Meta. Cela redirige l’administrateur vers toutes les applications que le développeur a configurées dans ce compte développeur spécifique. Cliquez sur Créer une app pour lancer le processus de configuration d’une nouvelle application Meta.
Type d’application¶
Sur la page Autre dans la section intitulée Vous cherchez autre chose ?, et cliquez sur Suivant pour être redirigé vers une autre page afin de sélectionner le type d’application. Cliquez ensuite sur la première option répertoriée sous le libellé Sélectionner un type d’app, intitulé Business. Cette sélection vous permet de créer et de gérer l”API de WhatsApp.
, sélectionnezCliquez sur Suivant pour configurer l’application comme vous le souhaitez. Lorsque vous avez configuré le type d’application, l’administrateur passera à la section détails de l’application.
Détails de l’application¶
Dans la section Détails du processus Créer une app, saisissez Odoo
dans le champ sous l’intitulé Ajouter un nom d’app.
Note
Vous pouvez modifier le nom de l’app ultérieurement dans les paramètres si nécessaire.
Avertissement
Les marques commerciales et les éléments de marque ne peuvent pas être utilisés dans cette section du texte. Il s’agit notamment du groupe de sociétés Meta. N’incluez pas le mot : WhatsApp
ou le système le signalera comme une erreur.
Ensuite, saisissez l’adresse email du développeur dans le champ situé sous le libellé App contact email.
Enfin, définissez le champ Business Account - Facultatif sur le profil du compte business Meta, à l’aide du menu déroulant. Pour terminer, cliquez sur Créer une app. Cette action crée l’application et vous invite à accepter les Conditions de la plateforme Meta et les Politiques du développeur.
Pour accepter les accords, saisissez le mot de passe Facebook à des fins de sécurité et cliquez sur Soumettre pour finaliser la création de l’application. Le navigateur sera alors dirigé vers le tableau de bord Meta for Developers.
Note
Si le compte business Meta n’est pas autorisé à faire de la publicité, il ne sera pas possible de revendiquer une application. Pour résoudre ce problème, allez à https://business.facebook.com/business pour obtenir de l’aide.
Pour plus d’informations, consultez la documentation de Meta relative aux restrictions publicitaires.
Ajouter un produit WhatsApp à l’app¶
Maintenant que la structure de base de l’application a été créée, un produit doit être ajouté à l’app. Commencez par accéder au tableau de bord de l’application Meta en allant à https://developers.facebook.com/apps, puis en cliquant sur l’application à configurer.
Sur la page suivante : étant donné que WhatsApp sera utilisé, cliquez sur Configurer à côté de la case contenant WhatsApp, situé au bas de la page.
Pour plus d'infos
La page redirige alors à la page de configuration de l”API de la plateforme business WhatsApp. Utilisez le menu déroulant pour sélectionner le Meta business à configurer pour l’option Sélectionnez un compte business Meta et cliquez sur Continuer pour confirmer la sélection.
Note
Lorsque vous cliquez sur Continuer, l’administrateur accepte les conditions de Meta telles qu’elles figurent sur le tableau de bord de l’App Meta.
Note
Une fois que le produit WhatsApp est ajouté à l’app, Meta fournira un numéro de téléphone test WhatsApp avec 5 messages de test.
Commencer à utiliser l’API WhatsApp¶
Après avoir terminé l’assistance de produit WhatsApp précédent et avoir cliqué sur Continuer, le navigateur devrait avoir été redirigé vers la page de Démarrage rapide de WhatsApp ; cette page de Démarrage vous permet de commencer la configuration de l’API WhatsApp en ajoutant un numéro de téléphone et en envoyant un premier message de test.
Note
Si le navigateur n’est pas sur la page Démarrage rapide de WhatsApp, allez à https://developers.facebook.com/apps et cliquez sur l’application à configurer (le nom de l’app est Odoo
si vous avez bien suivi les instructions susmentionnées).
Ensuite, dans le menu sur le côté gauche de la page, cliquez sur l’icône v (menu bascule) à côté de l’en-tête de la section WhatsApp. Un petit menu s’ouvre et propose les options suivantes :
Démarrage rapide
Configuration de l’API
Configuration
Cliquez sur l’option Démarrage rapide et cliquez sur Commencer à utiliser l’API.
Configuration de l’API¶
Après avoir cliqué sur Commencer à utiliser l’API, la page redirige vers la Configuration de l’API. Maintenant que le numéro de test a été créé, un message de test peut être envoyé pour confirmer que WhatsApp fonctionne correctement. Pour commencer, allez à la section sur la page intitulée Envoyer et recevoir des messages et cliquez sur le menu déroulant à côté de À, sous Étape 1 Sélectionner des numéros de téléphone.
Sélectionnez ensuite la seule option disponible : Gérer la liste de numéros de téléphone. Suivez les étapes et ajoutez jusqu’à cinq numéros auxquels vous voulez envoyer les messages de test gratuits. Après avoir saisi le code de pays et le numéro de téléphone appropriés, cliquez sur Suivant.
Important
L’ajout d’un numéro de téléphone auquel envoyer le message à cette étape permet au terminal d’envoyer un test réussi. Cette étape est essentielle pour s’assurer que l”API WhatsApp fonctionne.
Un code de vérification de WhatsApp Business est ensuite envoyé au numéro de téléphone. Ce code doit être saisi dans l’écran suivant pour vérifier la propriété du numéro. Saisissez le code de vérification et cliquez sur Suivant pour vérifier le numéro.
Envoyer un message de test via le terminal¶
Ensuite, envoyez un message de test via le terminal. Dans la section intitulée Étape 2 Envoyer des messages avec l’API, cliquez sur Envoyer un message. Un message de test est alors envoyé au numéro de téléphone déterminé dans la section précédente.
Si le message est reçu avec succès, passez à la section suivante pour produire et configurer des webhooks.
Configuration de WhatsApp dans Odoo¶
Les étapes suivantes configurées dans cette section se trouvent toutes dans la base de données Odoo. Vous devez configurer des valeurs différentes pour un jeton, un numéro de téléphone et des identifiants de compte dans Odoo ; ces valeurs sont nécessaires afin de créer une URL de rappel et un Jeton de vérification Webhook, qui sont ensuite utilisés pour configurer les webhooks (afin de recevoir des messages dans la base de données).
Dans Odoo, allez à l’application Nouveau pour configurer le compte WhatsApp business dans Odoo.
. Cliquez ensuite surDans un autre onglet du navigateur, allez à
, et copiez ensuite les valeurs suivantes de la console développeur Meta dans les champs correspondants dans Odoo :Nom |
Console Meta |
Interface Odoo |
---|---|---|
Téléphone |
ID numéro de téléphone |
ID numéro de téléphone |
Jeton |
Jeton d’accès temporaire |
Jeton d’accès |
App ID |
App ID |
App ID |
ID du compte |
ID compte WhatsApp Business |
ID compte |
Pour récupérer le Secret de l’App, allez à la console développeur Meta, https://developers.facebook.com/apps et sélectionnez l’application dans laquelle Odoo est configuré. Ensuite, dans le menu de gauche, sous paramètres de l’App, sélectionnez Basique.
Ensuite, cliquez sur Afficher à côté du champ Secret de l’app, et saisissez le mot de passe du compte pour vérifier la propriété. Copiez le Secret de l’app et collez cette valeur copiée dans le champ Secret de l’app dans le tableau de bord de configuration du compte WhatsApp Business d’Odoo.
Pour terminer la configuration du compte WhatsApp Business dans Odoo, cliquez sur Tester la connexion. Un message de réussite en vert s’affichera dans le coin supérieur droit du tableau de bord si la configuration est correcte.
Configurer les webhooks¶
Pour configurer les webhooks pour WhatsApp dans Odoo, allez à https://developers.facebook.com/apps et sélectionnez l’application dans laquelle Odoo est configuré. Ensuite, dans l’en-tête du menu WhatsApp du côté gauche de l’écran, cliquez sur le menu Configuration de l’API. Enfin, allez à la section intitulée Étape 3 : Configurer les webhookds pour recevoir des messages et cliquez sur Configurer des webhooks.
Astuce
Une autre façon de configurer des Webhooks est d’aller à https://developers.facebook.com/apps et de sélectionner l’application dans laquelle Odoo est configuré. Sélectionnez ensuite Webhooks dans le menu de gauche.
Sur la page Modifier, où les valeurs URL de rappel et Jeton de vérification du Webhook d’Odoo seront ajoutées.
, cliquez surNote
Les valeurs URL de rappel et Jeton de vérification du webhook sont remplies automatiquement après avoir cliqué sur Tester la connexion dans l’étape précédente.
Dans une fenêtre de navigation séparée, récupérez les valeurs nécessaires dans Odoo en allant à l’application Recevoir des messages.
et sélectionnez le compte à configurer. Localisez les valeurs sous la section intituléeCopiez et collez la valeur URL de rappel d’Odoo dans le champ URL de rappel dans Meta. De même, copiez et collez le Jeton de vérification de webhook dans le champ Jeton de vérification dans la console développeur de Meta.
Enfin, cliquez sur Vérifier et enregistrer pour enregistrer les valeurs dans la console développeur de Meta.
Champs webhook¶
Saisissez maintenant les champs individuels du webhook dans la console développeur de Meta, dans la section Champs webhook. Cliquez sur Gérer et lorsque la fenêtre contextuelle s’affiche, cochez les cases dans la colonne S’abonner pour les noms de champs suivants :
account_update
message_template_quality_update
message_template_status_update
messages
template_category_update
Après avoir effectué les sélections, cliquez sur Fait.
La configuration des Webhooks terminée apparaîtra comme suit dans la console développeur de Meta :
Important
Les Champs Webhook n’apparaîtront qu’une fois que l’abonnement est confirmée à l’aide de l”URL de rappel et le Jeton de vérification du Webhook.
Pour plus d'infos
Documentation WhatsApp de Meta relative à la configuration des webhooks.
Ajouter un numéro de téléphone¶
Pour configurer le numéro de téléphone pour WhatsApp dans Odoo, revenez à la console développeur de Meta (https://developers.facebook.com/apps) et sélectionnez à nouveau l’application dans laquelle Odoo est configuré. Sous l’en-tête de menu WhatsApp du côté gauche de l’écran, cliquez sur le menu Configuration de l’API Setup. Allez ensuite à la section intitulée : Étape 5 : Ajouter un numéro de téléphone, et cliquez sur Ajouter un numéro de téléphone.
Dans les champs, saisissez un Nom d’entreprise ainsi qu’un site web ou une page de profil d’entreprise.
Astuce
Le champ site web ou page de profil d’entreprise peut être l”URL d’une page de réseau social.
Pour compléter les informations relatives à l’entreprise, sélectionnez ensuite le pays dans lequel l’entreprise exerce ses activités dans le menu déroulant de la section Pays section. Ajoutez une adresse le cas échéant. Ces informations sont toutefois optionnelles. Après avoir ajouté le lieu, cliquez sur Suivant pour continuer.
La page suivante contient des informations pour le Profil WhatsApp Business. Complétez les sections suivantes :
Nom d’affichage du profil WhatsApp Business
Fuseau horaire
Catégorie
Description de l’entreprise (facultatif)
Une fois que ces sections sont remplies, cliquez sur Suivant. La page s’actualise et invite l’administrateur à Ajouter un numéro de téléphone pour WhatsApp dans le champ respectif. Saisissez ici le numéro de téléphone à configurer dans WhatsApp.
Pour plus d'infos
Choisissez ensuite une méthode de vérification pour le numéro de téléphone. Sélectionnez ensuite SMS ou Appel téléphonique, et cliquez sur Suivant pour continuer.
Le numéro de téléphone saisi recevra un sms ou un appel téléphonique par WhatsApp avec un code, en fonction de la méthode de vérification choisie. Saisissez ce code de vérification dans le champ Code de vérification et cliquez sur Suivant pour terminer.
Avertissement
Vous devez ajouter un mode de paiement pour continuer. Consultez la documentation de Meta sur la façon d’ajouter un mode de paiement dans le Business Manager de Meta. Ceci fait partie du système de détection des fraudes de Meta, afin de s’assurer que le compte/la société sont réels, un mode de paiement est nécessaire pour continuer.
Pour plus d'infos
Jeton permanent¶
Une fois la configuration et les tests terminés, un jeton permanent doit être créé pour remplacer le Jeton temporaire.
Pour plus d'infos
Meta for Developers : Jetons d’accès de l’utilisateur du système.
Commencez par aller à https://business.facebook.com/ et allez à . Sélectionnez un utilisateur système existant ou créez un nouvel utilisateur système en cliquant sur Ajouter.
Les éléments doivent maintenant être ajoutés à l’utilisateur système, puis un jeton permanent peut être généré.
Cliquez sur Ajouter des éléments, et dans la fenêtre contextuelle, sélectionnez Apps sous Sélectionner le type d’élément. Sélectionnez ensuite l’app Odoo et activer les permissions sous l’option Contrôle total. Définissez ce nouveau paramètre de permission en cliquant sur Enregistrer les modifications, ce qui fait apparaître une fenêtre de confirmation, confirmant l’ajout de l’élément à l’utilisateur système. Terminez en cliquant sur Fait.
Le jeton permanent sera ensuite généré. Cliquez sur Générer un nouveau jeton, et une fenêtre contextuelle s’affiche pour vous demander pour quelle application ce jeton doit être généré. Sélectionnez l” App à laquelle ce jeton est destiné. Déterminez ensuite la date d’expiration (60 jours ou Jamais).
Enfin, lorsque Meta demande quelles sont les autorisations que l’utilisateur système doit autoriser, ajoutez toutes les autorisations suivantes :
WhatsApp_business_messaging
WhatsApp_business_management
Lorsque les permissions sont définies, cliquez sur Générer le jeton. Copiez la valeur du jeton qui s’affiche sur l’écran suivant.
Saisissez cette valeur de jeton dans le champ Jeton d’accès dans le compte WhatsApp Business dans Odoo en allant à l’application .
Lancer l’application Meta¶
Enfin, pour lancer l’application, l’app Meta doit être mise en ligne dans la console développeur de Meta. Allez à https://developers.facebook.com/apps et cliquez sur l’application en cours de configuration. Dans le menu supérieur, faites basculer le champ App Mode de Développement à Live.
Important
Si le statut de l’application n’est pas live, la base de données pourra uniquement contacter les numéros de test définis dans la console développeur.
Avertissement
Une URL de politique de confidentialité doit être définie pour que l’application puisse être mise en ligne. Allez à la console développeur de Meta https://developers.facebook.com/apps et sélectionnez l’application dans laquelle Odoo est configuré. Utilisez ensuite le menu du côté gauche de l’écran pour aller aux . Ensuite, saisissez l’adresse de l’hyperlien de la politique de confidentialité dans le champ URL politique confidentialité du formulaire. Cliquez sur Enregistrer les modifications pour appliquer la politique de confidentialité à l’application.
Une fois que l’application est mise en ligne dans la console développeur de Meta, un email de confirmation est envoyé à l’administrateur.
Modèles WhatsApp¶
Les modèles WhatsApp sont des messages enregistrés qui sont utilisés régulièrement pour envoyer des messages à partir de la base de données. Ils permettent aux utilisateurs d’envoyer des communications de qualité, sans avoir à rédiger le même texte à plusieurs reprises.
La création de différents modèles adaptés à des situations spécifiques permet donc aux utilisateurs de choisir le bon message pour le bon public. Cela augmente la qualité du message et le taux d’engagement global.
Les modèles WhatsApp peuvent être créés à la fois dans Odoo et dans Meta. La procédure suivante passe d’abord en revue la création de modèles dans Odoo et ensuite dans Meta.
Important
WhatsApp a mis en place un processus d’approbation qui doit être complété avant de pouvoir utiliser le modèle. Approbation du modèle Meta.
Créer des modèles dans Odoo¶
Pour créer et accéder aux modèles WhatsApp, commencez par aller à l’application
.Au bas du formulaire de modèle individuel, il y a trois onglets : Corps, Boutons, et Variables ; vous pouvez créer le modèle WhatsApp en combinant ces trois onglets.
Le texte est saisi dans l’onglet Corps et le contenu dynamique appelé dans l’onglet Corps est précisé dans l’onglet Variables. Chaque élément de contenu dynamique (par ex. placeholders) dans le message (corps) est spécifiquement appelé et précisé dans l’onglet Variables.
Les modèles sont des mises en page préfabriquées qui permettent aux utilisateurs d’envoyer des messages professionnels aux clients. Ces modèles peuvent contenir des données dynamiques qui seront intégrées dans le message final à l’aide de variables définies dans la configuration du modèle. Par exemple, les messages peuvent contenir le nom de l’utilisateur final, appeler des produits spécifiques ou faire référence à une commande, pour ne citer que quelques variables pratiques et percutantes.
Pour créer un modèle WhatsApp, allez à l’application Nouveau. Sur le formulaire, donnez un Nom au modèle et sélectionnez une Langue.
et cliquez surImportant
Afin de compléter cette tâche suivante, vous avez besoin des droits d’accès d’administrateurs pour modifier le champ S’applique à. Consultez cette documentation relative aux droits d’accès pour plus d’informations.
Dans le menu déroulant Compte, sélectionnez le compte WhatsApp business dans Odoo auquel ce modèle doit être lié. Ensuite, sous le champ S’applique à, sélectionnez le modèle auquel l’action de serveur s’appliquera pour ce modèle.
Astuce
Ces modèles sont également accessibles en mode développeur. Sur un formulaire de contact (ou un formulaire similaire dans Odoo), allez au modèle qui sera référencé et survolez n’importe quel nom de champ. Une boîte d’informations sur le backend s’affichera avec le nom spécifique du Modèle Odoo dans le backend. Recherchez (à l’aide du nom frontend) ce modèle dans le menu déroulant S’applique à du modèle WhatsApp.
Avertissement
Souvent, lorsque l’on change le modèle ou le champ S’applique à, le champ Numéro de téléphone peut produire un message d’erreur. Le champ Numéro de téléphone doit toujours être défini sur Téléphone
ou Mobile
.
Pour rechercher les champs disponibles, saisissez le nom du frontend dans la boîte Rechercher…. Vous obtiendrez ainsi un résultat pour tous les champs disponibles pour le modèle (S’applique à) pour lequel le modèle a été créé.
Note
Afin de trouver des champs spécifiques, il peut être nécessaire de naviguer sur plusieurs niveaux dans la boîte de résultats de la recherche. Utilisez les icônes > (chevron droit) and ⬅️ (flèche gauche) pour naviguer entre les niveaux du menu.
Modifiez la Catégorie pour qu’elle corresponde à une catégorie de Marketing, d”Utilité, ou d”Authentification. Dans la plupart des cas, les deux premières options seront utilisées, à moins que l’utilisateur ne souhaite envoyer une réinitialisation du mot de passe ou un message lié à la sécurité. La catégorie Marketing est utilisée pour les messages promotionnels et la catégorie Utilité pour les messages transactionnels généraux (par ex. commande, ticket d’événement, etc.).
Important
L’indication d’une catégorie incorrecte peut entraîner un signalement/rejet de la part de Meta pendant le processus d’approbation.
Ajoutez les Utilisateurs autorisés à utiliser ce modèle. Dans la colonne de droite, un Type d’en-tête peut être configuré ainsi qu’un Message d’en-tête.
Les Types d’en-tête disponibles sont les suivants :
Texte
Image
Vidéo
Document
Emplacement (les variables doivent être définis)
Allez à l’onglet Corps pour configurer le message principal du modèle.
Lorsque tous les changements nécessaires sont apportés au modèle, cliquez sur le bouton Soumettre pour approbation dans le coin supérieur gauche. Le statut du modèle passera alors à En attente.
Le statut restera En attente jusqu’à ce que Meta ait pris une décision. Un email de confirmation sera envoyé, indiquant que le modèle a été approuvé (ou rejeté). Les modèles devront alors être synchronisés à partir de la base de données Odoo.
Consultez cette section pour plus d’informations sur la synchronisation des modèles.
Astuce
Il existe des modèles de données de démonstration préconfigurés disponibles dans Odoo pour les utiliser ou les modifier. Ces modèles peuvent être utilisés tels quels ou modifiés pour répondre à un besoin spécifique de l’entreprise.
Pour utiliser ces modèles, allez à l’application Soumettre pour approbation pour lancer le processus d’approbation. Un email sera envoyé à l’administrateur du compte Meta lorsque le modèle a été approuvé.
et sélectionnez un modèle préconfiguré. Cliquez surUtiliser des placeholders et des variables¶
Les variables dynamiques font référence à certains champs dans la base de données Odoo pour produire des données uniques dans le message WhatsApp lorsque vous utilisez un modèle. Les variables dynamiques sont codées pour afficher des champs de la base de données, en référençant les champs d’un modèle.
Example
La plupart des entreprises aiment personnaliser leurs messages WhatsApp en ajoutant un élément personnel sur le client pour attirer son attention. Dans Odoo, vous pouvez faire référence à un champ dans un modèle en définissant une variable dynamique. Par exemple, le nom d’un client peut être référencé dans l’email à partir du champ Client sur le modèle Commande.
Vous pouvez ajouter des variables dynamiques au Corps en ajoutant des placeholders dans le texte. Pour ajouter un placeholder dans le corps du message, saisissez le texte suivant {{1}}
. Pour le deuxième placeholder, saisissez {{2}}
et augmentez progressivement au fur et à mesure que d’autres placeholders sont ajoutés au texte.
Example
Voici le texte du corps du modèle de reçu de paiement :
Bonjour {{1}},
Merci
Pour plus d'infos
Ces placeholders doivent être configurés dans l’onglet Variables du modèle avant de le soumettre à Meta pour approbation. Pour modifier les variables dynamiques d’un modèle, modifiez d’abord le Type en Champ du modèle. Ceci permet à Odoo de référencer un champ dans un modèle pour produire des données uniques dans le message à envoyer.
Modifiez ensuite le Champ des variables dynamiques. Le champ S’applique à dans le modèle doit être modifié auparavant pour s’assurer que le bon modèle et le bon champ sont référencés.
Pour rechercher les champs disponibles, saisissez le nom frontend du champ dans la zone de recherche. Vous obtiendrez ainsi un résultat de tous les champs disponibles pour le modèle (S’applique à) pour lequel le modèle est créé. Il peut y avoir plusieurs niveaux à configurer.
Example
Voici un exemple des variables définies pour les placeholders susmentionnés dans le reçu de paiement :
Nom |
Exemple de valeur |
Type |
Champ |
---|---|---|---|
corps - {{1}} |
Azure Interior |
Champ du modèle |
|
corps - {{2}} |
INV/2022/00001 |
Champ du modèle |
|
corps - {{3}} |
Ma société |
Champ du modèle |
|
corps - {{4}} |
$ |
Champ du modèle |
|
corps - {{5}} |
4000 |
Champ du modèle |
|
corps - {{6}} |
https://.. |
Lien portail |
Example
Par exemple, dans l’onglet Corps, si vous tapez ce qui suit : « Bonjour {{1}}, », ensuite {{1}}
doit être défini dans l’onglet Variables. Pour ce cas spécifique, le message doit saluer le client par son nom, donc le {{1}}
doit être configuré pour remplir le Champ {{1}}
avec le nom du Client.
Avertissement
La personnalisation des modèles WhatsApp n’est pas du ressort de l’assistance d’Odoo.
Approbation du modèle Meta¶
Après avoir mis à jour les variables dynamiques sur le modèle, le modèle doit à nouveau être soumis à Meta pour approbation. Cliquez sur Soumettre pour approbation pour lancer le processus d’approbation. Un email sera envoyé à l’administrateur du compte Meta lorsque le modèle a été approuvé.
Suite à l’approbation par Meta, synchronisez à nouveau modèles dans la base de données Odoo. Consultez cette documentation : Synchroniser des modèles.
Astuce
Pour voir le statut dans le tableau de bord des modèles WhatsApp dans Meta, allez à https://business.facebook.com/wa/manage/home. Ensuite, allez aux .
Synchroniser des modèles¶
Les modèles doivent être synchronisés dans la base de données Odoo une fois qu’ils ont été approuvés par l’équipe Meta. Pour ce faire, allez à l’application Synchroniser les modèles. Meta mettra à jour les modèles qui sont approuvés, pour qu’ils puissent être utilisés dans différentes applications de la base de données.
et sélectionnez la configuration qui doit être synchronisée. Dans la section intitulée , vers le bas, cliquez surUn message de réussite en vert apparaît dans le coin supérieur droit avec le nombre de modèles mis à jour.
Astuce
Les modèles peuvent également être synchronisés individuellement à partir du modèle lui-même. Allez à l’application Synchroniser les modèles situé dans le menu supérieur du formulaire du modèle.
et sélectionnez le modèle à synchroniser. Ensuite, cliquez sur le boutonCréer des modèles dans Meta¶
Allez d’abord au tableau de bord des modèles WhatsApp de Meta, et allez ensuite aux .
Pour créer un modèle WhatsApp, cliquez sur le bouton bleu Créer un modèle et sélectionnez la Catégorie. Les options sont les suivantes : Marketing, Utilité, et Authentification. Dans la plupart des cas, les deux premières options seront utilisées, à moins que l’utilisateur ne veuille envoyer une réinitialisation du mot de passe ou quelque chose liée à la sécurité.
Saisissez le Nom du modèle et sélectionnez la Langue du modèle.
Note
Vous pouvez sélectionner plusieurs langues en saisissez le ou les noms de la langue et en sélectionnant les autres langues si nécessaire.
Après avoir effectué les sélections appropriées, cliquez sur Continuer dans le coin supérieur droit. La page redirige vers la page Modifier le modèle. L”En-tête, le Corps, le Pied d page et les Boutons y sont configurés. À droite du modèle se trouve un aperçu de la présentation du modèle en production.
Lorsque toutes les modifications nécessaires ont été apportées au modèle, cliquez sur le bouton Soumettre dans le coin supérieur droit. Une fenêtre de confirmation apparaît pour confirmer la langue— cliquez sur Confirmer pour approuver, puis une autre fenêtre apparaît indiquant que le modèle sera soumis à Meta pour examen et approbation.
Le Statut du modèle restera En cours d’examen jusqu’à ce que Meta ait pris une décision. Une fois qu’un email de confirmation a été reçu pour approuver le modèle, les modèles doivent être synchronisés à partir de la base de données Odoo.
Pour plus d'infos
Pour plus d’informations sur la configuration des modèles dans la console développeur Meta, consultez la documentation de Meta sur les modèles WhatsApp.
Notifications¶
Les notifications dans WhatsApp sont gérées de la même manière qu’un message dans Odoo. Une fenêtre contextuelle apparaît avec la conversation reçue par le client. Par défaut, les notifications sont définies dans la configuration du compte business WhatsApp dans Odoo.
Les paramètres de notification peuvent être modifiés en allant à l’application Notifier les utilisateurs, tapez dans le champ le ou les utilisateurs qui doivent être notifiés pour ce canal WhatsApp en particulier.
. De là, sélectionnez le compte et faites défiler jusqu’à la section où les notifications sont gérées. Dans l’en-têteNote
Lorsqu’une conversation est entamée entre un utilisateur et un client, aucune notification ne sera envoyée à tous les utilisateurs précisés dans la configuration du compte business WhatsApp. Des notifications seront uniquement envoyées à l’utilisateur ou aux utilisateurs participant à la conversation. Si l’utilisateur ne répond pas dans les 15 jours, la réponse du client après ce délai sera à nouveau envoyée à tous les utilisateurs précisés dans la configuration de WhatsApp.
Ajouter des utilisateurs à la conversation¶
Des utilisateurs peuvent être ajoutés à une conversation WhatsApp en élargissant la fenêtre contextuelle WhatsApp. Les conversations WhatsApp se trouvent dans l’application Discussion. Cliquez sur l’icône 👤+ (ajouter un utilisateur) à côté et une fenêtre s’ouvre en invitant les utilisateurs à la conversation.
FAQ API WhatsApp¶
Vérification¶
À partir du 1 février 2023, si l’application Meta nécessite un accès avancé aux autorisations, une vérification complète de l’entreprise pourra être nécessaire. Cela inclut la soumission de documents commerciaux à Meta. Consultez cette documentation.
Pour plus d'infos
Documentation de Meta sur la vérification de l’accès à WhatsApp.
Erreurs de modèle¶
La modification des modèles peut entraîner des tracebacks et des erreurs, à moins que la procédure exacte ne soit suivie ci-dessus, ici : (Modèles WhatsApp).
Erreur de validation des doublons¶
Lors de la synchronisation des modèles, il se peut qu’il y ait plusieurs modèles ayant le même nom dans le business manager de Meta et dans Odoo. Cela provoque une erreur de validation des doublons. Pour remédier à ce problème, renommez le nom du modèle en double dans Odoo et synchronisez à nouveau les modèles en suivant les étapes suivantes : Synchroniser des modèles.
Erreurs de jeton¶
Erreur d’utilisateur¶
Si le jeton temporaire n’est pas remplacé par un jeton permanent, une erreur d’utilisateur sera générée dans Odoo lors du test de la connexion après l’échec de l’envoi. Pour corriger ce problème, consultez Jeton permanent.
Erreur utilisateur système 100¶
Si l’utilisateur système est un Employé lors de la configuration du jeton permanent, une erreur utilisateur 100 s’affichera.
Pour corriger cette erreur, créez un utilisateur système Admin en suivant la procédure suivante : Jeton permanent.