Your AI Connector Docs

FluentCRM

Voor wie is dit bedoeld? Bedrijven die hun e-maillijst in FluentCRM op hun eigen WordPress-site bijhouden en willen dat gesprekken deze aanvullen. Als je geen FluentCRM gebruikt, kun je deze pagina overslaan.

Gebruik je een andere CRM of e-mailtool? Alles met een API kan nog steeds worden gekoppeld: zie Een tool koppelen die we niet vermelden.

FluentCRM is een CRM- en e-mailmarketing-plugin die in WordPress draait: contacten, tags, lijsten en de campagnes die je naar hen verstuurt. Door het te koppelen aan Your AI Connector krijgen je automatiseringen stappen die erin schrijven, zodat een nieuwe WhatsApp-lead een FluentCRM-contact wordt met de juiste tag, en de e-mailreeks die je al hebt gebouwd het vanaf daar overneemt. Geen export, geen kopiëren en plakken, niet wachten tot vrijdag.

Er wordt niets op je WordPress-site geïnstalleerd. Je koppelt je eigen site met je eigen inloggegevens, en wij roepen de API aan die FluentCRM al beschikbaar stelt.

Beschikbaarheid: Automatiseringen zijn beschikbaar op elk account. Het staat al in je zijbalk en er hoeft niets te worden ingeschakeld of aangevraagd.

Wat je nodig hebt

FluentCRM maakt gebruik van de WordPress REST API, dus het vereist precies dezelfde gegevens als de WordPress-koppeling:

  • De WordPress-site waarop FluentCRM draait, bereikbaar via https, op WordPress 5.6 of nieuwer.
  • Pretty permalinks ingeschakeld (Instellingen → Permalinks, alles behalve “Standaard”), wat ervoor zorgt dat het /wp-json/-adres werkt.
  • Een applicatiewachtwoord voor de WordPress-gebruiker waarvoor de automatisering moet handelen: Gebruikers → Profiel → Applicatiewachtwoorden → Nieuwe toevoegen. WordPress toont dit één keer, in blokken gescheiden door spaties. Kopieer het met de spaties.

Die gebruiker moet toestemming hebben om FluentCRM in WordPress te beheren. Je echte inlogwachtwoord wordt nooit gebruikt, en het later verwijderen van het applicatiewachtwoord trekt precies deze koppeling in.

FluentCRM koppelen

Je koppelt vanuit een automatisering, de eerste keer dat je een FluentCRM-stap gebruikt.

  1. Open Automatiseringen in de zijbalk (onder de AI Studio-groep) en open of maak een automatisering.
  2. Voeg een stap toe en zoek naar FluentCRM in de stapkiezer.
  3. Kies de gewenste actie. De stap vraagt je eerst om te koppelen.
  4. Vul de drie velden in:
    • Site-URL is het adres van de WordPress-site waarop FluentCRM draait, beginnend met https://.
    • WordPress-gebruikersnaam is de gebruikersnaam waarmee die gebruiker inlogt, niet hun e-mailadres.
    • Applicatiewachtwoord is het wachtwoord dat je hierboven hebt aangemaakt, geplakt inclusief de spaties.
  5. Klik op koppelen.

We controleren de gegevens op je site voordat we iets opslaan door één contact uit FluentCRM uit te lezen. Verkeerde gegevens, of een site waar /wp-json/ niet naar verwijst, worden op het scherm geweigerd met de reden. Je applicatiewachtwoord wordt versleuteld opgeslagen en nooit aan je getoond.

Tags en lijsten worden opgegeven als ID’s

Dit is het enige dat je moet weten voordat je iets bouwt. Elk veld dat tags of lijsten accepteert, vereist hun ID-nummers, gescheiden door komma’s, niet hun namen. 1, 2 werkt; Newsletter, VIP niet, en de editor markeert dit onder het veld. Een ID die pas fout blijkt te zijn wanneer de automatisering wordt uitgevoerd (bijvoorbeeld een ID die uit een eerdere stap kwam), stopt de stap met een foutmelding in plaats van deze stilletjes uit te voeren zonder die tag.

Je vindt de nummers in FluentCRM: open Tags of Lijsten in het FluentCRM-menu, en het ID van elke rij staat in de adresbalk wanneer je het opent. Noteer de paar die je van plan bent te gebruiken, en je bent klaar.

De acties

Elke actie is een stap op het automatiseringscanvas en elk veld accepteert gegevens van eerdere stappen met de gebruikelijke knoppen voor het invoegen van gegevens.

Contact aanmaken of bijwerken

