Your AI Connector Docs

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.

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 à Your AI Connector permet à vos automatisations 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 :

  • 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