Connectez votre numéro WhatsApp Business à Chatwoot en utilisant l’API Cloud WhatsApp de Meta. Ce guide vous explique comment préparer votre compte Meta, générer le jeton d’accès requis et créer votre boîte de réception WhatsApp dans Chatwoot.

## Récupérer vos informations API Cloud WhatsApp depuis Meta

[**WhatsApp Cloud API**](https://developers.facebook.com/docs/whatsapp/cloud-api/) est hébergée par Meta et disponible pour les entreprises et les développeurs individuels. Elle vous permet de vous connecter directement à la plateforme WhatsApp Business sans avoir recours à un fournisseur tiers pour héberger l’API.

Pour créer une boîte de réception WhatsApp, vous avez besoin de trois informations fournies par Meta :

* **ID du compte WhatsApp Business**

* **ID du numéro de téléphone**

* **Jeton d’accès permanent ou jeton d’utilisateur système**

Vous pouvez obtenir l’ID du compte WhatsApp Business et l’ID du numéro de téléphone à partir de votre application Meta.

### Créer ou sélectionner une application Meta

Rendez-vous sur [Meta for Developers](https://developers.facebook.com/apps/) et sélectionnez une application existante ou cliquez sur **Créer une application**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTC82QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6a6fe8ce45d12415ebb566feea542d9fb9a12dab/choose-or-create-app.png)

\
Si vous créez une nouvelle application, saisissez un nom d’application et un e-mail de contact, puis cliquez sur **Suivant**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTVA2QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--33e2461575baafbeb61276d9d04038cd74b21d77/create-app.png)

### Choisissez le cas d’utilisation WhatsApp

Sur l’écran de sélection, choisissez **Se connecter avec les clients via WhatsApp**, puis cliquez sur **Suivant**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTVg2QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a848601497d112b8b083ae215371fd899a1d44ca/choose-whatsapp-use-case.png)

### Choisissez un portefeuille d’entreprise

Sélectionnez le portefeuille d’entreprise qui possède ou détiendra votre compte WhatsApp Business.

Si vous n’avez pas encore de portefeuille d’entreprise, vous pouvez en créer un à cette étape ou continuer et le créer plus tard si Meta le permet.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTUw2QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--de094508d48317f09e729bf42b79bd56b45bfccd/choose-portfolio.png)

### Vérifiez les exigences de publication

Meta peut afficher les exigences de publication pour l’application et le cas d’utilisation sélectionnés. Passez-les en revue et cliquez sur **Suivant**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTUQ2QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--68fa524755a64868fbf4319c556b94333743b176/publishing-requirments.png)

### Vérifiez et créez l’application

Vérifiez les détails de l’application, le cas d’utilisation WhatsApp sélectionné et le portefeuille d’entreprise rattaché. Cliquez sur **Créer l’application** pour terminer.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTUg2QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--bfa973f995b90571b4cf270c73539d4486da0946/review.png)

### Accéder à la configuration de l’API WhatsApp

Après avoir créé ou sélectionné l’application :

1. Cliquez sur **Cas d’utilisation** dans la barre latérale.

2. Trouvez **Se connecter avec les clients via WhatsApp**.

3. Cliquez sur **Personnaliser**.

4. Cliquez sur API Setup.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ0Q4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--831f01b017a734b2c860493106bd0bd99c590aec/use-case.png)

Dans la nouvelle interface de l’application Meta, allez à **Configuration de base → Étape 2. Configuration de production** et ouvrez **Enregistrez votre numéro WhatsApp**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQno4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--508f796638b1758872170a557647e9ad03d58b0e/new-ui-add-or-use-number.png)

Pour les anciennes applications Meta, ouvrez **WhatsApp → API setup** depuis la barre latérale gauche.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQmo4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f085505319b75ba0e84a65dcf7bc41f1d0c0f108/old-ui-api.png)

### Ajouter ou sélectionner votre numéro WhatsApp

> Si ce numéro est actuellement actif dans l’application WhatsApp Business, ne le supprimez pas ou ne l’enregistrez pas manuellement via ce processus. Utilisez le flux Embedded Signup/Coexistence de Chatwoot, ou contactez le support Chatwoot.

