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

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 :

  1. Créer un compte Meta business

  2. Créer un compte développeur sur Meta

  3. Configurer une app et un produit WhatsApp sur la console développeur de Meta

  4. 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.

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.

Basculez entre les comptes personnel et business de Meta.

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.

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 Créer une app, 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 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.

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.

Allez à l'assistant de démarrage rapide WhatsApp dans le tableau de bord Meta for Developer.

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 WhatsApp ‣ Configuration ‣ Comptes WhatsApp Business. Cliquez ensuite sur Nouveau pour configurer le compte WhatsApp business dans Odoo.

Dans un autre onglet du navigateur, allez à https://developers.facebook.com ‣ Mes apps ‣ WhatsApp ‣ Configuration de l’API, 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.

Allez manuellement à la configuration des webhooks WhatsApp.

Sur la page Configuration Webhook, cliquez sur Modifier, où les valeurs URL de rappel et Jeton de vérification du Webhook d’Odoo seront ajoutées.

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 WhatsApp ‣ Configuration ‣ Comptes WhatsApp Business 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

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 :

Webhooks WhatsApp définis 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.

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.

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.

Jeton permanent

Une fois la configuration et les tests terminés, un jeton permanent doit être créé pour remplacer le Jeton temporaire.

Commencez par aller à https://business.facebook.com/ et allez à Paramètres de l’entreprise ‣ Utilisateur ‣ Utilisateurs système. 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 WhatsApp ‣ Configuration ‣ Comptes WhatsApp Business.

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 Paramètres de l’application ‣ Basique. 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 WhatsApp ‣ tableau de bord des modèles.

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 WhatsApp ‣ Talbeau de bord des modèles 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

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.

Recherchez le champ téléphone dans la barre de recherche.

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 WhatsApp ‣ Modèles et sélectionnez un modèle préconfiguré. 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é.

Boutons

Vous pouvez ajouter des boutons dans l’onglet Boutons. Saisissez le Type (Visite site web, Numéro d’appel ou Réponse rapide), et précisez ensuite le Texte du bouton, le Numéro d’appel ou l”URL du site web (y compris le Type d’URL), en fonction du Type de bouton.

Note

Vous pouvez également ajouter des boutons sur la console Meta Business. Allez au tableau de bord des modèles WhatsApp de Meta via https://business.facebook.com/wa/manage/home. Allez ensuite à Outils du compte ‣ Modèles de messages.

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’email à partir du champ Client sur le modèle Commande.

Message WhatsApp avec les variables dynamiques mises en évidence.

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}},

Voici votre facture {{2}} de {{3}} pour un total de {{4}}{{5}}.
Pour consulter votre facture ou payer en ligne : {{6}}

Merci

Pour plus d'infos

Modèles WhatsApp.

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

Partenaire

corps - {{2}}

INV/2022/00001

Champ du modèle

Chiffre

corps - {{3}}

Ma société

Champ du modèle

Société

corps - {{4}}

$

Champ du modèle

Devise > Symbôle

corps - {{5}}

4000

Champ du modèle

Montant

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 Outils du compte ‣ Modèles de messages.

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 WhatsApp ‣ Configuration ‣ Comptes WhatsApp Business et sélectionnez la configuration qui doit être synchronisée. Dans la section intitulée Envoyer des messages, 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.

Synchronisez les modèles WhatsApp de Meta vers la base de données Odoo avec l'option 'Synchroniser les modèles' mise en évidence.

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 WhatsApp ‣ Tableau de bord des modèles 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 Outils du compte ‣ Modèles de messages.

Les outils du compte mis en évidence dans le business manager avec le lien vers les modèles de messages mis en évidence.

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.

Les options de configuration des modèles répertoriées, avec Marketing, Utilité, Nom et Langue mis en évidence.

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.

Modifiez le modèle en utilisant un en-tête, un corps, un pied de page et des boutons.

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 WhatsApp ‣ Configuration ‣ Comptes WhatsApp Business. De là, sélectionnez le compte et faites défiler jusqu’à la section Contrôle où les notifications sont gérées. Dans l’en-tête Notifier les utilisateurs, tapez dans le champ le ou les utilisateurs qui doivent être notifiés pour ce canal WhatsApp en particulier.

Note

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.

Ajouter des utilisateurs à une conversation WhatsApp, avec l'icône Ajouter un utilisateur mise en évidence.

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.

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.

Erreur d'utilisateur générée dans Odoo lorsqu'un modèle existe en double.

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 d'utilisateur générée dans Odoo lorsque le jeton expire.

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.

Erreur utilisateur générée dans Odoo lorsqu'un jeton employé est généré au lieu d'un utilisateur Admin.