WhatsApp

Rendre votre bot disponible sur WhatsApp​

Prérequis​

Pour rendre votre bot Dydu disponible sur WhatsApp, vous aurez besoin :

• d'une application Meta créée à partir de l'interface Meta for developers,

• de l'application WhatsApp installée sur votre téléphone ou votre ordinateur,

• d'un numéro de téléphone pour tester le bot.

Étape 1 : ajouter les produits nécessaires pour WhatsApp​

Pour que votre application fonctionne sur WhatsApp, vous devez ajouter et configurer les produits suivants :

• Facebook login for business,

• WhatsApp.

Pour faire ceci :

1. Cliquez sur « Ajouter un produit ».

1. Recherchez le produit « Facebook login for Business » et cliquez sur « Configurer ».

2. La page de « Paramètres » du produit « Facebook login for business » s’ouvrira et une nouvelle section « Facebook login for business» s’affichera dans le menu de gauche.

3. Retournez à la page des produits en cliquant sur « Ajouter un produit ».

4. Recherchez « WhatsApp » et cliquez sur « Configurer ».

1. La page « Paramètres » du produit « WhatsApp » s’ouvrira et une nouvelle section « WhatsApp » s’affichera dans le menu de gauche.

Vos produits ont été ajoutés avec succès ! Nous allons procéder à leur configuration. Commençons par la configuration du produit « Facebook login for business ».

Configurer le produit Facebook login​

1. Cliquez sur Facebook Login for Business > Paramètres.

1. Activez l’option « Se connecter avec le SDK JavaScript ». Cette option vous permettra de vous connecter à votre compte Facebook à partir de votre intégration sur le menu Canaux de dydu.

2. Remplissez le champ « Domaines autorisés pour le SDK Javascript » : remplissez le champ avec l'URL principale de votre menu « Canaux ».

Par exemple, si vous vous connectez au menu Channels de la dydu BMS et que l'URL complète est : https://sso.channels.dydu.ai/?ticket=ST-1475-7riKAzdDpiYrbRGbmhLImJ-cDd8-cas-prod-sso#/configurations, entrez seulement https://sso.channels.dydu.ai/ pour le champ Domaines autorisés pour le SDK Javascript.

1. Cliquez sur le bouton « Enregistrer les modifications ».

Configurer le produit WhatsApp​

1. Cliquez sur WhatsApp > Démarrer.

Avant d'ajouter le numéro de téléphone final du bot et de lui demander un token d'accès permanent pour ce dernier, commençons par valider la configuration avec un numéro de test fourni par META et un token d'accès temporaire.

Pour faire ceci :

1. Dans la section « Envoyer et recevoir des messages », cliquez sur la liste déroulante « À ».

2. Cliquez sur "Gérer la liste des numéros de téléphone".

3. Une modale s'ouvre. Cliquez sur "Ajouter un numéro de téléphone"

4. Remplissez le numéro à ajouter (faites attention au préfixe)

5. Cliquez sur "Suivant"

6. Le numéro ajouté recevra un code. Il sera nécessaire de copier ce code et ainsi valider l'ajout du numéro.

Maintenant, passons à l'étape suivante : créer et configurer une intégration Meta à partir du menu "Canaux" du BMS Dydu.

Étape 2 : Créer et configurer une intégration Meta à partir du menu « Canaux » du BMS dydu​

Pour créer une intégration Meta dans le BMS Dydu, suivez ces étapes :

• Obtenez l'identifiant de votre application Meta et sa clé correspondante.

• Obtenir l'identifiant du numéro de téléphone du bot et son token d'accès.

Ces informations sont spécifiques à votre application Meta et sont disponibles sur votre portail Meta for Developers.

Où trouver l'identifiant de votre application META et la clé correspondante :​

1. Dans le portail Meta for developers, sur votre application, cliquez sur Paramètres > Général dans le menu de gauche.

2. Copiez et conservez l’identifiant de votre application.

3. Cliquez sur le bouton « Afficher » pour afficher la clé de votre application. Vous serez invité à entrer votre mot de passe pour afficher la clé.

4. Copiez et conservez la clé de votre application.

Où trouver l'identifiant du numéro de téléphone du bot et le token d’accès temporaire :​

