> For the complete documentation index, see [llms.txt](https://docs.fullwhere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullwhere.com/integrations/messageries-instantanees/whatsapp.md).

# WhatsApp

Centralisez vos messages WhatsApp Business dans Fullwhere et rattachez chaque connexion à la bonne marque ou localisation.

{% hint style="info" icon="shield-check" %}
**Droits d’accès**

Vous devez être un membre superviseur avec des droits Administrateur dans Fullwhere et disposer des droits nécessaires sur les ressources Meta à connecter.
{% endhint %}

### Choisir votre méthode de connexion

* [**Connexion intégrée**](#connexion-integree) : pour un numéro qui n’est pas encore utilisé sur WhatsApp ou qui est utilisé via l’API WhatsApp d’un autre fournisseur.
* [**Connexion coexistence**](#connexion-coexistence) : pour un numéro déjà utilisé dans l’application mobile **WhatsApp Business**. Prévoyez un accès au téléphone concerné pour valider la connexion.

### Démarrer la connexion dans Fullwhere

{% stepper %}
{% step %}

#### Ouvrir l’intégration

Dans Fullwhere, accédez à **Paramètres >** [**Connectivités**](https://app.fullwhere.com/settings/connectivities), puis cliquez sur la carte **WhatsApp**.

Si vous utilisez déjà cette intégration, sa carte se trouve dans **Intégrations activées**. Sinon, retrouvez-la dans **Connexions disponibles** ou **Autres intégrations**.
{% endstep %}

{% step %}

#### Choisir la marque ou la localisation

Sur la page de l’intégration, cliquez sur **Connecter**, puis sélectionnez la **marque** ou la **localisation** à laquelle rattacher la connexion. Utilisez la recherche pour la retrouver.

Le parcours d’autorisation Meta s’ouvre ensuite.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2F4GerKKQLvfwvYxs3SE0H%2Fmeta-whatsapp-destination-fictif.png?alt=media" alt="Choix d’une marque ou d’une localisation depuis le bouton Connecter"><figcaption><p>Sélectionnez la destination de la connexion dans Fullwhere.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

Poursuivez avec la méthode correspondant à votre numéro.

### Connexion intégrée

{% stepper %}
{% step %}

#### Accepter les conditions WhatsApp

Suivez les instructions affichées par Meta et acceptez les conditions pour poursuivre.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2FvsksekfSlyjJoOUqB1A0%2Fimage.png?alt=media&amp;token=f60a543c-2259-4c8e-9ee3-372222b9e5b9" alt="" width="425"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Sélectionner les éléments à connecter

**1)** Commencez par sélectionner le Portefeuille Business Meta à utiliser (également appelé « Meta Business Manager »).\
S'il n'en existe aucun, choisissez l'option permettant de créer un nouveau portefeuille d'entreprise.

**2)** Sélectionnez ensuite un compte WhatsApp Business (WABA) existant.\
Pour créer un nouveau compte WABA, sélectionnez « Créer un compte WhatsApp Business ».

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2FzsYTvCIENEUyexf36Uo0%2Fimage.png?alt=media&amp;token=4fb5cbad-8526-40ef-972e-c8fa8167858c" alt="" width="425"><figcaption></figcaption></figure>

Si vous créez un nouveau portefeuille d'entreprise ou un nouveau compte WABA, des informations supplémentaires vous seront demandées à l'étape suivante.
{% endstep %}

{% step %}

#### Ajouter un numéro

Suivez le parcours Meta pour sélectionner ou ajouter le numéro de téléphone de votre entreprise.

Si Meta vous demande de vérifier le numéro, choisissez l’un des moyens proposés :

* Un SMS, ou
* Un appel vocal

Suivez les instructions à l'écran pour terminer le processus de vérification.
{% endstep %}

{% step %}

#### Terminer la procédure de connexion

Une fois le numéro validé, poursuivez les étapes affichées par Meta jusqu’au retour dans Fullwhere.
{% endstep %}
{% endstepper %}

### Connexion coexistence

{% stepper %}
{% step %}

#### Accepter les conditions WhatsApp

Suivez les instructions affichées par Meta et acceptez les conditions pour poursuivre.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2FvsksekfSlyjJoOUqB1A0%2Fimage.png?alt=media&amp;token=f60a543c-2259-4c8e-9ee3-372222b9e5b9" alt="" width="425"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Sélectionner les éléments à connecter

**Portefeuille Business**

Commencez par sélectionner le Portefeuille Business Meta à utiliser (également appelé « Meta Business Manager »).\
S'il n'en existe aucun, choisissez l'option permettant de créer un nouveau portefeuille d'entreprise.

**Compte WhatsApp Business**

Dans le menu déroulant Compte WhatsApp Business, sélectionnez l’option "**Associer une application WhatsApp Business**" puis cliquez sur **Suivant**.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2FatM4cuyBS1ORX43J1xkE%2Fimage.png?alt=media&amp;token=df23ef22-1300-422d-9324-3d05a37fa99f" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Indiquez le numéro de téléphone à connecter

Indiquer le numéro de téléphone utilisé sur l'application mobile **WhatsApp Business** que vous souhaitez connecter à Fullwhere.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2FQk81SnVasooRNKuu2GC5%2Fcoex%201.png?alt=media&amp;token=699dc6d3-ebe5-430e-b877-998200c386b5" alt="" width="375"><figcaption></figcaption></figure>

Une fois le numéro renseigné, cliquez sur Suivant puis, à l'étape suivante, cliquez également sur **Suivant**.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2FLzXOxOkjsJ8rgrSY0WlI%2Fcoex%202.png?alt=media&amp;token=e21a543b-10d6-40a9-9bc5-c60eb333c355" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Valider la connexion

À cette étape, **vous aurez besoin d'accéder au téléphone mobile sur lequel la ligne WhatsApp est utilisée via l'application WhatsApp Business**.

Deux méthodes de vérification s’offrent à vous :

* **Par QR-Code**\
  Si vous avez un accès direct au téléphone, c'est le moyen le plus rapide pour valider la connexion :\
  \- Consulter vos messages WhatsApp sur l'application WhatsApp Business du téléphone et accédez au message reçu de la part de "Facebook Business", puis sur le message reçu, cliquez sur "Connect".\
  ![](https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2F279thTF59doDesz8WBTi%2FWhatsApp%20Image%202026-07-07%20at%2013.22.29.jpeg?alt=media\&token=68f14866-bcc1-44cc-ab72-12fe197ecf7c)\
  \
  \- Depuis la page s'ouvrant sur votre mobile, scanner le QR-Code puis suivez le processus de connexion jusqu'à son terme. Il est important d'activer la synchronisation des messages si cela vous est demandé.
* **Par code de validation**\
  Si vous n'avez pas directement accès au téléphone, cette option vous permet de transmettre un code de validation à une personne ayant accès au téléphone :\
  \- Sur la page affichant le QR-Code, faites défiler la page vers le bas puis cliquez sur **Utiliser plutôt un code d'accès**.\
  ![](https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2Fe21UQWzUVDa10LOM5O8c%2Fcoex%204.png?alt=media\&token=318df26c-f982-42fc-885e-f77ef4c0e2c4)\
  \
  \- Transmettez le code affiché à la personne ayant accès au téléphone, puis indiquez-lui de consulter les messages WhatsApp sur l'application WhatsApp Business du téléphone et d'accéder au message reçu de la part de "Facebook Business", puis de cliquer sur "Connect".\
  ![](https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2F3yCN36ue9ZOFITazIa0q%2FWhatsApp%20Image%202026-07-07%20at%2013.22.29.jpeg?alt=media\&token=6bd4613e-8195-4415-85f7-80717aaa2efe)\
  \
  \- La personne sera invitée à indiquer le code que vous lui avez transmis pour valider la connexion, puis pourra poursuivre le processus de connexion jusqu'à son terme. Il est important d'activer la synchronisation des messages si cela est demandé.<br>

**Une fois le processus terminé sur votre téléphone, revenez au processus de connexion sur votre ordinateur pour poursuivre.**
{% endstep %}

{% step %}

#### Terminer le processus de connexion

Sur l’écran suivant, indiquez votre fuseau horaire puis cliquez sur **Suivant**.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2Fs0QIeB48IiSm8ODufY4C%2Fimage.png?alt=media&amp;token=b847f286-70b9-45c1-95b9-89903f602955" alt="" width="375"><figcaption></figcaption></figure>

Sur l'écran suivant, cliquez sur **Confirmer** pour valider la connexion.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2Fj0BglgnN4Mbrk2FkiIAC%2Fcoex%206.png?alt=media&amp;token=4927f914-9485-473b-8f14-8b871d436f7b" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Après l’autorisation Meta, vérifiez le statut dans le tableau **Connexions** pour savoir si une action reste nécessaire.
{% endhint %}

### Vérifier et gérer vos connexions

De retour dans Fullwhere, consultez le tableau **Connexions** sur la page **WhatsApp**. Il affiche le **nom**, la **zone liée** — marque ou localisation —, la **date d’ajout** et le **statut** de chaque connexion.

Utilisez **Rechercher**, **Zone** et **Statut** pour retrouver une connexion.

<figure><img src="https://3070119408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrgnmnQ7jxPqU1YGpUkdx%2Fuploads%2FqdAfaeclqwuy8InESc6X%2Fmeta-whatsapp-connexions-fictif.png?alt=media" alt="Connexions WhatsApp avec des noms et numéros fictifs"><figcaption><p>Exemple fictif de connexions WhatsApp.</p></figcaption></figure>

Le statut de la ligne vous indique la suite à donner :

| Statut                       | Que faire ?                                                                                                                                  |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connecté**                 | La connexion est active.                                                                                                                     |
| **Configuration à terminer** | Ouvrez le menu **⋮ > Finaliser la connexion** et terminez l’autorisation Meta. La marque ou la localisation déjà choisie est conservée.      |
| **Synchronisation en cours** | Patientez pendant la synchronisation.                                                                                                        |
| **Échec de synchronisation** | Dans le menu **⋮**, cliquez sur **Réessayer**.                                                                                               |
| **À reconnecter**            | Cliquez sur **⋮ > Reconnecter** pour rétablir l’autorisation Meta.                                                                           |
| **Autorisations manquantes** | Vérifiez vos droits sur la ressource Meta, puis cliquez sur **⋮ > Renouveler l’autorisation** et accordez les accès nécessaires à Fullwhere. |
| **À réactiver**              | Cliquez sur **⋮ > Réactiver** lorsque l’autorisation Meta est valide.                                                                        |
| **En pause**                 | Cliquez sur **⋮ > Reprendre** lorsque l’autorisation Meta est valide.                                                                        |

Les actions proposées dans le menu **⋮** dépendent de l’état de la connexion. Si l’autorisation Meta doit être rétablie, commencez par **Reconnecter** ou **Renouveler l’autorisation**, puis vérifiez à nouveau le statut de la ligne.

#### Mettre en pause ou reprendre

Pour suspendre une connexion, ouvrez le menu **⋮** de sa ligne et sélectionnez **Mettre en pause**. L’association à la marque ou à la localisation et les données sont conservées. L’autorisation Meta reste en place.

Pour la remettre en service, utilisez **Reprendre**. Le renouvellement de l’autorisation Meta ne reprend pas automatiquement une connexion en pause.

<details>

<summary>Autres statuts : association et dissociation</summary>

* **Lié à aucune ressource** : l’association à une ressource doit être rétablie dans le parcours dédié.
* **Dissociation en cours** : patientez jusqu’à la fin de l’opération.
* **Dissociation en échec** : ouvrez le menu **⋮ > Réessayer**.

Pendant une synchronisation ou une dissociation en cours, aucune nouvelle action de mise en pause, de reprise ou de réactivation n’est proposée.

</details>

#### Synchroniser vos modèles WhatsApp

Dans le menu **⋮** de la connexion WhatsApp, utilisez **Synchroniser les templates** pour importer vos modèles de messages depuis Meta.

### Si la connexion n’aboutit pas

<details>

<summary>Aucune ressource compatible n’est trouvée</summary>

Recommencez depuis **Connecter**, utilisez le compte Meta qui dispose des accès nécessaires et partagez les ressources souhaitées avec Fullwhere. Si le message indique qu’aucun compte WhatsApp Business n’a été partagé, sélectionnez votre compte WhatsApp Business pendant l’autorisation.

</details>

<details>

<summary>Les droits d’accès sont insuffisants ou l’autorisation n’est plus valide</summary>

Vérifiez les droits de votre compte Meta sur la ressource et les autorisations accordées à Fullwhere. Sur une connexion existante, utilisez **Reconnecter** ou **Renouveler l’autorisation**, selon l’action proposée.

</details>

<details>

<summary>Seules certaines connexions ont pu être finalisées</summary>

Consultez les ressources et les motifs indiqués dans le message de retour, puis vérifiez chaque ligne du tableau. Si une ligne affiche **Configuration à terminer**, utilisez **Finaliser la connexion**.

</details>

<details>

<summary>La ressource est déjà connectée avec une autre identité ou destination</summary>

Vérifiez la connexion existante et sa **Zone liée**. Si vous devez changer son rattachement et ne pouvez pas résoudre le conflit, contactez l’équipe Fullwhere.

</details>

<details>

<summary>La tentative a été annulée, a expiré ou rencontre une erreur temporaire</summary>

Relancez la connexion. En cas de vérification temporairement indisponible, réessayez dans quelques instants. Si la synchronisation n’a pas pu démarrer, vérifiez le statut de la ligne et utilisez **Réessayer** lorsqu’il est proposé.

</details>

Découvrez aussi notre [guide de gestion des messages WhatsApp](https://docs.fullwhere.com/usecases/gerer-vos-messages-whatsapp-avec-fullwhere.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fullwhere.com/integrations/messageries-instantanees/whatsapp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
