> ## 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.

# Ajouter le canal personnalisé Flowella à la boîte de réception HubSpot

> Connectez Flowella comme canal personnalisé HubSpot afin que les conversations WhatsApp arrivent dans la boîte de réception des conversations aux côtés des e-mails, des chats et des appels pour votre équipe.

Le canal personnalisé Flowella intègre chaque conversation WhatsApp gérée par Flowella dans la [boîte de réception des conversations](https://knowledge.hubspot.com/inbox/compose-and-reply-to-emails-in-the-conversations-inbox) HubSpot. Votre équipe lit et répond aux fils WhatsApp au même endroit qu'elle gère e-mails, chats et appels, et chaque message est enregistré sur la fiche du contact.

Dans l'écran **Connecter un canal** de HubSpot, Flowella apparaît sous le nom **Flowella Channel**, à côté d'E-mail d'équipe, Formulaires, Facebook Messenger, WhatsApp et Appels.

## Ce que vous apporte le canal Flowella

* Une boîte de réception unique pour les conversations WhatsApp, aux côtés de vos autres canaux HubSpot.
* Routage automatique des nouvelles conversations vers les bons utilisateurs ou équipes.
* Réponses et modèles enregistrés sur le contact, visibles dans la chronologie et dans les rapports.
* La possibilité de basculer entre WhatsApp et d'autres canaux en pleine conversation depuis l'éditeur de réponse.

## Prérequis

Les canaux personnalisés sont conditionnés par HubSpot, pas par Flowella. Votre portail doit disposer de l'un des abonnements qualifiants avant que l'option **Flowella Channel** n'apparaisse.

<Note>
  **Disponible avec l'un des abonnements HubSpot suivants, sauf mention contraire :**

  * **Sales Hub** Professional ou Enterprise
  * **Service Hub** Professional ou Enterprise

  Des crédits HubSpot peuvent également être requis. Consultez le guide HubSpot [Connect custom channels to the conversations inbox](https://knowledge.hubspot.com/inbox/connect-custom-channels-to-the-conversations-inbox) pour les conditions actuelles.
</Note>

Les autorisations et les sièges sont répartis entre les étapes :

| Pour faire ceci | Vous avez besoin de |
| - | - |
| Installer l'application Flowella dans votre portail | L'autorisation d'accès à l'App Marketplace |
| Connecter le canal à la boîte de réception des conversations | Super Admin |
| Définir les règles de routage du canal | Un siège Sales ou un siège Service |

## Avant de connecter

* Votre compte Flowella est connecté à votre portail HubSpot. Consultez [Configuration](/fr/hubspot/setup) si ce n'est pas encore fait.
* L'application Flowella est installée dans votre portail HubSpot.
* Au moins un WhatsApp Business Account et un numéro de téléphone sont connectés dans Flowella.

## Connecter le canal Flowella

<Steps>
  <Step title="Ouvrir les paramètres de la boîte de réception">
    Dans HubSpot, cliquez sur l'icône **paramètres** dans la barre de navigation supérieure. Dans la barre latérale gauche, allez dans **Boîte de réception et centre d'assistance**, puis cliquez sur **Boîte de réception**.
  </Step>

  <Step title="Commencer à connecter un canal">
    En haut à droite, cliquez sur **Connecter un canal**, puis sélectionnez **Flowella Channel** dans la liste des types de canaux. Si l'option n'apparaît pas, vérifiez que l'application Flowella est installée et réautorisée dans votre portail.
  </Step>

  <Step title="Autoriser le canal">
    Cliquez sur **Continuer avec Flowella Channel** et fournissez les identifiants demandés dans la fenêtre pop-up. Les champs affichés dépendent de la configuration de votre canal Flowella.
  </Step>

  <Step title="Définir les règles de routage (optionnel)">
    Choisissez comment les nouvelles conversations WhatsApp sont attribuées. Vous pouvez router vers des utilisateurs et des équipes spécifiques, ou vers le propriétaire du contact. Définir des règles de routage nécessite un siège Sales ou Service.
  </Step>

  <Step title="Terminer">
    Cliquez sur **Suivant**, puis sur **Terminé**. Le canal Flowella est connecté, et les conversations WhatsApp entrantes apparaissent désormais dans votre boîte de réception des conversations.
  </Step>
</Steps>

## Comment les messages circulent entre WhatsApp et la boîte de réception HubSpot

Le canal est **bidirectionnel** — chaque message WhatsApp entrant est publié dans HubSpot, et chaque réponse sortante HubSpot est relayée vers WhatsApp via Meta avec le statut aller-retour reflété des deux côtés.

| Direction | Ce qui se passe |
| - | - |
| **Entrant (WhatsApp → HubSpot)** | Lorsqu'un contact envoie un message WhatsApp, Flowella crée ou associe le contact HubSpot et publie le message dans le fil du canal Flowella. Le même message reste visible dans la [boîte de réception Flowella](/fr/app/inbox). |
| **Sortant (HubSpot → WhatsApp)** | Lorsqu'un agent répond depuis la boîte de réception HubSpot, Flowella transmet le message à Meta et écrit le résultat de la livraison (`SENT` ou `FAILED`) dans le fil HubSpot afin que l'agent voie le même statut que dans la boîte de réception Flowella. Si l'envoi échoue, la raison de l'erreur WhatsApp apparaît dans les détails **Non délivré** du message. |
| **Modèles depuis HubSpot** | Le composeur de réponse vous permet d'envoyer des modèles approuvés et les modèles de réouverture Flowella (voir [Modèles de réponse](/fr/settings/reply-templates)) lorsque la fenêtre de 24 heures s'est fermée. |

<Note>
  La connexion est gérée via le point de terminaison hébergé de Flowella à l'adresse `https://api.flowella.io/api/webhooks/hubspot/channel/connect`. Cette URL est pilotée par l'environnement et résolue automatiquement pendant l'assistant de connexion marketplace — il n'y a rien à copier-coller. Si vous voyiez auparavant une erreur **Invalid settings** ou 500 lors de la tentative de connexion du canal, ce problème est désormais corrigé.
</Note>

## Répondre depuis la boîte de réception

Une fois connectées, les conversations WhatsApp se comportent comme n'importe quel autre canal dans la boîte de réception. Ouvrez la boîte de réception, filtrez par le canal Flowella si vous voulez vous concentrer sur WhatsApp, et répondez en temps réel.

<Note>
  Les réponses en texte libre ne sont possibles qu'à l'intérieur de la fenêtre de service client de 24 heures de WhatsApp. Après 24 heures depuis le dernier message du contact, vous ne pouvez envoyer qu'un modèle approuvé. Il s'agit d'une règle de la WhatsApp Business Platform, pas d'une limite HubSpot ou Flowella. Voir [Utilisation de la boîte de réception](/fr/app/inbox) et [Modèles](/fr/app/templates).
</Note>

### Lorsque la fenêtre de 24 heures est fermée

Si vous envoyez une réponse en texte libre après la fermeture de la fenêtre, Flowella ne la livre pas. Le message est marqué comme non délivré dans le fil HubSpot avec la raison :

```text theme={null}
WhatsApp 24-hour window closed, a template is required to re-engage
```

Flowella publie alors un message d'orientation dans le fil (« La fenêtre WhatsApp de 24 heures est fermée. Utilisez Réengager pour envoyer un modèle approuvé. ») ainsi que des puces de réponse rapide **Réengager**.

### Puces de réengagement

Les puces vous permettent de rouvrir la conversation sans quitter la boîte de réception HubSpot. Chaque puce envoie l'un des [modèles de réouverture](/fr/settings/reply-templates) système de Flowella avec le message de réengagement par défaut :

| Puce | Modèle de réouverture | Quand elle apparaît |
| - | - | - |
| **Réengager** | Service | Toujours |
| **Envoyer une mise à jour** | Mise à jour | Lorsque le modèle de réouverture Mise à jour est activé et approuvé |
| **Envoyer une offre** | Offre | Lorsque le modèle de réouverture Offre est activé et approuvé |

Cliquez sur une puce et Flowella envoie le modèle approuvé correspondant au contact. L'envoi est enregistré dans le fil comme un message modèle, et il est facturé comme un message Utility selon la tarification par message de Meta. Si le modèle n'est pas encore approuvé par Meta, l'envoi est marqué comme non délivré avec la raison `Re-engagement template is not available`.

### Raisons d'échec de livraison

Lorsque Meta rejette un message sortant pour toute autre raison, Flowella marque le message `FAILED` et écrit l'erreur WhatsApp dans le fil HubSpot. Cliquez sur le statut **Non délivré** du message pour voir la raison, au format :

```text theme={null}
WhatsApp send failed: <raison de l'erreur Meta> (code <code d'erreur>)
```

La raison inclut le code d'erreur Meta afin que vous puissiez le consulter dans la [référence des codes d'erreur](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/) de Meta. La même raison est enregistrée sur le message dans Flowella.

## Gérer ou supprimer le canal

Allez dans **Paramètres > Boîte de réception et centre d'assistance > Boîte de réception**, puis survolez le canal Flowella :

* **Modifier** pour changer le routage et l'attribution.
* **Options > Déplacer vers le centre d'assistance** pour déplacer le canal et ses conversations vers le centre d'assistance.
* **Options > Supprimer** pour supprimer le canal.
* Basculez l'interrupteur **Statut** pour désactiver le canal sans le supprimer.

## Connexes

<CardGroup cols={2}>
  <Card title="Configuration" icon="plug" href="/fr/hubspot/setup">
    Connectez votre compte Flowella à votre portail HubSpot.
  </Card>

  <Card title="Utilisation de la boîte de réception" icon="inbox" href="/fr/app/inbox">
    Lisez, répondez et gérez les conversations WhatsApp dans Flowella.
  </Card>

  <Card title="Activité des contacts" icon="activity" href="/fr/hubspot/contact-activity">
    Consultez chaque activité WhatsApp enregistrée sur un contact.
  </Card>

  <Card title="Actions de workflow" icon="git-branch" href="/fr/hubspot/workflow-actions">
    Déclenchez des envois WhatsApp depuis les workflows HubSpot.
  </Card>
</CardGroup>


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