> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoints des WhatsApp Flows, chiffrement et sécurité

> Comment les endpoints de WhatsApp Flows échangent des données chiffrées, les clés et contrôles de santé exigés par Meta, et où Flowella héberge l'endpoint.

Un endpoint permet à un WhatsApp Flow de communiquer avec un serveur pendant que le client le remplit : pour vérifier une réponse, charger des options ou décider de l'écran suivant. Chaque requête entre WhatsApp et l'endpoint est chiffrée avec une paire de clés propre à votre numéro de téléphone, et WhatsApp contrôle régulièrement l'endpoint pour s'assurer qu'il fonctionne. Les Flows sans endpoint n'envoient leurs réponses qu'une fois le Flow terminé par le client.

> [!NOTE]
>
> **Dans Flowella.** Pris en charge. Pour les Flows créés à partir de formulaires HubSpot, Flowella héberge l'endpoint, crée et importe la clé de chiffrement sur votre numéro, répond aux contrôles de santé de WhatsApp et vérifie que chaque requête provient bien de WhatsApp. Vous n'avez aucun serveur à gérer. Les Flows du concepteur de Flows et de l'API Flowella n'utilisent pas d'endpoint.

## Le rôle d'un endpoint

| Requête | Quand WhatsApp l'envoie | Ce que renvoie l'endpoint |
| - | - | - |
| **Contrôle de santé** | Régulièrement, et avant la publication | Une confirmation qu'il est actif |
| **Échange de données** | Lorsque le client touche un bouton ou choisit une option configurée pour appeler l'endpoint | L'écran suivant à afficher, avec ses données, ou un message d'erreur à afficher sur l'écran actuel |
| **Notification d'erreur** | Lorsque le Flow sur le téléphone a rencontré un problème avec une réponse précédente | Un accusé de réception |

> [!NOTE]
>
> **Dans Flowella.** Lorsque le client soumet un Flow issu d'un formulaire HubSpot, l'endpoint vérifie les réponses par rapport au formulaire HubSpot en ligne et les soumet à HubSpot. En cas de problème, le client voit une erreur à l'écran et peut réessayer. Voir [Erreurs vues par le client](https://knowledge.flowella.io/fr/app/flows.md#errors-the-customer-sees).

## Chiffrement

* **Une paire de clés par numéro de téléphone.** L'entreprise crée une clé publique et une clé privée. La clé publique est importée sur le numéro de téléphone WhatsApp et signée par Meta. La clé privée reste sur l'endpoint.
* **Chaque requête est chiffrée.** WhatsApp chiffre chaque requête avec une clé à usage unique, que seul l'endpoint peut déverrouiller avec sa clé privée. La réponse est chiffrée de la même manière.
* **Les requêtes sont signées.** Chaque requête porte une signature générée avec le secret de l'application Meta, ce qui permet à l'endpoint de rejeter tout ce qui ne provient pas de WhatsApp.
* **Le numéro doit d'abord être enregistré.** La clé ne peut être importée qu'une fois le numéro de téléphone enregistré pour la Cloud API.

> [!NOTE]
>
> **Dans Flowella.** Flowella importe la clé sur votre numéro pour vous. Si le numéro n'est pas encore enregistré, la synchronisation affiche **Registration required**. Terminez l'enregistrement, puis relancez la synchronisation. Voir [Numéros de téléphone](https://knowledge.flowella.io/fr/whatsapp/accounts/phone-numbers.md).

## Versions de la Data API

| Data API | Apports |
| - | - |
| **3.0** | Le format d'origine des requêtes et réponses chiffrées |
| **4.0** | Meta vérifie que chaque requête correspond à un vrai message Flow et ajoute un Flow token signé facultatif que l'endpoint peut contrôler, à partir de novembre 2025 |

Les Flows Flowella issus de formulaires HubSpot utilisent la Data API 3.0. Voir [Versions de Flow JSON](https://knowledge.flowella.io/fr/whatsapp/flows/flow-json-versions.md).

## Garder l'endpoint en bonne santé

* Répondez rapidement. Meta recommande de répondre en moins d'une seconde.
* Restez joignable depuis Internet en permanence et répondez à chaque contrôle de santé.
* Renvoyez des erreurs que Meta reconnaît, afin que le Flow puisse afficher au client un message utile.

Si la santé se dégrade, WhatsApp limite le Flow, puis le bloque. Voir [Santé des Flows](https://knowledge.flowella.io/fr/whatsapp/flows/flow-health.md).

## Protéger ce que partagent les clients

* **Marquez les champs sensibles.** Flow JSON permet de marquer un champ comme sensible, pour que WhatsApp n'affiche pas sa valeur dans le récapitulatif que voit le client après la soumission.
* **Ne demandez pas d'identifiants sensibles.** Les politiques de WhatsApp interdisent de demander des numéros de carte complets, des numéros de compte bancaire ou des numéros d'identité nationale. Voir [Politique et sanctions](https://knowledge.flowella.io/fr/whatsapp/messaging/policy-and-enforcement.md).
* **Sachez où vont les réponses.** Dans Flowella, les réponses aux formulaires HubSpot vont dans HubSpot, les photos importées sont enregistrées comme fichiers HubSpot publics, et les réponses aux Flows du concepteur vont dans l'espace de stockage des soumissions de Flowella et vers le webhook de votre choix. Voir [Sécurité des données](https://knowledge.flowella.io/fr/security/data-security.md).

## Voir aussi

> [card] [Santé des Flows](https://knowledge.flowella.io/fr/whatsapp/flows/flow-health.md)
>
> Limitation, blocage et rétablissement.

> [card] [Présentation des WhatsApp Flows](https://knowledge.flowella.io/fr/whatsapp/flows/flows-overview.md)
>
> Flows statiques et Flows avec endpoint.

> [card] [Les Flows dans Flowella](https://knowledge.flowella.io/fr/app/flows.md)
>
> Comment les Flows issus de formulaires HubSpot sont soumis.

> [card] [Codes d'erreur des Flows](https://knowledge.flowella.io/fr/whatsapp/errors/flows-error-codes.md)
>
> Erreurs d'endpoint et de publication.

Vérifié par rapport à la documentation de Meta le 18 novembre 2026 : [Implementing endpoints for Flows](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/implementingyourflowendpoint), [Flows encryption](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/whatsapp-business-encryption), [Flow health and monitoring](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/healthmonitoring) et le [WhatsApp Flows changelog](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/changelog).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.