
# 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">DM Champ</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 seule chose à savoir avant de construire quoi que ce soit. Chaque champ qui accepte des étiquettes ou des listes nécessite leurs **numéros d'identification (ID)**, séparés par des virgules, et non leurs noms. `1, 2` fonctionne ; `Newsletter, VIP` ne fonctionne pas.

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.

- **E-mail** 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 `subscribed`, `pending`, `unsubscribed` ou `bounced`. S'il est laissé vide, il est défini sur `subscribed`.
- **IDs des étiquettes** sont les étiquettes à leur attribuer, séparées par des virgules. Facultatif.
- **IDs des listes** 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à.

- **ID du contact** désigne le contact concerné. Requis. Normalement récupéré à partir d'une étape **Trouver un contact par e-mail** précédente dans l'automatisation.
- **E-mail** est l'e-mail du contact. Requis, car FluentCRM demande l'e-mail à chaque mise à jour.
- **IDs des étiquettes** sont les étiquettes à attacher, séparées par des virgules. Requis.
- **Statut** est facultatif et est défini par défaut sur `subscribed`.

### Supprimer des étiquettes d'un contact

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

### Ajouter un contact aux listes

- **ID de contact**, **E-mail** et **ID de liste** (séparés par des virgules), avec le même **Statut** optionnel.

---

## 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 nécessitant un ID de contact viennent après une étape de recherche.** C'est la structure normale : trouver le contact, puis agir sur l'ID 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 ID, pas des noms,** pour chaque champ d'étiquette et de liste. Un nom dans ce champ ne correspondra tout simplement pas.
- **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 assurément correctes et que la connexion est toujours refusée, c'est le point à vérifier auprès de votre hébergeur.
- **Il n'existe aucun déclencheur qui surveille FluentCRM.** Rien ne l'interroge pour détecter des changements. Pour que FluentCRM démarre 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 **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.
