
# FluentCRM

> **Per chi è pensato?** Per le aziende che gestiscono la propria lista email in FluentCRM sul proprio sito WordPress e desiderano che le conversazioni la alimentino. Se non utilizzi FluentCRM, puoi saltare questa pagina.
>
> Utilizzi un CRM o uno strumento di email marketing diverso? Qualsiasi servizio dotato di API può comunque essere collegato: consulta [Collegare uno strumento non presente nel nostro elenco](connecting-other-tools.md).

FluentCRM è un plugin di CRM e email marketing che risiede all'interno di WordPress: contatti, tag, liste e le campagne che invii. Collegarlo a <span data-t="appName">Your AI Connector</span> fornisce alle tue [automazioni](../automations/automations.md) dei passaggi che scrivono al suo interno, così un nuovo lead di WhatsApp diventa un contatto FluentCRM con il tag corretto, e la sequenza email che hai già creato prende il sopravvento da lì. Niente esportazioni, niente copia e incolla, nessuna attesa fino a venerdì.

Non viene installato nulla sul tuo sito WordPress. Colleghi il tuo sito utilizzando le tue credenziali di accesso e noi richiamiamo l'API che FluentCRM espone già nativamente.

**Disponibilità:** Le automazioni sono disponibili su ogni account. Sono già presenti nella barra laterale e non c'è nulla da abilitare o richiedere.

---

## Cosa ti serve

FluentCRM si appoggia all'API REST di WordPress, quindi richiede esattamente gli stessi dettagli della connessione [WordPress](wordpress.md):

- Il **sito WordPress su cui è in esecuzione FluentCRM**, raggiungibile tramite **https**, con WordPress **5.6 o versioni successive**.
- **Pretty permalinks** attivati (**Impostazioni → Permalink**, qualsiasi opzione diversa da "Semplice"), che è ciò che permette all'indirizzo `/wp-json/` di funzionare.
- Una **password dell'applicazione** per l'utente WordPress con cui l'automazione deve operare: **Utenti → Profilo → Password dell'applicazione → Aggiungi nuova**. WordPress la mostra una sola volta, in blocchi separati da spazi. Copiala includendo gli spazi.

Quell'utente deve avere i permessi per gestire FluentCRM in WordPress. La tua vera password di accesso non viene mai utilizzata e l'eliminazione della password dell'applicazione in un secondo momento revoca esattamente questa connessione.

---

## Collegare FluentCRM

Effettui la connessione dall'interno di un'automazione, la prima volta che utilizzi un passaggio FluentCRM.

1. Apri **Automazioni** nella barra laterale (sotto il gruppo **AI Studio**) e apri o crea un'automazione.
2. Aggiungi un passaggio e cerca **FluentCRM** nel selettore dei passaggi.
3. Scegli l'azione desiderata. Il passaggio ti chiederà prima di effettuare la connessione.
4. Compila i tre campi:
   - **URL del sito** è l'indirizzo del sito WordPress su cui è in esecuzione FluentCRM, che inizia con `https://`.
   - **Nome utente WordPress** è il nome utente con cui l'utente accede, non la sua email.
   - **Password dell'applicazione** è la password che hai creato in precedenza, incollata con i suoi spazi.
5. Fai clic su connetti.

Verifichiamo i dettagli con il tuo sito prima di salvare qualsiasi cosa, leggendo un contatto da FluentCRM. Dettagli errati, o un sito in cui `/wp-json/` non viene risolto, vengono rifiutati a schermo con la relativa motivazione. La tua password dell'applicazione viene archiviata crittografata e non ti viene mai mostrata di nuovo.

---

## Tag e liste vengono forniti come ID

Questa è l'unica cosa da sapere prima di creare qualsiasi cosa. Ogni campo che accetta tag o elenchi richiede i relativi **ID numerici**, separati da virgole, non i loro nomi. `1, 2` funziona; `Newsletter, VIP` no, e l'editor lo segnala sotto il campo. Un ID che risulta errato solo all'esecuzione dell'automazione (ad esempio uno proveniente da un passaggio precedente) interrompe il passaggio con un errore, invece di essere eseguito silenziosamente senza quel tag.

Troverai i numeri in FluentCRM: apri **Tag** o **Liste** nel menu di FluentCRM e l'ID di ogni riga si trova nella barra degli indirizzi quando la apri. Segnati i pochi che intendi utilizzare una volta e il gioco è fatto.

---

## Le azioni

Ogni azione è un passaggio nel canvas dell'automazione e ogni campo accetta dati dai passaggi precedenti con i consueti pulsanti di inserimento dati.

### Crea o aggiorna contatto

Aggiunge un contatto o aggiorna quello che possiede già questa email. L'invio della stessa email due volte aggiorna il contatto invece di fallire, quindi puoi eseguire questa operazione su ogni nuovo lead senza dover controllare prima.

