
# FluentCRM

> **À qui s'adresse ceci ?** Aux entreprises qui gèrent leur liste d'e-mails dans FluentCRM sur leur propre site WordPress et qui souhaitent y intégrer leurs conversations. Si vous n'utilisez pas FluentCRM, vous pouvez ignorer cette page.
>
> Vous utilisez un autre CRM ou un outil d'e-mailing ? Tout outil doté d'une API peut être connecté : consultez [Connecter un outil que nous ne listons pas](connecting-other-tools.md).

FluentCRM est une extension de CRM et d'e-mailing qui s'intègre directement dans WordPress : contacts, étiquettes, listes et campagnes que vous envoyez. La connecter à <span data-t="appName">Your AI Connector</span> permet à vos [automatisations](../automations/automations.md) d'y ajouter des étapes. Ainsi, un nouveau prospect WhatsApp devient un contact FluentCRM avec la bonne étiquette, et la séquence d'e-mails que vous avez déjà créée prend le relais. Plus d'exportation, plus de copier-coller, plus besoin d'attendre vendredi.

Rien n'est installé sur votre site WordPress. Vous connectez votre propre site avec vos propres identifiants, et nous appelons l'API que FluentCRM expose déjà.

**Disponibilité :** Les automatisations sont disponibles sur tous les comptes. Elles se trouvent déjà dans votre barre latérale et il n'y a rien à activer ou à demander.

---

## Ce dont vous avez besoin

FluentCRM repose sur l'API REST de WordPress, elle utilise donc exactement les mêmes détails que la connexion [WordPress](wordpress.md) :

- Le **site WordPress sur lequel FluentCRM est exécuté**, accessible via **https**, sous WordPress **5.6 ou une version ultérieure**.
- Les **permaliens personnalisés** activés (**Réglages → Permaliens**, tout sauf « Simple »), ce qui permet à l'adresse `/wp-json/` de fonctionner.
- Un **mot de passe d'application** pour l'utilisateur WordPress sous lequel l'automatisation doit agir : **Utilisateurs → Profil → Mots de passe d'application → Ajouter un nouveau**. WordPress l'affiche une seule fois, par blocs séparés par des espaces. Copiez-le avec les espaces.

Cet utilisateur doit être autorisé à gérer FluentCRM dans WordPress. Votre véritable mot de passe de connexion n'est jamais utilisé, et la suppression ultérieure du mot de passe d'application révoque exactement cette connexion.

---

## Connexion à FluentCRM

Vous vous connectez depuis une automatisation, la première fois que vous utilisez une étape FluentCRM.

1. Ouvrez **Automatisations** dans la barre latérale (sous le groupe **AI Studio**) et ouvrez ou créez une automatisation.
2. Ajoutez une étape et recherchez **FluentCRM** dans le sélecteur d'étapes.
3. Choisissez l'action souhaitée. L'étape vous demandera de vous connecter en premier.
4. Remplissez les trois champs :
   - **URL du site** est l'adresse du site WordPress sur lequel FluentCRM est exécuté, commençant par `https://`.
   - **Nom d'utilisateur WordPress** est le nom d'utilisateur avec lequel cet utilisateur se connecte, et non son adresse e-mail.
   - **Mot de passe d'application** est le mot de passe que vous avez créé ci-dessus, collé avec ses espaces.
5. Cliquez sur connecter.

Nous vérifions les détails auprès de votre site avant d'enregistrer quoi que ce soit, en lisant un contact depuis FluentCRM. Des détails incorrects, ou un site où `/wp-json/` ne se résout pas, sont refusés à l'écran avec le motif. Votre mot de passe d'application est stocké de manière chiffrée et ne vous est jamais montré.

---

## Les étiquettes et les listes sont fournies sous forme d'identifiants (ID)

