Documentazione: ClientDesk
ClientDesk è un plugin CRM per Redmine. Gestisce clienti, trattative e prodotti all’interno di un progetto, collega le richieste ai contatti e gestisce la posta elettronica senza un CRM separato.
L’interfaccia CRM si apre all’interno della pagina di Redmine. Un cliente, una trattativa o un prodotto aperti restano nell’URL della pagina, così è possibile aggiornare il link o condividerlo con un collega.
Funzionalità principali
Cosa viene aggiunto a Redmine
- Modulo di progetto «ClientDesk» e una voce di menu del progetto ClientDesk.
- Menu superiore e menu applicazione. La voce ClientDesk può essere attivata separatamente. Apre il CRM su tutti i progetti accessibili.
- Menu di amministrazione. La voce ClientDesk apre le impostazioni del plugin.
- Issue. Campo contatto, scheda cliente nella barra laterale, risposta al cliente, modelli, valutazione e suggerimento IA.
- Elenco Issues. Colonne e filtri aggiuntivi per contatto, azienda, canale, tempo di reazione, tempo di risposta, tempo di risoluzione e valutazione.
- Ricerca Redmine. La casella Clientdesk cerca clienti, trattative e prodotti.
- Campi personalizzati per clienti, trattative e prodotti.
Clienti, trattative e prodotti
- Clienti — contatti e aziende. Un contatto ha azienda, email, telefono, indirizzo, paese, lingua, assegnatario e note.
- Trattative — stato, importo, valuta, data di scadenza, nota e righe d’ordine dal catalogo.
- Prodotti — beni, servizio o abbonamento, con prezzi in valute diverse.
- Abbonamenti — righe d’ordine di una trattativa con un periodo di 1 mese o 1 anno. La scheda mostra quelli attivi e quelli scaduti.
- Dashboard — riepilogo di clienti, trattative e prodotti. I blocchi dipendono dai permessi dell’utente.
- Registro delle modifiche per un cliente, una trattativa e un prodotto.
Email, risposte e valutazione
- IMAP — caselle in arrivo del progetto. Un’email crea un Issue o un commento su un Issue già aperto.
- SMTP — profili in uscita. Il progetto seleziona un profilo per le risposte al cliente.
- Modelli di risposta con segnaposto per il nome del cliente, il numero dell’Issue e altri campi.
- Valutazione della richiesta. Quando un Issue viene chiuso, l’autore può ricevere un’email con un link. Il link si apre senza accedere a Redmine.
- Chiusura automatica delle richieste dopo un numero impostato di ore, con un’email al cliente.
- IA. Nella pagina dell’Issue è possibile generare una risposta a partire da un breve prompt.
- Importazione da RedmineUp — contatti, aziende, trattative e prodotti. Collegare gli Issues ai nuovi contatti è un’azione separata.
A chi è destinato
- Supporto — richieste via email, risposte ai clienti e valutazioni di qualità.
- Vendite — clienti, trattative, catalogo e abbonamenti.
- Amministratore Redmine — stati delle trattative, email, modelli e importazione.
Compatibilità
Redmine: 6.0 - 7.0
Database: MySQL, PostgreSQL, SQLite
Il servizio web REST deve essere abilitato nelle impostazioni di Redmine. Altrimenti la pagina delle impostazioni del plugin mostra l’avviso «Abilita il servizio web REST».
Installazione e aggiornamento
-
Rimuovere la vecchia versione del plugin se è installata.
cd redmine/plugins rm -r clientdesk -
Copiare la cartella
clientdeskinredmine/plugins/. -
Eseguire le migrazioni dalla root di Redmine.
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk -
Arrestare e avviare Redmine. In alcune configurazioni, ad esempio Docker, è necessario un arresto e un avvio completi, non un riavvio.
Disinstallazione
-
Dalla root di Redmine eseguire:
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk VERSION=0 -
Rimuovere la cartella del plugin.
cd redmine/plugins rm -r clientdesk -
Arrestare e avviare Redmine.
Configurazione
- Abilitare il servizio web REST nelle impostazioni di Redmine.
- Assegnare i permessi in Amministrazione → Ruoli e permessi, sezione ClientDesk.
- Abilitare il modulo ClientDesk in Progetto → Impostazioni → Moduli.
- Aprire le impostazioni del plugin e creare gli stati delle trattative.
- Se sono necessarie le risposte ai clienti, creare un profilo SMTP e selezionarlo nelle impostazioni del progetto.
- Se è necessaria la posta in arrivo, aggiungere una casella IMAP e collegarla al progetto.
Amministrazione
Le impostazioni del plugin sono disponibili per un amministratore Redmine in due modi.
- Amministrazione → Plugin → ClientDesk CRM plugin → Configura.
- Amministrazione → ClientDesk.
Scheda «Generale»
- Mostra nel menu superiore — voce ClientDesk nel menu superiore di Redmine.
- Mostra nel menu applicazione — voce ClientDesk nel menu applicazione.
- Formato del nome del contatto — «Nome Cognome», «Nome Secondo Cognome», «Cognome Nome» o «Cognome Nome Secondo».
- Paese predefinito per i nuovi contatti.
- Lingua predefinita per i nuovi contatti.
- Valute disponibili — l’elenco usato per la valuta della trattativa e i prezzi dei prodotti.
- Chiudi automaticamente le richieste dopo — numero di ore. La chiusura è eseguita da un job in background; vedi sotto.
- Invia un’email automatica al cliente — oggetto e corpo dell’email di chiusura. Entrambi i campi sono obbligatori quando l’opzione è attiva.
Nell’oggetto e nel corpo dell’email di chiusura è possibile inserire: %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{ticket.status}.
Scheda «Posta»
Elenco delle caselle IMAP. Una casella è collegata a un progetto.
Per una casella si impostano host, porta, nome utente, password, metodo di autenticazione, sicurezza della connessione e verifica SSL. Poi si impostano la cartella IMAP, la cartella dei messaggi elaborati correttamente e la cartella dei messaggi non riusciti.
Regole di creazione degli Issues:
- tracker e stato del nuovo Issue;
- Crea contatti — un nuovo contatto per un mittente sconosciuto;
- Usa il numero Issue dall’oggetto — se l’oggetto contiene il numero di un Issue aperto, l’email diventa un commento anziché un nuovo Issue;
- Lista nera mittenti — un pattern per riga; sono consentite le espressioni regolari.
Il pulsante «Verifica connessione» mostra la cartella, il numero di messaggi e il numero di nuovi messaggi.
Scheda «SMTP»
Profili in uscita: host, porta, account, password, sicurezza della connessione e indirizzo del mittente. Un profilo può essere contrassegnato come predefinito. In un progetto è possibile selezionare questo profilo, un altro profilo o le impostazioni email condivise di Redmine.
Scheda «Stati trattative»
Una directory condivisa per tutti i progetti. Uno stato ha nome, colore, flag attivo e tipo: Aperta, Vinta o Persa. L’ordine si modifica trascinando le righe. Uno stato già usato su una trattativa non può essere eliminato.
Scheda «Modelli di risposta»
Un modello è un nome e un testo. Nel testo possono essere inseriti i campi del cliente, dell’Issue e dell’autore della risposta:
%{client.name}, %{client.first_name}, %{client.last_name}, %{client.email}, %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.tracker}, %{ticket.status}, %{response.author}, %{response.author.first_name}, %{response.author.last_name}.
Nella pagina dell’Issue il modello si seleziona dall’elenco «Inserisci modello». Sono richiesti il permesso di modifica degli Issues e il permesso di visualizzazione dei clienti.
Scheda «Comunicazioni»
Un registro dei messaggi in entrata e in uscita. Mostra quali email hanno già creato un Issue o un commento, così la stessa email non viene elaborata due volte. Questa scheda non ha un pulsante di salvataggio delle impostazioni.
Scheda «IA»
Indirizzo del servizio chiamato dal plugin per generare una risposta. Il comportamento nella pagina dell’Issue si abilita nelle impostazioni del progetto.
Scheda «Valutazione della richiesta»
Un modello email condiviso che chiede di valutare la richiesta. La casella «Alla chiusura di un Issue, chiedere all’autore una valutazione» abilita il modello. Oggetto e corpo sono obbligatori.
Sotto c’è una tabella dei progetti con il modulo ClientDesk. Per ogni progetto scegliere una modalità: Disabilitato, Usa modello admin o Modello di progetto. La modalità modello admin è disponibile quando il modello condiviso è compilato e abilitato.
In questa scheda le variabili del modello usano le parentesi graffe: {%ticket.id%}, {%ticket.subject%}, {%ticket.project%}, {%ticket.author.name%}, {%ticket.author.email%}, {%client.name%}, {%vote.url%}.
Scheda «Importazione»
Tre azioni, solo per amministratori.
- Importa da RedmineUp — crea contatti, trattative e prodotti. Gli Issues non vengono collegati in questo passaggio.
- Collega Issues ai nuovi contatti — prende i collegamenti da helpdesk per i clienti già importati. Un Issue che ha già un contatto ClientDesk viene saltato.
- Elimina tutto — elimina definitivamente contatti, aziende, trattative, prodotti, note e collegamenti degli Issues. Stati delle trattative, caselle e modelli restano.
Se le tabelle RedmineUp mancano nel database, l’importazione lo segnala e non crea nulla.
Ruoli e permessi
Nella sezione ClientDesk:
- Visualizza clienti — elenco e scheda clienti, note, ricerca, campo contatto su un Issue.
- Gestisci clienti — creare, modificare ed eliminare clienti e note; creare un contatto dalla scheda Issue.
- Visualizza trattative — trattative e abbonamenti.
- Gestisci trattative — creare, modificare ed eliminare trattative.
- Visualizza prodotti — catalogo.
- Gestisci prodotti — creare, modificare ed eliminare prodotti.
Il permesso di gestione non include il permesso di visualizzazione. Assegnarli separatamente.
La voce di menu ClientDesk è visibile quando il modulo è abilitato e esiste almeno un permesso di visualizzazione: clienti, trattative o prodotti. Le schede all’interno del CRM vengono mostrate in base ai rispettivi permessi.
Le impostazioni email del progetto vengono modificate da un utente con permesso di modifica del progetto. Per questo non sono richiesti i permessi CRM.
Job in background
Il recupero della posta può essere avviato manualmente dalle impostazioni del progetto. Per la pianificazione, dalla root di Redmine:
bundle exec rake clientdesk:fetch_mail
La chiusura automatica delle richieste viene eseguita solo con questo comando:
bundle exec rake clientdesk:auto_close_issues
Impostazioni del progetto
Progetto → Impostazioni → ClientDesk.
IMAP
Elenco delle caselle in arrivo di questo progetto. Un progetto può avere più caselle. Da qui è possibile anche eseguire «Verifica connessione» e «Recupera posta».
Dopo il recupero, la pagina mostra quante email sono state elaborate, quanti Issues sono stati creati e quanti commenti sono stati aggiunti.
SMTP
Profilo in uscita per le risposte ai clienti. Se non è selezionato alcun profilo, una risposta mostra un avviso: impostare SMTP in Impostazioni → ClientDesk → Posta.
Feedback
Alla chiusura di un Issue, chiedere all’autore una valutazione:
- Disabilitato;
- Usa modello admin;
- Modello di progetto — oggetto e corpo personalizzati. Entrambi i campi sono obbligatori.
Segnaposto del modello di progetto: %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{vote.url}.
Impostazioni IA
- Abilita i suggerimenti IA per le risposte ai clienti e il prompt di sistema.
- Abilita un prompt precompilato per i clienti e il testo di quel prompt.
Utilizzo
Apertura del CRM
Progetto → ClientDesk.
Schede:
- Dashboard — contatori di clienti, trattative e prodotti. Con permesso sulle trattative vengono mostrati anche i totali per valuta e gli abbonamenti.
- Clienti.
- Trattative.
- Prodotti.
L’intestazione del CRM ha la ricerca su clienti, trattative e prodotti nel contesto corrente. Gli elenchi possono essere filtrati e salvati come query.
La voce del menu superiore o del menu applicazione apre lo stesso CRM senza vincolarlo a un solo progetto. Gli elenchi includono i record dei progetti in cui il modulo è abilitato e esiste il permesso di visualizzazione.
Clienti
Filtro dell’elenco: Tutti, Contatti, Aziende.
La scheda cliente mostra i dettagli di contatto, le trattative correlate, gli Issues, le note e i campi personalizzati. Per un contatto è possibile creare un’azienda direttamente nel campo azienda. Una scheda azienda mostra i suoi contatti.
Campi principali del contatto: nome, secondo nome, cognome, email, telefono, mansione, azienda, data di nascita, indirizzo, città, regione, paese, lingua, sito web, partita IVA/codice fiscale, fonte, assegnatario e «Non contattare». Per un’azienda — nome, settore e dimensione dell’azienda.
I file possono essere allegati a un cliente tramite campi personalizzati di tipo «file». Il registro mostra chi ha modificato il record e quando.
Un cliente appartiene a un progetto principale. Può anche essere reso visibile in altri progetti: progetti padre e figlio di quello principale, tutti i progetti, oppure l’elenco «Inoltre disponibile nei progetti». Collegare un Issue o un’email al progetto del cliente non aggiunge di per sé il cliente a quel progetto.
Se durante la creazione di un contatto l’email esiste già, il plugin non crea una seconda scheda. Propone di aprire il contatto esistente, aggiungere il progetto alla visibilità o cambiare il progetto principale. Le azioni disponibili dipendono dai permessi.
«Rimuovi dal progetto» nasconde il cliente nel progetto corrente e lo mantiene in quello principale. L’eliminazione della scheda avviene nel progetto principale. Un cliente collegato a Issues o trattative non può essere eliminato.
Trattative e abbonamenti
Una trattativa è collegata a un cliente e a un progetto. Ha nome, stato, importo, valuta, data di scadenza, nota e righe d’ordine. Una riga d’ordine è un prodotto, quantità, prezzo e numero d’ordine. Il prodotto proviene dal catalogo del progetto selezionato. Il prezzo usa la valuta della trattativa.
Dalla scheda di un cliente è possibile creare una trattativa con il cliente già selezionato. Una trattativa può essere spostata in un altro progetto se esiste il permesso di gestione delle trattative in entrambi i progetti e il cliente è visibile lì.
Un abbonamento è un prodotto di tipo «Abbonamento» con un periodo di 1 mese o 1 anno. La data di inizio viene impostata sulla trattativa; la data di fine è calcolata dal periodo. Se la data di scadenza della trattativa non coincide con le date di fine degli abbonamenti, il plugin propone di sostituire la data di scadenza.
Nella pagina dell’Issue, passando il mouse sul nome del contatto si apre una scheda: nome, email, trattative e abbonamenti. Gli abbonamenti attivi e scaduti sono mostrati separatamente. Se il contatto ha un’azienda, la scheda mostra anche le sue trattative. Le trattative di altri contatti di quell’azienda sono raggruppate sotto «Altre trattative».
Prodotti
Catalogo del progetto. Tipo di prodotto: Beni, Servizio o Abbonamento. Un abbonamento richiede un periodo. Un prodotto ha nome, descrizione, SKU e prezzi. La valuta del prezzo si sceglie da «Valute disponibili».
Un prodotto già usato in una trattativa non può essere eliminato. La scheda prodotto mostra le trattative in cui è usato.
Issues
Se il modulo è abilitato e esiste il permesso «Visualizza clienti»:
- Nel modulo dell’Issue trovare il campo contatto e iniziare a digitare un nome. La ricerca inizia dopo due caratteri.
- Selezionare un contatto e salvare l’Issue.
- Nella pagina dell’Issue il contatto è mostrato in un blocco e nella scheda della barra laterale. È possibile cambiare o svuotare la scheda senza aprire il CRM.
- Con il permesso «Gestisci clienti» è possibile creare un contatto da quella scheda.
Un Issue ha un contatto corrente. La modifica del contatto viene memorizzata nella cronologia della richiesta.
È possibile aggiungere colonne e filtri all’elenco Issues: contatto, azienda del contatto, canale della richiesta, tempo della prima reazione, tempo della prima risposta, tempo di risoluzione, valutazione del cliente, ultimo messaggio e relativa data. Canali: email, telefono, chat, API. Le colonne selezionate sono incluse nell’esportazione dell’elenco Issues.
Risposta al cliente
In un commento su un Issue con contatto c’è «Rispondi al cliente». È possibile impostare A, Cc e Bcc. L’email viene inviata tramite SMTP del progetto. Il registro dell’Issue annota che è stata inviata una risposta. Una risposta del cliente via email arriva come commento ed è contrassegnata come risposta del cliente.
Sopra il campo commento c’è «scrivi una risposta con IA» se i suggerimenti sono abilitati nel progetto. Un breve prompt e i dati dell’Issue vengono inviati al servizio IA; il testo risultante viene inserito nel campo commento.
Valutazione della richiesta
Se le richieste di valutazione sono abilitate nel progetto, quando un Issue viene chiuso l’autore riceve un’email con un link. La pagina di valutazione si apre senza accedere. Valutazioni: Eccellente, Normale, Scarsa. Un commento è facoltativo. Viene memorizzata l’ultima valutazione. È visibile sull’Issue e nella colonna dell’elenco Issues.
Ricerca Redmine
Nella pagina di ricerca e nella ricerca rapida dell’intestazione c’è una casella Clientdesk. Cerca clienti, trattative e prodotti come un unico gruppo. Il contatore Clientdesk (N) conserva solo quei risultati.
In un singolo progetto la casella è mostrata quando il modulo è abilitato e esiste il permesso di visualizzazione. Nella ricerca su più progetti la casella è sempre mostrata, ma i record dei progetti non accessibili non vengono restituiti.
La ricerca copre nome, titolo, email, telefono, mansione, sito web, partita IVA/codice fiscale, nome e nota della trattativa, descrizione del prodotto e campi personalizzati contrassegnati «Ricercabile». Note e allegati non vengono cercati. «Cerca solo nei titoli» mantiene nomi e titoli.
Un link nei risultati apre la scheda nel CRM.
Domande frequenti
Perché manca il menu ClientDesk?
Verificare tre condizioni.
- Il modulo ClientDesk è abilitato nel progetto.
- Il ruolo ha almeno «Visualizza clienti», «Visualizza trattative» o «Visualizza prodotti».
- Per la voce fuori da un progetto, «Mostra nel menu superiore» o «Mostra nel menu applicazione» è abilitato, e lo stesso permesso di visualizzazione esiste in almeno un progetto.
Perché la pagina delle impostazioni dice «Abilita il servizio web REST»?
Il CRM funziona tramite la REST API di Redmine. Abilitare il servizio in Amministrazione → Impostazioni → API.
Posso importare i dati CRM e collegare subito gli Issues?
No. Prima «Importa da RedmineUp», controllare le schede, poi «Collega Issues ai nuovi contatti». Se l’importazione è fallita, «Elimina tutto» cancella i dati importati e non tocca stati, posta o modelli.
Perché un’email non è diventata un nuovo Issue?
Se l’oggetto contiene il numero di un Issue già aperto e «Usa il numero Issue dall’oggetto» è abilitato, l’email viene aggiunta come commento. Un’email dalla lista nera non crea un Issue. Un’email ripetuta è visibile nella scheda «Comunicazioni».
Chi può vedere la valutazione del cliente?
L’autore della richiesta imposta la valutazione tramite il link dell’email. In Redmine è visibile sull’Issue e nella colonna dell’elenco Issues per gli utenti che possono accedere all’Issue.