Documentation : ClientDesk
ClientDesk est un plugin CRM pour Redmine. Il gère les clients, les deals et les produits au sein d’un projet, lie les demandes aux contacts et traite les e-mails sans CRM séparé.
L’interface CRM s’ouvre dans la page Redmine. Un client, un deal ou un produit ouvert est conservé dans l’URL de la page, ce qui permet d’actualiser le lien ou de le partager avec un collègue.
Fonctionnalités clés
Ce qui est ajouté à Redmine
- Module de projet « ClientDesk » et un élément de menu de projet ClientDesk.
- Menu supérieur et menu d’application. L’élément ClientDesk peut être activé séparément. Il ouvre le CRM sur tous les projets accessibles.
- Menu Administration. L’élément ClientDesk ouvre les paramètres du plugin.
- Issue. Champ contact, fiche client dans la barre latérale, réponse au client, modèles, évaluation et suggestion IA.
- Liste des Issues. Colonnes et filtres supplémentaires pour contact, société, canal, temps de réaction, temps de réponse, temps de résolution et évaluation.
- Recherche Redmine. La case Clientdesk recherche les clients, deals et produits.
- Champs personnalisés pour les clients, deals et produits.
Clients, deals et produits
- Clients — contacts et sociétés. Un contact a une société, un e-mail, un téléphone, une adresse, un pays, une langue, un assigné et des notes.
- Deals — statut, montant, devise, date d’échéance, note et lignes du catalogue.
- Produits — bien, service ou abonnement, avec des prix dans différentes devises.
- Abonnements — lignes de deal avec une période de 1 mois ou 1 an. La fiche affiche les actifs et les expirés.
- Dashboard — résumé des clients, deals et produits. Les blocs dépendent des permissions de l’utilisateur.
- Journal des modifications pour un client, un deal et un produit.
E-mail, réponses et évaluation
- IMAP — boîtes de réception de projet. Un e-mail crée une Issue ou un commentaire sur une Issue déjà ouverte.
- SMTP — profils sortants. Le projet sélectionne un profil pour les réponses au client.
- Modèles de réponse avec des espaces réservés pour le nom du client, le numéro d’Issue et d’autres champs.
- Évaluation de la demande. Lorsqu’une Issue est fermée, l’auteur peut recevoir un e-mail avec un lien. Le lien s’ouvre sans se connecter à Redmine.
- Fermeture automatique des demandes après un nombre d’heures défini, avec un e-mail au client.
- IA. Sur la page de l’Issue, vous pouvez générer une réponse à partir d’une courte invite.
- Import depuis RedmineUp — contacts, sociétés, deals et produits. La liaison des Issues aux nouveaux contacts est une action séparée.
Destinataires
- Support — demandes par e-mail, réponses aux clients et évaluations de qualité.
- Ventes — clients, deals, catalogue et abonnements.
- Administrateur Redmine — statuts de deal, e-mail, modèles et import.
Compatibilité
Redmine: 6.0 - 7.0
Bases de données : MySQL, PostgreSQL, SQLite
REST web service doit être activé dans les paramètres Redmine. Sinon, la page des paramètres du plugin affiche l’avertissement « Enable REST web service ».
Installation et mise à jour
-
Supprimez l’ancienne version du plugin si elle est installée.
cd redmine/plugins rm -r clientdesk -
Copiez le dossier
clientdeskdansredmine/plugins/. -
Exécutez les migrations depuis la racine Redmine.
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk -
Arrêtez et démarrez Redmine. Dans certaines installations, par exemple Docker, un arrêt et un démarrage complets sont requis, pas un simple redémarrage.
Désinstallation
-
Depuis la racine Redmine, exécutez :
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk VERSION=0 -
Supprimez le dossier du plugin.
cd redmine/plugins rm -r clientdesk -
Arrêtez et démarrez Redmine.
Configuration
- Activez REST web service dans les paramètres Redmine.
- Accordez les permissions dans Administration → Rôles et permissions, section ClientDesk.
- Activez le module ClientDesk dans Projet → Paramètres → Modules.
- Ouvrez les paramètres du plugin et créez les statuts de deal.
- Si des réponses aux clients sont nécessaires, créez un profil SMTP et sélectionnez-le dans les paramètres du projet.
- Si l’e-mail entrant est nécessaire, ajoutez une boîte IMAP et liez-la au projet.
Administration
Les paramètres du plugin sont accessibles à un administrateur Redmine de deux façons.
- Administration → Plugins → ClientDesk CRM plugin → Configure.
- Administration → ClientDesk.
Onglet General
- Show in top menu — élément ClientDesk dans le menu supérieur Redmine.
- Show in application menu — élément ClientDesk dans le menu d’application.
- Contact name format — « First Last », « First Middle Last », « Last First » ou « Last First Middle ».
- Default country for new contacts.
- Default language for new contacts.
- Available currencies — la liste utilisée pour la devise du deal et les prix des produits.
- Automatically close requests after — nombre d’heures. La fermeture est effectuée par un job d’arrière-plan, voir ci-dessous.
- Send an automatic email to the client — objet et corps de l’e-mail de fermeture. Les deux champs sont requis lorsque l’option est activée.
Vous pouvez insérer dans l’objet et le corps de l’e-mail de fermeture : %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{ticket.status}.
Onglet Mail
Liste des boîtes IMAP. Une boîte est liée à un projet.
Pour une boîte, vous définissez l’hôte, le port, le nom d’utilisateur, le mot de passe, la méthode d’authentification, la sécurité de connexion et la vérification SSL. Ensuite, vous définissez le dossier IMAP, le dossier des messages traités avec succès et le dossier des messages en échec.
Règles de création d’Issue :
- tracker et statut de la nouvelle Issue ;
- Create contacts — un nouveau contact pour un expéditeur inconnu ;
- Use issue number from the subject — si l’objet contient un numéro d’Issue ouverte, l’e-mail devient un commentaire au lieu d’une nouvelle Issue ;
- Sender blacklist — un motif par ligne ; les expressions régulières sont autorisées.
Le bouton « Test connection » affiche le dossier, le nombre de messages et le nombre de nouveaux messages.
Onglet SMTP
Profils sortants : hôte, port, compte, mot de passe, sécurité de connexion et adresse d’expéditeur. Un profil peut être marqué par défaut. Dans un projet, vous pouvez sélectionner ce profil, un autre profil ou les paramètres d’e-mail partagés de Redmine.
Onglet Deal statuses
Un répertoire partagé pour tous les projets. Un statut a un nom, une couleur, un indicateur actif et un type : Open, Won ou Lost. L’ordre se change en faisant glisser les lignes. Un statut déjà utilisé sur un deal ne peut pas être supprimé.
Onglet Reply templates
Un modèle est un nom et un texte. Les champs client, Issue et auteur de la réponse peuvent être insérés dans le texte :
%{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}.
Sur la page de l’Issue, le modèle est sélectionné dans la liste « Insert template ». Cela nécessite la permission de modifier les Issues et la permission de voir les clients.
Onglet Communications
Un journal des messages entrants et sortants. Il montre quels e-mails ont déjà créé une Issue ou un commentaire afin que le même e-mail ne soit pas traité deux fois. Cet onglet n’a pas de bouton d’enregistrement des paramètres.
Onglet AI
Adresse du service que le plugin appelle pour générer une réponse. Le comportement sur la page de l’Issue est activé dans les paramètres du projet.
Onglet Request rating
Un modèle d’e-mail partagé demandant d’évaluer la demande. La case « When closing an issue, ask the author for a rating » active le modèle. L’objet et le corps sont requis.
En dessous se trouve un tableau des projets avec le module ClientDesk. Pour chaque projet, choisissez un mode : Disabled, Use admin template ou Project template. Le mode modèle admin est disponible lorsque le modèle partagé est renseigné et activé.
Sur cet onglet, les variables de modèle utilisent des accolades : {%ticket.id%}, {%ticket.subject%}, {%ticket.project%}, {%ticket.author.name%}, {%ticket.author.email%}, {%client.name%}, {%vote.url%}.
Onglet Import
Trois actions, réservées aux administrateurs.
- Import from RedmineUp — crée des contacts, deals et produits. Les Issues ne sont pas liées à cette étape.
- Link issues to new contacts — reprend les liens depuis helpdesk pour les clients déjà importés. Une Issue qui a déjà un contact ClientDesk est ignorée.
- Delete all — supprime définitivement les contacts, sociétés, deals, produits, notes et liens d’Issue. Les statuts de deal, boîtes mail et modèles restent.
Si les tables RedmineUp sont absentes de la base de données, l’import le signale et ne crée rien.
Rôles et permissions
Dans la section ClientDesk :
- View clients — liste et fiche client, notes, recherche, champ contact sur une Issue.
- Manage clients — créer, modifier et supprimer des clients et des notes ; créer un contact depuis la fiche Issue.
- View deals — deals et abonnements.
- Manage deals — créer, modifier et supprimer des deals.
- View products — catalogue.
- Manage products — créer, modifier et supprimer des produits.
La permission Manage n’inclut pas la permission View. Accordez-les séparément.
L’élément de menu ClientDesk est visible lorsque le module est activé et qu’il existe au moins une permission View : clients, deals ou produits. Les onglets dans le CRM s’affichent selon leurs permissions.
Les paramètres d’e-mail du projet sont modifiés par un utilisateur ayant la permission de modifier le projet. Les permissions CRM ne sont pas requises pour cela.
Jobs d’arrière-plan
La récupération du courrier peut être démarrée manuellement depuis les paramètres du projet. Pour la planification, depuis la racine Redmine :
bundle exec rake clientdesk:fetch_mail
La fermeture automatique des demandes ne s’exécute qu’avec cette commande :
bundle exec rake clientdesk:auto_close_issues
Paramètres du projet
Projet → Paramètres → ClientDesk.
IMAP
Liste des boîtes entrantes pour ce projet. Un projet peut avoir plusieurs boîtes. Depuis ici, vous pouvez aussi exécuter « Test connection » et « Fetch mail ».
Après la récupération, la page indique combien d’e-mails ont été traités, combien d’Issues ont été créées et combien de commentaires ont été ajoutés.
SMTP
Profil sortant pour les réponses aux clients. Si aucun profil n’est sélectionné, une réponse affiche un avertissement : définir SMTP dans Paramètres → ClientDesk → Mail.
Feedback
When closing an issue, ask the author for a rating :
- Disabled ;
- Use admin template ;
- Project template — objet et corps personnalisés. Les deux champs sont requis.
Espaces réservés du modèle de projet : %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{vote.url}.
Paramètres AI
- Enable AI suggestions for client replies et le prompt système.
- Enable a prefilled prompt for clients et le texte de ce prompt.
Utilisation
Ouvrir le CRM
Projet → ClientDesk.
Onglets :
- Dashboard — compteurs de clients, deals et produits. Avec la permission deals, les totaux par devise et les abonnements sont aussi affichés.
- Clients.
- Deals.
- Products.
L’en-tête CRM propose une recherche sur les clients, deals et produits dans le contexte actuel. Les listes peuvent être filtrées et enregistrées comme requête.
L’élément du menu supérieur ou du menu d’application ouvre le même CRM sans le lier à un projet. Les listes incluent les enregistrements des projets où le module est activé et où une permission View existe.
Clients
Filtre de liste : All, Contacts, Companies.
La fiche client affiche les coordonnées, les deals liés, les Issues, les notes et les champs personnalisés. Pour un contact, vous pouvez créer une société directement dans le champ société. Une fiche société affiche ses contacts.
Principaux champs contact : prénom, deuxième prénom, nom, e-mail, téléphone, titre du poste, société, date de naissance, adresse, ville, région, pays, langue, site web, identifiant fiscal, source, assigné et « Do not contact ». Pour une société — nom, secteur et taille de l’entreprise.
Des fichiers peuvent être joints à un client via des champs personnalisés de type « file ». Le journal montre qui a modifié l’enregistrement et quand.
Un client appartient à un projet principal. Il peut aussi être rendu visible dans d’autres projets : projets parents et enfants du projet principal, tous les projets, ou la liste « Additionally available in projects ». Lier une Issue ou un e-mail au projet du client n’ajoute pas automatiquement le client à ce projet.
Si un e-mail existe déjà lors de la création d’un contact, le plugin ne crée pas une seconde fiche. Il propose d’ouvrir le contact existant, d’ajouter le projet à la visibilité, ou de changer le projet principal. Les actions disponibles dépendent des permissions.
« Remove from project » masque le client dans le projet actuel et le conserve dans le projet principal. La suppression de la fiche se fait dans le projet principal. Un client lié à des Issues ou des deals ne peut pas être supprimé.
Deals et abonnements
Un deal est lié à un client et à un projet. Il a un nom, un statut, un montant, une devise, une date d’échéance, une note et des lignes. Une ligne est un produit, une quantité, un prix et un numéro d’ordre. Le produit provient du catalogue du projet sélectionné. Le prix utilise la devise du deal.
Depuis une fiche client, vous pouvez créer un deal avec le client déjà sélectionné. Un deal peut être déplacé vers un autre projet si la permission Manage deals existe dans les deux projets et que le client y est visible.
Un abonnement est un produit de type « Subscription » avec une période de 1 month ou 1 year. La date de début est définie sur le deal ; la date de fin est calculée à partir de la période. Si la date d’échéance du deal ne correspond pas aux dates de fin d’abonnement, le plugin propose de remplacer la date d’échéance.
Sur la page de l’Issue, le survol du nom du contact ouvre une fiche : nom, e-mail, deals et abonnements. Les abonnements actifs et expirés sont affichés séparément. Si le contact a une société, la fiche affiche aussi ses deals. Les deals des autres contacts de cette société sont regroupés sous « Other deals ».
Produits
Catalogue du projet. Type de produit : Goods, Service ou Subscription. Un abonnement nécessite une période. Un produit a un nom, une description, un SKU et des prix. La devise du prix est choisie parmi « Available currencies ».
Un produit déjà utilisé dans un deal ne peut pas être supprimé. La fiche produit affiche les deals où il est utilisé.
Issues
Si le module est activé et que la permission « View clients » existe :
- Dans le formulaire de l’Issue, trouvez le champ contact et commencez à saisir un nom. La recherche démarre après deux caractères.
- Sélectionnez un contact et enregistrez l’Issue.
- Sur la page de l’Issue, le contact est affiché dans un bloc et dans la fiche de la barre latérale. Vous pouvez modifier ou vider la fiche sans ouvrir le CRM.
- Avec la permission « Manage clients », vous pouvez créer un contact depuis cette fiche.
Une Issue a un contact courant. Le changement de contact est enregistré dans l’historique de la demande.
Vous pouvez ajouter des colonnes et des filtres à la liste des Issues : contact, société du contact, canal de demande, temps de première réaction, temps de première réponse, temps de résolution, évaluation client, dernier message et sa date. Canaux : email, phone, chat, API. Les colonnes sélectionnées sont incluses dans l’export de la liste des Issues.
Réponse au client
Dans un commentaire sur une Issue avec contact, il y a « Reply to client ». Vous pouvez définir À, Cc et Cci. L’e-mail est envoyé via le SMTP du projet. Le journal de l’Issue note qu’une réponse a été envoyée. Une réponse client par e-mail arrive comme commentaire et est marquée comme réponse client.
Au-dessus du champ commentaire se trouve « write a reply with AI » si les suggestions sont activées dans le projet. Une courte invite et les données de l’Issue sont envoyées au service IA ; le texte résultant est placé dans le champ commentaire.
Évaluation de la demande
Si les demandes d’évaluation sont activées dans le projet, lorsque une Issue est fermée l’auteur reçoit un e-mail avec un lien. La page d’évaluation s’ouvre sans connexion. Évaluations : Excellent, Normal, Poor. Un commentaire est optionnel. La dernière évaluation est enregistrée. Elle est visible sur l’Issue et dans la colonne de la liste des Issues.
Recherche Redmine
Sur la page de recherche et dans la recherche rapide de l’en-tête, il y a une case Clientdesk. Elle recherche les clients, deals et produits comme un seul groupe. Le compteur Clientdesk (N) ne conserve que ces résultats.
Dans un seul projet, la case est affichée lorsque le module est activé et qu’une permission View existe. Lors d’une recherche sur plusieurs projets, la case est toujours affichée, mais les enregistrements des projets inaccessibles ne sont pas renvoyés.
La recherche couvre le nom, le titre, l’e-mail, le téléphone, le titre du poste, le site web, l’identifiant fiscal, le nom et la note du deal, la description du produit, et les champs personnalisés marqués « Searchable ». Les notes et les pièces jointes ne sont pas recherchées. « Search titles only » ne conserve que les noms et titres.
Un lien de résultat ouvre la fiche dans le CRM.
Foire aux questions
Pourquoi le menu ClientDesk est-il absent ?
Vérifiez trois conditions.
- Le module ClientDesk est activé dans le projet.
- Le rôle a au moins « View clients », « View deals » ou « View products ».
- Pour l’élément hors projet, « Show in top menu » ou « Show in application menu » est activé, et la même permission View existe dans au moins un projet.
Pourquoi la page des paramètres indique-t-elle « Enable REST web service » ?
Le CRM fonctionne via l’API REST Redmine. Activez le service dans Administration → Paramètres → API.
Puis-je importer les données CRM et lier les Issues immédiatement ?
Non. D’abord « Import from RedmineUp », examinez les fiches, puis « Link issues to new contacts ». Si l’import a échoué, « Delete all » efface les données importées et ne touche pas aux statuts, au mail ni aux modèles.
Pourquoi un e-mail n’est-il pas devenu une nouvelle Issue ?
Si l’objet contient un numéro d’Issue déjà ouverte et que « Use issue number from the subject » est activé, l’e-mail est ajouté comme commentaire. Un e-mail de la liste noire ne crée pas d’Issue. Un e-mail répété est visible dans l’onglet « Communications ».
Qui peut voir l’évaluation du client ?
L’auteur de la demande définit l’évaluation via le lien e-mail. Dans Redmine, elle est visible sur l’Issue et dans la colonne de la liste des Issues pour les utilisateurs qui peuvent accéder à l’Issue.