C'est la chose essentielle à savoir avant de construire quoi que ce soit. Chaque champ qui accepte des tags ou des listes nécessite leurs **numéros d'ID**, séparés par des virgules, et non leurs noms. `1, 2` fonctionne ; `Newsletter, VIP` ne fonctionne pas, et l'éditeur le signale sous le champ. Un identifiant qui s'avère incorrect uniquement lors de l'exécution de l'automatisation (par exemple, un identifiant provenant d'une étape précédente) arrête l'étape avec une erreur, au lieu de s'exécuter silencieusement sans ce tag.

Vous trouverez les numéros dans FluentCRM : ouvrez **Étiquettes** ou **Listes** dans le menu FluentCRM, et l'identifiant de chaque ligne se trouve dans la barre d'adresse lorsque vous l'ouvrez. Notez la poignée que vous prévoyez d'utiliser une fois, et c'est terminé.

---

## Les actions

Chaque action est une étape sur le canevas d'automatisation, et chaque champ accepte des données provenant des étapes précédentes via les boutons habituels d'insertion de données.

### Créer ou mettre à jour un contact

Ajoute un contact ou met à jour celui qui possède déjà cet e-mail. L'envoi du même e-mail deux fois met à jour le contact au lieu d'échouer, vous pouvez donc exécuter cette action sur chaque nouveau prospect sans vérification préalable.

- **Email** est l'adresse e-mail du contact. Requis. Généralement l'e-mail du contact provenant du déclencheur.
- **Prénom**, **Nom** et **Téléphone** sont facultatifs.
- **Statut** est choisi dans une liste : Subscribed (Abonné), Pending (En attente), Unsubscribed (Désabonné) ou Transactional (Transactionnel). Requis, car FluentCRM en a besoin, et cela s'applique également aux contacts existants : **Subscribed réabonne une personne qui s'était désabonnée**, donc ne le choisissez que lorsque la personne a demandé à rejoindre la liste. **Pending** envoie l'e-mail de double opt-in de FluentCRM.
- **Tag IDs** sont les tags à leur attribuer, séparés par des virgules. Facultatif.
- **List IDs** sont les listes auxquelles les ajouter, séparées par des virgules. Facultatif.

### Trouver un contact par e-mail

Recherche un contact par adresse e-mail et renvoie son identifiant, ses étiquettes et ses listes.

- **E-mail** est l'adresse à rechercher. Requis.

Sa sortie est ce dont les étapes suivantes ont besoin, car elles fonctionnent avec un identifiant de contact.

### Ajouter des étiquettes à un contact

Attache une ou plusieurs étiquettes à un contact qui existe déjà.

- **Contact ID** désigne le contact concerné. Requis. Normalement récupéré à partir d'une étape **Find contact by email** (Trouver un contact par e-mail) plus tôt dans l'automatisation.
- **Email** est l'e-mail du contact. Requis, car FluentCRM demande l'e-mail à chaque mise à jour.
- **Tag IDs** sont les tags à attacher, séparés par des virgules. Requis.
- **Change status** (Changer le statut) est facultatif. Si vous laissez sur **Keep current status** (Conserver le statut actuel), le statut du contact n'est pas modifié ; ainsi, ajouter un tag à une personne désabonnée ne la réabonnera pas.

### Supprimer des étiquettes d'un contact

Les mêmes champs, pour retirer des étiquettes au lieu de les ajouter.

### Ajouter un contact aux listes

- **Contact ID**, **Email** et **List IDs** (séparés par des virgules), avec la même option **Change status** (Changer le statut) facultative.

---

## Un exemple d'automatisation

**Chaque nouveau prospect WhatsApp arrive dans FluentCRM, étiqueté selon sa provenance.**

1. **Déclencheur :** message entrant d'un nouveau contact.
2. **Créer ou mettre à jour un contact**, avec l'e-mail, le prénom et le téléphone du contact provenant du déclencheur, ainsi que l'**ID de liste** de votre liste principale.
3. **Ajouter des étiquettes au contact** n'est pas nécessaire ici, car l'étape 2 peut déjà inclure les **ID d'étiquettes**. Utilisez-la lorsque l'étiquette est ajoutée plus tard dans la conversation.

Et la version où l'étiquette est ajoutée plus tard, qui est la plus utile :

1. **Déclencheur :** une étiquette est ajoutée au contact, par exemple `asked about pricing`, par votre agent IA.
2. **Trouver un contact par e-mail**, avec l'e-mail du contact.
3. **Ajouter des étiquettes au contact**, en utilisant l'ID de l'étape 2, le même e-mail et l'ID d'étiquette FluentCRM pour votre séquence de tarification.

L'automatisation propre à FluentCRM envoie ensuite la séquence d'e-mails que cette étiquette déclenche. La conversation a lieu sur WhatsApp, le suivi se fait par e-mail, et personne ne déplace manuellement une ligne entre les deux.

---

## Bon à savoir

- **Les étapes qui nécessitent un ID de contact viennent après une étape de recherche (Find).** C'est la structure normale : trouver le contact, puis agir sur l'identifiant renvoyé par l'étape de recherche.
- **Les sorties circulent vers l'avant.** Tout ce qu'une action renvoie est disponible pour les étapes ultérieures en tant que variables.
- **Des identifiants, pas des noms,** pour chaque champ de tag et de liste. Un nom dans ce champ est signalé dans l'éditeur et arrête l'étape lors de son exécution.
- **Certains hébergeurs suppriment l'en-tête Authorization** avant que WordPress ne le voie, ce qui fait qu'un mot de passe d'application correct semble erroné. Si vos informations sont certainement correctes et que la connexion est toujours refusée, c'est la question à poser à votre hébergeur.
- **Il n'existe aucun déclencheur qui surveille FluentCRM.** Rien ne l'interroge pour détecter des changements. Pour que FluentCRM lance une automatisation, ajoutez un déclencheur **Webhook** à l'automatisation et pointez un webhook sortant de FluentCRM vers l'adresse qu'il vous fournit.
- **Tout ce qui ne figure pas dans la liste ci-dessus** peut toujours être réalisé avec l'étape **HTTP request** (Requête HTTP).

---

## Étapes suivantes

- [Automatisations](../automations/automations.md) : déclencheurs, étapes, conditions et comment un flux de travail est assemblé.
- [WordPress](wordpress.md) : articles et utilisateurs sur le même site, avec les mêmes détails de connexion.
- [MemberPress](memberpress.md) : abonnements et paiements sur votre site WordPress.
- [Connecter un outil que nous ne listons pas](connecting-other-tools.md) : fonctions personnalisées, API et webhooks.