1. Dans le portail Meta for developers, sur votre application, cliquez sur WhatsApp > Démarrer dans le menu de gauche.

2. Sur la page principale, recherchez le « Token d'accès temporaire ».

3. Copiez et conservez ce token.

1. Toujours sur la page principale, recherchez « Envoyer et recevoir des messages », sous votre numéro de téléphone vous trouverez « l’ID du numéro de téléphone », copiez et conservez cette valeur.

Avec ces informations, connectez-vous à votre BMS dydu et ouvrez le menu Canaux de votre bot. Si vous disposez déjà d’une intégration de type Meta, aller directement à l'étape 9.

1. Cliquez sur « Créer » pour créer une nouvelle intégration.

2. Sélectionnez la plateforme Meta.

3. Donnez un nom à cette intégration et cliquez sur "Créer".

1. Vous arrivez sur la page “Information” vous permettant de choisir la langue et l'espace qui seront interrogés pour votre bot sur WhatsApp.

2. Cliquez sur le bouton « Suivant »

3. Une modale s'ouvre : entrez l'identifiant de votre application ainsi que la clé secrète de l'application Meta.

Ces informations ont été précédemment récupérées à partir de votre portail Meta for Developers.

Si vous avez ignoré cette étape et ne savez pas comment récupérer l'identifiant de l'application et la clé secrète, on vous l'explique ici !

1. Une fois les informations fournies, cliquez sur « Enregistrer ».

2. Vous arrivez sur la page « Connexion », seconde et dernière étape de la configuration de votre intégration Meta.

3. Sur la gauche, vous trouverez les connexions disponibles. Cliquez sur Créer à côté de WhatsApp, pour connecter votre bot dydu à votre compte WhatsApp.

1. Un nouvel onglet va s’ouvrir vous demandant de continuer en tant que “votre compte”. Cliquez sur Continuez en tant que [votre compte].

2. Sélectionnez le compte WhatsApp auquel vous voulez connecter votre bot : c'est le compte WhatsApp à partir duquel votre bot sera joignable !

1. Vérifiez pour quels éléments vous demander une autorisation d’accès et cliquez sur “Enregistrer”.

2. Un message confirmant l'association de votre compte WhatsApp à votre intégration Meta s'affiche : cliquez sur le bouton « Je comprends ».

3. Vous êtes ensuite redirigé vers la configuration de votre intégration à partir du menu Canaux. Une modale « WhatsApp » est ouverte.

1. Remplissez l'identifiant du numéro de téléphone et du token.

2. Ces informations ont été précédemment récupérées à partir de votre portail Meta for Developers. Si vous avez ignoré cette étape et ne savez pas comment récupérer l'identifiant de la page et le token d'accès, on vous l'explique ici !

3. Cliquez sur "Mettre à jour".

4. Votre connexion WhatsApp est désormais en place !

5. Cliquez sur « Terminer ».

Votre bot est désormais disponible sur WhatsApp mais n’est accessible que pour les numéros de téléphone que vous aurez ajoutés lors de la configuration du produit WhatsApp depuis votre portail Meta for developers. En outre, le jeton généré n'est valide que pendant 24 heures après sa création (il peut être mis à jour autant de fois que nécessaire).

Pour le rendre disponible à tous les utilisateurs de WhatsApp et sans condition de délai, vous devez :

• ajouter votre propre numéro de téléphone WhatsApp,

• générer un token permanent.

Étape 3 : utiliser votre propre numéro de téléphone et générer un token permanent

Pour ajouter votre numéro de téléphone, allez sur WhatsApp > Commencez et recherchez « Ajouter un numéro de téléphone ».

Les conversations initiées par l’entreprise étant payante vous serez amené à renseigner un moyen de paiement.

Meta met à disposition ces conditions tarifaires sur son site. Pour en savoir plus, nous vous invitons à consulter la page dédiée sur le site Web de Meta.​

1. Allez sur votre portail Meta for developers.

2. Cliquez sur Contrôle app > Autorisations et Fonctionnalités dans le menu de gauche.

Pour créer un token permanent, Meta fournit une documentation en ligne pour détailler les étapes à effectuer afin de créer un token permanent. Vous trouverez cette documentation ici.

Une fois ces autorisations accordées, vous pouvez passer votre application en mode "Live".