# WhatsApp

## Étape 1 : Ajouter les produits nécessaires pour WhatsApp <a href="#etape-1-ajouter-les-produits-necessaires-pour-whatsapp" id="etape-1-ajouter-les-produits-necessaires-pour-whatsapp"></a>

Afin que votre application fonctionne sur WhatsApp, il est nécessaire d’ajouter et de configurer les produits suivants :

* **Facebook Login for Business**
* **WhatsApp**

#### **Procédure :**

1. Cliquez sur **« Ajouter un produit »** dans l’interface Meta For Developers.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FYql7ncmg1cA0eptl46ar%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-01%2014-16-57.png?alt=media&#x26;token=818b9cb0-518f-4da9-b11d-2515b1756256" alt="" width="212"><figcaption></figcaption></figure>

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

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FBUvFXtWD7kSWfflGpaAE%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-01%2014-17-46.png?alt=media&#x26;token=e2d7e853-8a29-44e1-97da-e43ee9e9aed4" alt="" width="251"><figcaption></figcaption></figure>

3. La page de « **Paramètres** » du produit « **Facebook login for business** » s’ouvrira et une nouvelle section « **Facebook login for business** » apparaîtra dans le menu de gauche.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2Fmrw1T3U9xXHJwcBlYNeT%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-01%2014-18-23.png?alt=media&#x26;token=608e1d5a-c8f2-4185-a06a-6c5b174419c8" alt=""><figcaption></figcaption></figure>

4. Retournez à la page des produits en cliquant sur « **Ajouter un produit** ».
5. Recherchez « **WhatsApp** » et cliquez sur « **Configurer** ».

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FoPAiuHjQObE9Cn7sQLBF%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-01%2014-19-14.png?alt=media&#x26;token=e4614b53-ec02-4032-9d31-3881ecb33978" alt=""><figcaption></figcaption></figure>

6. La page « **Paramètres** » du produit « **WhatsApp** » s’ouvrira et une nouvelle section « **WhatsApp** » apparaîtra dans le menu de gauche.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FxApqMAV67jRwQgIqvend%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-01%2014-19-55.png?alt=media&#x26;token=e6076458-d2e4-4221-878e-728fafbd7e4a" alt=""><figcaption></figcaption></figure>

Vos produits ont été ajoutés avec succès ! Nous allons procéder à leur configuration.

### **Configurer le produit Facebook login​**

#### **Procédure**

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

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FWsFB1HoTOnGLnmTBidE5%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-01%2014-40-00.png?alt=media&#x26;token=91428bf8-c11c-4aa0-952f-8b8160d494ab" alt="" width="221"><figcaption></figcaption></figure>

2. Activez l’option **« Se connecter avec le SDK JavaScript »**.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FO5HC7IDQyiBVa1PlhLbO%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-07%2017-24-02.png?alt=media&#x26;token=2ea19aaa-4928-48f1-90e1-34d03223eb22" alt="" width="563"><figcaption></figcaption></figure>