Dans la section **Envoyer et recevoir des messages** ou **Enregistrez votre numéro WhatsApp**, choisissez un numéro existant via le sélecteur **De**, ou cliquez sur **Ajouter un numéro de téléphone**.

\
Si vous ajoutez un nouveau numéro :

1. Renseignez le nom d’affichage WhatsApp Business et les détails de votre entreprise.

2. Saisissez le numéro de téléphone.

3. Choisissez la vérification par SMS ou appel téléphonique.

4. Entrez le code OTP reçu de Meta pour vérifier le numéro.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQlQ4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--62360fefd025ebf3f6659f0907ae79b5d2fb6e89/create-business-portfolio.png)

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQmI4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8ef4db512a3ca74849c135b0bdae7224470a9596/add-number.png)

### Copiez les identifiants nécessaires

Une fois le numéro ajouté ou sélectionné, copiez ces valeurs depuis la page de configuration de l’API :

* **ID du numéro de téléphone**

* **ID du compte WhatsApp Business**

Vous devrez les saisir lors du processus de configuration manuelle.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQm44QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--7ca99f4d81babde83c16aa4e6aea5490491241d9/CleanShot-202026-07-16-20at-2012.38.30@2x.png)

Dans l’ancienne interface Meta, ces valeurs s’affichent directement sous le sélecteur **De** dans **WhatsApp → API setup**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQnY4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--155d64142bf2e480fe36d763593d0dc924bd8e80/CleanShot-202026-07-16-20at-2012.39.36@2x.png)

> Meta modifie fréquemment cette interface. Si votre écran diffère, cherchez la page de configuration de l’API WhatsApp et le numéro d’expéditeur sélectionné. L’ID du numéro de téléphone et l’ID du compte WhatsApp Business apparaissent en général à proximité du numéro **De** sélectionné.

## Configurer un jeton d’accès permanent WhatsApp Cloud API

Vous avez également besoin d’un jeton d’accès d’utilisateur système permanent avec les autorisations WhatsApp. Ce jeton permet à Chatwoot de se connecter à votre numéro WhatsApp Cloud API, d’envoyer et de recevoir des messages, et de synchroniser les modèles de messages.

### Ouvrir les utilisateurs système dans les paramètres Meta Business

1. Ouvrez [Meta Business Settings](https://business.facebook.com/settings).

2. Sélectionnez le portefeuille d’entreprise qui possède votre compte WhatsApp Business.

3. Accédez à **Utilisateurs → Utilisateurs système**.

4. Si vous avez déjà un utilisateur système pour Chatwoot, sélectionnez-le.

5. Si ce n’est pas le cas, cliquez sur **Ajouter**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQjM4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0b52dcd9332f77b1cddb1d0aad043652df164843/CleanShot-202026-07-16-20at-2012.43.38@2x.png)

### Créez un utilisateur système

1. Saisissez un nom pour l’utilisateur système, par exemple `Chatwoot WhatsApp`.

2. Sélectionnez **Admin** comme rôle de l’utilisateur système.

3. Cliquez sur **Créer un utilisateur système**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQi84QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0866a00e31eb542833b7c442080321ff676e0734/CleanShot-202026-07-16-20at-2012.45.15@2x.png)

### Générez un jeton

1. Sélectionnez l’utilisateur système.

2. Cliquez sur **Attribuer des ressources**.

3. Attribuez l’application Meta et le compte WhatsApp Business.

4. Accordez le niveau de contrôle requis.

5. Cliquez sur **Générer un jeton**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQnI4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--85394befae278c1e0bc39e92b7442a3c13e6d85a/CleanShot-202026-07-16-20at-2012.43.38@2x-20copy.png)

### Sélectionnez l’application Meta

Choisissez l’application Meta que vous avez créée ou sélectionnée plus tôt pour la configuration de l’API Cloud WhatsApp, puis cliquez sur **Suivant**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQlg4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4be301cf2a8435dc58ca05c3782da413f985932c/CleanShot-202026-07-16-20at-2012.45.37@2x.png)

