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 :
Quotations from the Sales app
Receipts and invoices from the Point of Sale app
Tickets from the Events app
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.
The WhatsApp connector supports two flows: company initiated, and customer initiated. A company can initiate a discussion by sending a template to one or more people. Once the template is sent, the recipient can answer in order to trigger a discussion between the sender and the receiver (a Discuss chat window appears if the customer answers within 15 days).
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.
Pour plus d'infos
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 e-mail professionnelle. Cliquez ensuite sur Suivant et une fenêtre contextuelle s’ouvre et vous invite à confirmer l’adresse e-mail. Après confirmation, cliquez sur Fait pour fermer la fenêtre.
Suivez ensuite les instructions dans l’e-mail 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.
To toggle to the business account navigate to the Facebook Developer Console and click on the account name in the upper right corner. Under the Business Accounts heading, click on the desired business that the WhatsApp configuration should take place in. This is the account for which Odoo will send and receive WhatsApp messages.
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
Click on My Apps in the top-right corner after successfully signing in to the Meta developer account. This will redirect the administrator to all the apps the developer has configured in this specific developer account. Click on Create App to begin the process of configuring a new Meta application.
Type d’application¶
Sur la page , sélectionnez 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.
Cliquez 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 e-mail du développeur dans le champ situé sous le libellé App contact e-mail.
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
If the Meta business account is prohibited from advertising, claiming an app is not allowed. To resolve this issue navigate to https://business.facebook.com/business for assistance.
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.
On the next page: since WhatsApp is used, click Set up next to the box containing WhatsApp, located towards the bottom of the 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
If the browser is not on the Quickstart page for WhatsApp, navigate to
https://developers.facebook.com/apps and click on the app that is being configured, (the
app name is Odoo if the instructions above were followed).
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 . Cliquez ensuite sur Nouveau pour configurer le compte WhatsApp business dans Odoo.
Dans 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.
On the page, click on Edit, where both the Callback URL and Webhook Verify Token values from Odoo are added.
Note
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 et sélectionnez le compte à configurer. Localisez les valeurs sous la section intitulée Recevoir des messages.
Copiez 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¶
Now input individual webhook fields into Meta’s developer console, under the Webhook fields section. Click Manage and when the pop-up window appears, check the boxes in the Subscribe column for the following field names:
account_updatemessage_template_quality_updatemessage_template_status_updatemessagestemplate_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
If a payment method has not been added, this is necessary to proceed. Visit Meta’s documentation on how to add a payment method in Meta’s Business Manager. This is part of Meta’s fraud detection system, in order to ensure that the account/company are real a payment method is required to proceed.
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é.
Avertissement
This is a mandatory step. If the permanent token is not added, the Odoo database shows a token error.
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.
Next, the permanent token gets generated. Click on Generate new token, and a pop-up window will appear asking which app this token should be generated for. Select the App that this token is for. Then determine the expiration date of either 60 days or Never.
Enfin, lorsque Meta demande quelles sont les autorisations que l’utilisateur système doit autoriser, ajoutez toutes les autorisations suivantes :
business_managementwhatsapp_business_messagingwhatsapp_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 e-mail 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 et cliquez sur Nouveau. Sur le formulaire, donnez un Nom au modèle et sélectionnez une Langue.
Important
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
These models can also be accessed in developer mode. On a contact form (or similar relevant form in Odoo), navigate to the model that is referenced, and hover over any field name. A box of backend information will reveal itself with the specific Odoo Model name in the backend. Search (using the front-end name) for this model in the Applies to drop-down menu in the WhatsApp template.
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.
To search available fields, type in the front-end name in the search box. This finds a result from all of the available fields for the model (Applies to) that the template is created for.
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.
Change the Category to fit either a Marketing, Utility, or Authentication category. In most instances the first two options are used, unless the user would like to send a password reset or something security related. Set to Marketing should there be anything promotional being sent and set to Utility should there be general transactional messages being sent (i.e., sales order, event ticket, 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 e-mail 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
Consider the preconfigured demo data templates available in Odoo to use or modify. These templates can be used as-is or modified to suit a specific business need.
To use these templates, navigate to and select a preconfigured template. Click Submit for Approval to start the approval process. An email gets sent to the administrator of the Meta account when the template has been approved.
Utiliser 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’e-mail à 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 e-mail 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 et sélectionnez la configuration qui doit être synchronisée. Dans la section intitulée , vers le bas, cliquez sur 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.
Un 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 et sélectionnez le modèle à synchroniser. Ensuite, cliquez sur le bouton Synchroniser les modèles situé dans le menu supérieur du formulaire du modèle.
Créer des modèles dans Meta¶
Allez d’abord au tableau de bord des modèles WhatsApp de Meta, et allez ensuite aux .
To create a WhatsApp template, click on the blue Create template button, and then select the Category. The options listed include: Marketing, Utility, and Authentication. In most instances the first two options are used, unless the user would like to send a password reset or something security related.
Saisissez le Nom du modèle et sélectionnez la Langue du modèle.
Note
Multiple languages can be selected by typing the language names and selecting the other languages as needed.
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.
When all the necessary changes are made to the template, click on the Submit button in the upper-right corner. A confirmation window appears to confirm the language— click Confirm to approve and then another window appears stating that the template gets submitted to Meta for review and approval.
Le Statut du modèle restera En cours d’examen jusqu’à ce que Meta ait pris une décision. Une fois qu’un e-mail 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.
Notification settings can be adjusted by navigating to . From there, select the account and scroll down to the section where notifications are handled. Under the Notify users heading, type in the field which users should be notified for this particular WhatsApp channel.
Note
Once a conversation is initiated between a user and a customer, notifications to all the users specified in the WhatsApp business account configuration will not occur. Only notifications to the users in the conversation will occur. Should the user not respond within 15 days, the customer’s reply after the 15 days will populate once again to all the users specified in the WhatsApp configuration.
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.