- **Email** è l'indirizzo email del contatto. Obbligatorio. Solitamente l'email del contatto proveniente dal trigger.
- **Nome**, **Cognome** e **Telefono** sono facoltativi.
- **Stato** viene scelto da un elenco: Subscribed (Iscritto), Pending (In attesa), Unsubscribed (Disiscritto) o Transactional (Transazionale). Obbligatorio, perché FluentCRM ne richiede uno e si applica anche ai contatti esistenti: **Subscribed (Iscritto) re-iscrive qualcuno che si era disiscritto**, quindi sceglilo solo quando la persona ha chiesto di unirsi. **Pending (In attesa)** invia l'email di double opt-in di FluentCRM.
- **ID tag** sono i tag da assegnare, separati da virgole. Facoltativo.
- **ID elenco** sono gli elenchi a cui aggiungerli, separati da virgole. Facoltativo.

### Trova contatto tramite email

Cerca un contatto tramite indirizzo email e restituisce il suo ID, i suoi tag e le sue liste.

- **Email** è l'indirizzo da cercare. Obbligatorio.

Il suo output è ciò di cui hanno bisogno i passaggi successivi, poiché operano su un ID contatto.

### Aggiungi tag al contatto

Associa uno o più tag a un contatto già esistente.

- **ID contatto** indica quale contatto. Obbligatorio. Normalmente preso da un passaggio **Trova contatto tramite email** precedente nell'automazione.
- **Email** è l'email del contatto. Obbligatorio, perché FluentCRM richiede l'email a ogni aggiornamento.
- **ID tag** sono i tag da allegare, separati da virgole. Obbligatorio.
- **Cambia stato** è facoltativo. Se lasciato su **Mantieni stato attuale**, lo stato del contatto non viene toccato, quindi aggiungere un tag a qualcuno che si è disiscritto non lo iscrive di nuovo.

### Rimuovi tag dal contatto

Gli stessi campi, rimuovendo i tag invece di aggiungerli.

### Aggiungi contatto alle liste

- **ID contatto**, **Email** e **ID elenco** (separati da virgole), con la stessa opzione facoltativa **Cambia stato**.

---

## Un esempio di automazione

**Ogni nuovo lead di WhatsApp finisce in FluentCRM, etichettato in base alla sua provenienza.**

1. **Trigger:** messaggio in arrivo da un nuovo contatto.
2. **Crea o aggiorna contatto**, con l'email, il nome e il telefono del contatto provenienti dal trigger, e l'**ID elenco** della tua lista principale.
3. **Aggiungi tag al contatto** non è necessario in questo caso, perché il passaggio 2 può già includere gli **ID tag**. Usalo quando il tag viene aggiunto più avanti nella conversazione.

E la versione in cui il tag viene aggiunto in seguito, che è quella più utile:

1. **Trigger:** un tag viene aggiunto al contatto, ad esempio `asked about pricing`, dal tuo agente AI.
2. **Trova contatto tramite email**, con l'email del contatto.
3. **Aggiungi tag al contatto**, utilizzando l'id del passaggio 2, la stessa email e l'id del tag di FluentCRM per la tua sequenza di prezzi.

L'automazione di FluentCRM invia quindi la sequenza di email che quel tag avvia. La conversazione avviene su WhatsApp, il nutrimento avviene via email e nessuno sposta manualmente una riga tra le due.

---

## Buono a sapersi

- **I passaggi che richiedono un ID contatto vengono dopo un passaggio di ricerca.** Questa è la struttura normale: trova il contatto, quindi agisci sull'ID restituito dal passaggio di ricerca.
- **Gli output viaggiano in avanti.** Tutto ciò che un'azione restituisce è disponibile per i passaggi successivi come variabili.
- **ID, non nomi,** per ogni campo tag ed elenco. Un nome in quel campo viene segnalato nell'editor e interrompe il passaggio quando viene eseguito.
- **Alcuni host rimuovono l'intestazione Authorization** prima che WordPress la veda, il che fa sembrare errata una password dell'applicazione corretta. Se i tuoi dettagli sono sicuramente corretti e la connessione viene comunque rifiutata, questa è la cosa da chiedere al tuo host.
- **Non esiste un trigger che monitora FluentCRM.** Nulla esegue il polling per rilevare modifiche. Per far sì che FluentCRM avvii un'automazione, aggiungi un trigger **Webhook** all'automazione e punta un webhook in uscita di FluentCRM all'indirizzo che ti viene fornito.
- **Tutto ciò che non è nell'elenco sopra** può comunque essere eseguito con il passaggio **Richiesta HTTP**.

---

## Prossimi passi

- [Automazioni](../automations/automations.md): trigger, passaggi, condizioni e come viene assemblato un flusso di lavoro.
- [WordPress](wordpress.md): post e utenti sullo stesso sito, con gli stessi dettagli di connessione.
- [MemberPress](memberpress.md): abbonamenti e pagamenti sul tuo sito WordPress.
- [Connettere uno strumento non elencato](connecting-other-tools.md): funzioni personalizzate, API e webhook.