### Définir l’expiration du jeton

Sélectionnez **Jamais** comme expiration du jeton, puis cliquez sur **Suivant**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQmY4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b873faaae720eed362c3c61a39797d5710cd63a6/CleanShot-202026-07-16-20at-2012.45.48@2x.png)

### Attribuer les autorisations

Sélectionnez les autorisations WhatsApp requises :

* `whatsapp_business_messaging`

* `whatsapp_business_management`

Puis continuez pour générer le jeton.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQlA4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--06a023e8e986799b686c5722e941905452ea16a1/CleanShot-202026-07-16-20at-2012.46.27@2x.png)

### Copiez le jeton

Après que Meta ait généré le jeton, cliquez sur **Copier** et conservez-le en lieu sûr.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQjc4QVFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--bd725841111effe0e6b2ab966b900a5bc86d3dbb/CleanShot-202026-07-16-20at-2012.47.35@2x.png)

> Gardez ce jeton privé. Toute personne y ayant accès pourrait utiliser votre connexion WhatsApp Cloud API.

## Connecter Votre Compte Chatwoot

Connectons maintenant votre compte Chatwoot avec votre API Cloud WhatsApp. Connectez-vous à votre compte Chatwoot, allez dans Paramètres > Boîte de réception > Sélectionnez le flux manuel.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRmdBQWdZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--37586dbbe2bca57b3971b173a22c8caf75d1eb12/CleanShot%202026-07-28%20at%2012.11.10@2x.png)

Saisissez votre numéro de téléphone, l’ID du numéro, l’ID d’entreprise et le jeton d’accès que vous avez obtenu à l’étape précédente.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT1V3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--36b14c0dff0a29cb3de0a07be4a8fa42f649decb/cw-2.png)

Ajoutez des membres à votre équipe pour votre boîte de réception WhatsApp

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFl3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--aff01faf7c0ba58daf722b218a378ebdae62617d/cw-3.png)

Copiez l’URL du webhook et le jeton de vérification du webhook fournis ici

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQVl4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ebc9f3052573b38afdd96995bfd97af6e9ed75cc/cw-4.png)

## **Configurer Votre Webhook**

Nous devons configurer le webhook WhatsApp pour recevoir les messages entrants envoyés à votre numéro d’entreprise.

Votre URL de callback doit suivre le format [**https://app.chatwoot.com/webhooks/whatsapp/{phone_number}**](https://app.chatwoot.com/webhooks/whatsapp/%7Bphone_number%7D).

Connectez-vous à votre compte développeur Facebook et rendez-vous sur WhatsApp > Configuration

Collez ici l’URL de webhook Chatwoot et le jeton de vérification, puis cliquez sur "Vérifier et enregistrer"

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQmN4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3802889ac4ce26cd2264b6dab4267fd1cb6afe53/hk-1.png)

Définissez les autorisations du webhook en vous abonnant aux messages

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ1V4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a8d5c4c957aa29875247a3b135eb2acf945fddcc/hk-2.png)

Voilà, tout est prêt ! Vous pouvez maintenant commencer à envoyer des messages WhatsApp via Chatwoot.

### FAQs

**Comment configurer plusieurs numéros sous une seule application Meta ?**

Une **application Meta** ne permet de configurer qu’un seul point de terminaison Webhook. Créez donc des boîtes de réception dans Chatwoot pour tous les numéros nécessaires. Vous devrez configurer l’URL du Webhook fournie pour une seule de ces boîtes de réception dans l’application **Meta** afin que toutes les autres boîtes de réception fonctionnent.

**Quels types de modèles** WhatsApp **sont pris en charge par Chatwoot ?**

Veuillez consulter la [**documentation**](https://www.chatwoot.com/hc/user-guide/articles/1754940076-whatsapp-templates) pour plus de détails sur les modèles.

**Quels sont les types de médias pris en charge ?**

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRHZuSWdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--469bfec94ea6ac0381da7d5223e83312dbaf5ca9/image.png)