3. Remplissez le champ **« Domaines autorisés pour le SDK JavaScript »** avec l’URL principale de votre menu **Canaux**.
   * Si vous êtes sur le serveur `app1.sandbox` : [https://experimental.channels.dydu.ai](https://experimental.channels.dydu.ai/)​
   * Si vous êtes sur un serveur `app1` (en dehors du serveur app1.sandbox) l'url à renseigner est : [https://channels.dydu.ai](https://channels.dydu.ai/)
   * Si vous êtes sur un serveur `uat` l'url à renseigner est : [https://staging-sso.channels.dydu.ai](https://staging-sso.channels.dydu.ai/)
4. Cliquez sur le bouton « **Enregistrer les modifications** ».

### Configurer le produit WhatsApp

Avant d’ajouter le numéro de téléphone final du bot et de générer un token d’accès permanent, commencez par valider la configuration avec un **numéro de test fourni par Meta** et un **token d’accès temporaire**.&#x20;

Pour faire ceci :&#x20;

1. Cliquez sur **WhatsApp > Configuration de l'API**.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FYK2c5kv4PbJNqYVRqqmo%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-07%2016-48-23.png?alt=media&#x26;token=589aa47d-5b55-4ca4-9399-4162b8ccfb45" alt="" width="226"><figcaption></figcaption></figure>

2. Pour **ajouter un numéro de test** aller à l'**étape 1** "**Sélectionner des numéros de téléphone**"&#x20;

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FhYQsjbyffVooze3h5gxv%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-08%2011-28-30.png?alt=media&#x26;token=f9377b0c-e3f6-4e88-bb16-a9be820cadd7" alt="" width="563"><figcaption></figcaption></figure>

3. Cliquer sur sur le menu déroulant "**De**"

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FsEBJtZfSOlalZx7vpEtu%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-08%2011-31-05.png?alt=media&#x26;token=80171940-667a-4988-82f2-db810e31369d" alt=""><figcaption></figcaption></figure>

4. Choississez le **numéro de test** fourni par Meta "**Test Number**"
5. Cliquer sur le menu déroulant "**À**"

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F18uyW0VlmNzVmgcjsobK%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-08%2011-33-24.png?alt=media&#x26;token=e1cc6377-ad28-4e9b-9d4d-dd7515d41bdb" alt=""><figcaption></figcaption></figure>

6. Choisissez un **numéro de téléphone** dans la liste déroulante, si il n'y a pas de numéro, vous pouvez en ajouter un en appuyant sur "**Gérer la liste des numéros de téléphone**"

## Étape 2 : Créer et configurer une intégration Meta <a href="#etape-2-creer-et-configurer-une-integration-meta-a-partir-du-menu-canaux-du-bms-dydu-1" id="etape-2-creer-et-configurer-une-integration-meta-a-partir-du-menu-canaux-du-bms-dydu-1"></a>

**Si vous disposez déjà d'une intégration Meta, vous pouvez l'ouvrir sur la page "Connexion" et aller directement au point 15 de cette documentation.**

1. Connectez-vous à votre BMS Dydu et ouvrez le menu « Canaux » de votre bot.
2. Sélectionnez "**Meta**".

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FM21qQzYDiOiQTHnB6Aca%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-11-24%2014-00-54.png?alt=media&#x26;token=92af4b4f-0ca2-41c5-9b5e-83a73100531f" alt="" width="563"><figcaption></figcaption></figure>

3. Donnez un **nom** à cette intégration et cliquez sur "**Créer**".
4. Vous arrivez sur la page “**Information**” vous permettant de choisir la **langue** et l'**espace** qui seront interrogés pour votre bot sur **WhatsApp**.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FCajGSjkqxAbmjadhJpAD%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-12-16%2010-46-06.png?alt=media&#x26;token=0e89f74e-9697-47f9-9bad-eaccf4536cc1" alt="" width="563"><figcaption></figcaption></figure>

5. Cliquez sur le bouton "**Suivant"**
6. Une modale s'ouvre et vous demande l'**ID** ainsi que la **clé secrète** de l'application Meta.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F7JsduCIifTbTFQhVDTgn%2FCapture%20d%E2%80%99e%CC%81cran%202024-01-02%20a%CC%80%2017.26.50.png?alt=media&#x26;token=79080e26-f7fa-4e97-96ae-02c7261c8cc2" alt=""><figcaption></figcaption></figure>

7. Pour récupérer ces informations : allez sur votre application dans le portail **Meta for developers**
8. Cliquez sur **Paramètres > Général** dans le menu de gauche.
9. Copiez et conservez l’**identifiant de votre application**.
10. Cliquez sur le bouton  "**Afficher"** pour afficher la **clé de votre application**. Vous serez invité à entrer votre **mot de passe** pour afficher la clé.
11. Copiez et conservez la **clé de votre application**.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FSqfSO2OiiGXt4Z9tOu9n%2FUntitled%203.png?alt=media&#x26;token=5e4c6c63-71e0-483e-8b13-5e489229eb27" alt=""><figcaption></figcaption></figure>

12. Retournez sur le BMS  et renseignez l'identifiant de votre application ainsi que la clé secrète de l'application Meta.
13. Une fois les informations fournies, cliquez sur « Enregistrer ».
14. Vous arrivez sur la page "**Connexion**". Sur la gauche, vous trouverez les **connexions disponibles**.&#x20;
15. Cliquez sur **Créer** à côté de **WhatsApp**, pour connecter votre bot dydu à votre compte WhatsApp.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F4BU7mGJQQ1f0S9femPoD%2F5.png?alt=media&#x26;token=b1c43d5a-4618-4ec7-a059-62c1ab6e5d29" alt="" width="332"><figcaption></figcaption></figure>

16. Un **nouvel onglet** va s’ouvrir vous demandant de vous **connecter**.
17. **Connectez-vous** et valider.
18. Vous êtes ensuite redirigé vers votre intégration Meta sur le **BMS Dydu.** Une modale "**WhatsApp"** est ouverte.&#x20;

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FtwwwexEJuYoOUT4HE7GZ%2F6.png?alt=media&#x26;token=0a4af339-b2f5-41d2-a8fb-dd7efb6c222a" alt="" width="375"><figcaption></figcaption></figure>

19. Pour obtenir les informations demandées dans cette modale (identifiant du numéro de téléphoen et Jeton d'accès) : retournez sur votre application sur le portail Meta For Developers
20. Cliquez sur **WhatsApp > Configuration de l'API** dans le menu de gauche.
21. Rechercher "**Token d'accès**".
22. Copiez et conservez ce token.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FwPNTdWsKSiR8r2kqMVD7%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-10-07%2016-50-50.png?alt=media&#x26;token=dab6439d-aa9c-4e61-a14e-37289ea02598" alt=""><figcaption></figcaption></figure>

23. Aller à l'étape 1 "**Envoyer et recevoir des messages"**
24. Sous votre numéro de téléphone vous trouverez "**ID du numéro de téléphone**", copiez et conservez cette valeur.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FpttFlo5ortN9SQCDxv2M%2FCapture%20d%E2%80%99e%CC%81cran%202024-01-02%20a%CC%80%2017.25.24.png?alt=media&#x26;token=3d95be58-4a9f-43aa-8932-36b2e1651a84" alt=""><figcaption></figcaption></figure>

25. Retournez sur le BMS  Dydu et renseignez l'identifiant du numéro de téléphone et du token.
26. Cliquez sur "**Mettre à jour**".
27. Votre connexion WhatsApp est désormais en place !
28. 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 WhatsApp avec sa propre configuration <a href="#etape-3-demander-un-acces-avance-pour-les-autorisations-et-fonctionnalites-necessaires" id="etape-3-demander-un-acces-avance-pour-les-autorisations-et-fonctionnalites-necessaires"></a>

### Ajouter son propre numéro de téléphone

1. Allez sur l'interface **Meta for developpers**
2. Pour ajouter votre numéro de téléphone, allez sur **WhatsApp > Configuration de l'API**
3. Aller à l'étape 5 " **Ajouter un numéro de téléphone**" et suivre ce qui est écrit

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2Fa5UOpTRnB9fbhim7q44n%2FCapture%20d%E2%80%99e%CC%81cran%202024-01-02%20a%CC%80%2017.30.51.png?alt=media&#x26;token=8480c387-f409-490a-a6eb-c14df484fd64" alt=""><figcaption></figcaption></figure>

4. Aller à l'étape 6 "**Ajouter un moyen de paiement**" et suivre le procédure

{% hint style="info" %}
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](https://developers.facebook.com/docs/whatsapp/pricing?locale=fr_FR) sur le site Web de Meta.
{% endhint %}

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FzD0NM87gk9dJReBw7ntY%2FCapture%20d%E2%80%99e%CC%81cran%202024-01-02%20a%CC%80%2017.31.27.png?alt=media&#x26;token=d933e9c3-887a-4839-b768-42c9309a23d1" alt=""><figcaption></figcaption></figure>

### Générer un token permanent

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

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FGX1UCu1bVtTJ20H6oqmh%2FCapture%20d%E2%80%99e%CC%81cran%202024-01-02%20a%CC%80%2017.32.06.png?alt=media&#x26;token=8c9e8eb2-8c7a-4903-996b-00307829eaed" alt="" width="218"><figcaption></figcaption></figure>

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](https://developers.facebook.com/docs/whatsapp/business-management-api/get-started#1--acquire-an-access-token-using-a-system-user-or-facebook-login).

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