Voegt een contact toe of werkt degene bij die al dit e-mailadres heeft. Het tweemaal verzenden van hetzelfde e-mailadres werkt de gegevens bij in plaats van dat het mislukt, dus u kunt dit uitvoeren voor elke nieuwe lead zonder dit eerst te controleren.

  • Email is het e-mailadres van de contactpersoon. Verplicht. Meestal het e-mailadres van de contactpersoon uit de trigger.
  • Voornaam, Achternaam en Telefoonnummer zijn optioneel.
  • Status wordt gekozen uit een lijst: Subscribed, Pending, Unsubscribed of Transactional. Verplicht, omdat FluentCRM er een nodig heeft, en dit geldt ook voor bestaande contacten: Subscribed abonneert iemand opnieuw die zich had uitgeschreven, dus kies dit alleen wanneer de persoon heeft gevraagd om lid te worden. Pending verstuurt de double opt-in e-mail van FluentCRM.
  • Tag-ID’s zijn tags die aan hen moeten worden toegevoegd, gescheiden door komma’s. Optioneel.
  • Lijst-ID’s zijn lijsten waaraan ze moeten worden toegevoegd, gescheiden door komma’s. Optioneel.

Contact zoeken op e-mailadres

Zoekt een contact op via e-mailadres en retourneert hun ID, hun tags en hun lijsten.

  • E-mail is het adres om op te zoeken. Verplicht.

De uitvoer hiervan is wat de onderstaande stappen nodig hebben, omdat deze werken op basis van een contact-ID.

Tags toevoegen aan contact

Voegt een of meer tags toe aan een contactpersoon die al bestaat.

  • Contact-ID is welke contactpersoon. Verplicht. Normaal gesproken afkomstig van een Find contact by email-stap eerder in de automatisering.
  • Email is het e-mailadres van de contactpersoon. Verplicht, omdat FluentCRM bij elke update om het e-mailadres vraagt.
  • Tag-ID’s zijn de tags die moeten worden toegevoegd, gescheiden door komma’s. Verplicht.
  • Status wijzigen is optioneel. Indien op Keep current status gelaten, wordt de status van de contactpersoon niet aangeraakt, dus iemand taggen die zich heeft uitgeschreven, abonneert hen niet opnieuw.

Tags verwijderen van contact

Dezelfde velden, waarbij tags worden verwijderd in plaats van toegevoegd.

Contact toevoegen aan lijsten

  • Contact-ID, Email en Lijst-ID’s (gescheiden door komma’s), met dezelfde optionele Status wijzigen.

Een voorbeeldautomatisering

Elke nieuwe WhatsApp-lead komt in FluentCRM terecht, voorzien van een label op basis van de herkomst.

  1. Trigger: inkomend bericht van een nieuw contact.
  2. Contact aanmaken of bijwerken, met het e-mailadres, de voornaam en het telefoonnummer van het contact uit de trigger, en het Lijst-ID van je hoofdlijst.
  3. Labels toevoegen aan contact is hier niet nodig, omdat stap 2 de Label-ID’s al kan meenemen. Gebruik dit wanneer het label pas later in het gesprek wordt toegevoegd.

En de versie waarbij het label later wordt toegevoegd, wat de meest nuttige is:

  1. Trigger: een label wordt toegevoegd aan het contact, bijvoorbeeld asked about pricing, door je AI-agent.
  2. Contact zoeken op e-mail, met het e-mailadres van het contact.
  3. Labels toevoegen aan contact, met gebruik van het ID uit stap 2, hetzelfde e-mailadres en het FluentCRM-label-ID voor je prijsreeks.

De eigen automatisering van FluentCRM verstuurt vervolgens de e-mailreeks die dat label start. Het gesprek vindt plaats op WhatsApp, de opvolging gebeurt per e-mail, en niemand hoeft handmatig gegevens tussen beide systemen te verplaatsen.

Goed om te weten

  • Stappen die een contact-ID vereisen, komen na een Find-stap. Dat is de normale vorm: zoek de contactpersoon en voer vervolgens acties uit op het ID dat de zoekstap heeft geretourneerd.
  • Outputs reizen vooruit. Alles wat een actie retourneert, is beschikbaar voor latere stappen als variabelen.
  • ID’s, geen namen, voor elk tag- en lijstveld. Een naam in dat veld wordt gemarkeerd in de editor en stopt de stap wanneer deze wordt uitgevoerd.
  • Sommige hosts verwijderen de Authorization-header voordat WordPress deze ziet, waardoor een correct applicatiewachtwoord onjuist lijkt. Als je gegevens absoluut correct zijn en de verbinding nog steeds wordt geweigerd, is dat het punt om bij je host na te vragen.
  • Er is geen trigger die FluentCRM in de gaten houdt. Niets pollt het op wijzigingen. Om FluentCRM een automatisering te laten starten, voeg je een Webhook-trigger toe aan de automatisering en wijs je een uitgaande FluentCRM-webhook naar het adres dat het je geeft.
  • Alles wat niet op de bovenstaande lijst staat, kan nog steeds worden gedaan met de HTTP request-stap.

Volgende stappen