logo

RedmineKanban

Login
Zuletzt aktualisiert: 18.11.2026

Dokumentation: ClientDesk

ClientDesk ist ein CRM-Plugin für Redmine. Es verwaltet Clients, Deals und Produkte innerhalb eines Projekts, verknüpft Anfragen mit Kontakten und verarbeitet E-Mails ohne ein separates CRM.

Die CRM-Oberfläche öffnet sich innerhalb der Redmine-Seite. Ein geöffneter Client, Deal oder Produkt bleibt in der Seiten-URL erhalten, sodass Sie den Link aktualisieren oder mit einem Kollegen teilen können.


Hauptfunktionen

Was zu Redmine hinzugefügt wird

  • Projektmodul „ClientDesk“ und ein Projektmenüpunkt ClientDesk.
  • Top-Menü und Anwendungsmenü. Der ClientDesk-Eintrag kann separat aktiviert werden. Er öffnet das CRM über alle zugänglichen Projekte hinweg.
  • Administrationsmenü. Der Eintrag ClientDesk öffnet die Plugin-Einstellungen.
  • Issue. Kontaktfeld, Client-Karte in der Seitenleiste, Antwort an den Client, Vorlagen, Bewertung und KI-Vorschlag.
  • Issue-Liste. Zusätzliche Spalten und Filter für Kontakt, Firma, Kanal, Reaktionszeit, Antwortzeit, Lösungszeit und Bewertung.
  • Redmine-Suche. Das Kontrollkästchen Clientdesk durchsucht Clients, Deals und Produkte.
  • Benutzerdefinierte Felder für Clients, Deals und Produkte.

Clients, Deals und Produkte

  • Clients — Kontakte und Firmen. Ein Kontakt hat Firma, E-Mail, Telefon, Adresse, Land, Sprache, Bearbeiter und Notizen.
  • Deals — Status, Betrag, Währung, Fälligkeitsdatum, Notiz und Positionen aus dem Katalog.
  • Produkte — Ware, Dienstleistung oder Abonnement, mit Preisen in verschiedenen Währungen.
  • Abonnements — Deal-Positionen mit einer Laufzeit von 1 Monat oder 1 Jahr. Die Karte zeigt aktive und abgelaufene.
  • Dashboard — Übersicht über Clients, Deals und Produkte. Die Blöcke hängen von den Benutzerberechtigungen ab.
  • Änderungsjournal für Client, Deal und Produkt.

E-Mail, Antworten und Bewertung

  • IMAP — Projekteingänge. Eine E-Mail erstellt ein Issue oder einen Kommentar zu einem bereits offenen Issue.
  • SMTP — ausgehende Profile. Das Projekt wählt ein Profil für Antworten an den Client.
  • Antwortvorlagen mit Platzhaltern für den Client-Namen, die Issue-Nummer und andere Felder.
  • Anfragebewertung. Wenn ein Issue geschlossen wird, kann der Autor eine E-Mail mit einem Link erhalten. Der Link öffnet sich ohne Anmeldung in Redmine.
  • Automatisches Schließen von Anfragen nach einer festgelegten Anzahl von Stunden, mit einer E-Mail an den Client.
  • KI. Auf der Issue-Seite können Sie aus einer kurzen Eingabe eine Antwort generieren.
  • Import von RedmineUp — Kontakte, Firmen, Deals und Produkte. Die Verknüpfung von Issues mit neuen Kontakten ist eine separate Aktion.

Für wen es gedacht ist

  • Support — E-Mail-Anfragen, Antworten an Clients und Qualitätsbewertungen.
  • Vertrieb — Clients, Deals, Katalog und Abonnements.
  • Redmine-Administrator — Deal-Statuswerte, E-Mail, Vorlagen und Import.

Kompatibilität

Redmine: 6.0 - 7.0

Datenbanken: MySQL, PostgreSQL, SQLite

REST web service muss in den Redmine-Einstellungen aktiviert sein. Andernfalls zeigt die Plugin-Einstellungsseite die Warnung „Enable REST web service“.


Installation und Aktualisierung

  1. Entfernen Sie die alte Plugin-Version, falls sie installiert ist.

    cd redmine/plugins
    rm -r clientdesk
    
  2. Kopieren Sie den Ordner clientdesk nach redmine/plugins/.

  3. Führen Sie die Migrationen vom Redmine-Stammverzeichnis aus.

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk
    
  4. Stoppen und starten Sie Redmine. In manchen Umgebungen, zum Beispiel Docker, ist ein vollständiges Stoppen und Starten erforderlich, kein Neustart.


Deinstallation

  1. Führen Sie vom Redmine-Stammverzeichnis aus:

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk VERSION=0
    
  2. Entfernen Sie den Plugin-Ordner.

    cd redmine/plugins
    rm -r clientdesk
    
  3. Stoppen und starten Sie Redmine.


Einrichtung

  1. Aktivieren Sie REST web service in den Redmine-Einstellungen.
  2. Vergeben Sie Berechtigungen unter Administration → Rollen und Rechte, Abschnitt ClientDesk.
  3. Aktivieren Sie das Modul ClientDesk unter Projekt → Einstellungen → Module.
  4. Öffnen Sie die Plugin-Einstellungen und erstellen Sie Deal-Statuswerte.
  5. Wenn Client-Antworten benötigt werden, erstellen Sie ein SMTP-Profil und wählen Sie es in den Projekteinstellungen aus.
  6. Wenn eingehende E-Mails benötigt werden, fügen Sie ein IMAP-Postfach hinzu und verknüpfen Sie es mit dem Projekt.

Administration

Die Plugin-Einstellungen stehen einem Redmine-Administrator auf zwei Wegen zur Verfügung.

  1. Administration → Plugins → ClientDesk CRM plugin → Configure.
  2. Administration → ClientDesk.

Registerkarte Allgemein

  • Show in top menu — ClientDesk-Eintrag im Redmine-Top-Menü.
  • Show in application menu — ClientDesk-Eintrag im Anwendungsmenü.
  • Contact name format — „First Last“, „First Middle Last“, „Last First“ oder „Last First Middle“.
  • Default country for new contacts.
  • Default language for new contacts.
  • Available currencies — die Liste für Deal-Währung und Produktpreise.
  • Automatically close requests after — Anzahl der Stunden. Das Schließen erfolgt durch einen Hintergrundjob, siehe unten.
  • Send an automatic email to the client — Betreff und Text der Schließungs-E-Mail. Beide Felder sind erforderlich, wenn die Option aktiviert ist.

In Betreff und Text der Schließungs-E-Mail können Sie einfügen: %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{ticket.status}.

Registerkarte Mail

Liste der IMAP-Postfächer. Ein Postfach ist mit einem Projekt verknüpft.

Für ein Postfach legen Sie Host, Port, Benutzername, Passwort, Authentifizierungsmethode, Verbindungssicherheit und SSL-Prüfung fest. Anschließend legen Sie den IMAP-Ordner, den Ordner für erfolgreich verarbeitete Nachrichten und den Ordner für fehlgeschlagene Nachrichten fest.

Regeln zur Issue-Erstellung:

  • Tracker und Status des neuen Issues;
  • Create contacts — ein neuer Kontakt für einen unbekannten Absender;
  • Use issue number from the subject — wenn der Betreff eine offene Issue-Nummer enthält, wird die E-Mail zum Kommentar statt zu einem neuen Issue;
  • Sender blacklist — ein Muster pro Zeile; reguläre Ausdrücke sind erlaubt.

Die Schaltfläche „Test connection“ zeigt Ordner, Nachrichtenanzahl und Anzahl neuer Nachrichten.

Registerkarte SMTP

Ausgehende Profile: Host, Port, Konto, Passwort, Verbindungssicherheit und Absenderadresse. Ein Profil kann als Standard markiert werden. In einem Projekt können Sie dieses Profil, ein anderes Profil oder die gemeinsamen Redmine-E-Mail-Einstellungen auswählen.

Registerkarte Deal statuses

Ein gemeinsames Verzeichnis für alle Projekte. Ein Status hat einen Namen, eine Farbe, ein Aktiv-Flag und einen Typ: Open, Won oder Lost. Die Reihenfolge wird durch Ziehen der Zeilen geändert. Ein Status, der bereits an einem Deal verwendet wird, kann nicht gelöscht werden.

Registerkarte Reply templates

Eine Vorlage besteht aus Name und Text. Client-, Issue- und Antwortautor-Felder können in den Text eingefügt werden:

%{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}.

Auf der Issue-Seite wird die Vorlage aus der Liste „Insert template“ ausgewählt. Dafür sind die Berechtigung zum Bearbeiten von Issues und die Berechtigung zum Anzeigen von Clients erforderlich.

Registerkarte Communications

Ein Journal eingehender und ausgehender Nachrichten. Es zeigt, welche E-Mails bereits ein Issue oder einen Kommentar erzeugt haben, damit dieselbe E-Mail nicht zweimal verarbeitet wird. Diese Registerkarte hat keine Speichern-Schaltfläche für Einstellungen.

Registerkarte AI

Adresse des Dienstes, den das Plugin zum Generieren einer Antwort aufruft. Das Verhalten auf der Issue-Seite wird in den Projekteinstellungen aktiviert.

Registerkarte Request rating

Eine gemeinsame E-Mail-Vorlage zur Bewertung der Anfrage. Das Kontrollkästchen „When closing an issue, ask the author for a rating“ aktiviert die Vorlage. Betreff und Text sind erforderlich.

Darunter steht eine Tabelle der Projekte mit dem ClientDesk-Modul. Für jedes Projekt wählen Sie einen Modus: Disabled, Use admin template oder Project template. Der Modus der Admin-Vorlage ist verfügbar, wenn die gemeinsame Vorlage ausgefüllt und aktiviert ist.

Auf dieser Registerkarte verwenden Vorlagenvariablen geschweifte Klammern: {%ticket.id%}, {%ticket.subject%}, {%ticket.project%}, {%ticket.author.name%}, {%ticket.author.email%}, {%client.name%}, {%vote.url%}.

Registerkarte Import

Drei Aktionen, nur für Administratoren.

  • Import from RedmineUp — erstellt Kontakte, Deals und Produkte. Issues werden in diesem Schritt nicht verknüpft.
  • Link issues to new contacts — übernimmt Verknüpfungen aus Helpdesk für bereits importierte Clients. Ein Issue, das bereits einen ClientDesk-Kontakt hat, wird übersprungen.
  • Delete all — löscht dauerhaft Kontakte, Firmen, Deals, Produkte, Notizen und Issue-Verknüpfungen. Deal-Statuswerte, Postfächer und Vorlagen bleiben erhalten.

Wenn RedmineUp-Tabellen in der Datenbank fehlen, meldet der Import dies und erstellt nichts.

Rollen und Rechte

Im Abschnitt ClientDesk:

  • View clients — Client-Liste und -Karte, Notizen, Suche, Kontaktfeld auf einem Issue.
  • Manage clients — Clients und Notizen erstellen, bearbeiten und löschen; Kontakt aus der Issue-Karte erstellen.
  • View deals — Deals und Abonnements.
  • Manage deals — Deals erstellen, bearbeiten und löschen.
  • View products — Katalog.
  • Manage products — Produkte erstellen, bearbeiten und löschen.

Die Manage-Berechtigung umfasst nicht die View-Berechtigung. Vergeben Sie sie getrennt.

Der ClientDesk-Menüpunkt ist sichtbar, wenn das Modul aktiviert ist und mindestens eine View-Berechtigung vorliegt: Clients, Deals oder Produkte. Registerkarten im CRM werden entsprechend ihrer Berechtigungen angezeigt.

Projekteinstellungen für E-Mail werden von einem Benutzer mit Berechtigung zum Bearbeiten des Projekts geändert. CRM-Berechtigungen sind dafür nicht erforderlich.

Hintergrundjobs

Der E-Mail-Abruf kann manuell aus den Projekteinstellungen gestartet werden. Für die Planung vom Redmine-Stammverzeichnis aus:

bundle exec rake clientdesk:fetch_mail

Das automatische Schließen von Anfragen läuft nur mit diesem Befehl:

bundle exec rake clientdesk:auto_close_issues

Projekteinstellungen

Projekt → Einstellungen → ClientDesk.

IMAP

Liste der eingehenden Postfächer für dieses Projekt. Ein Projekt kann mehrere Postfächer haben. Von hier aus können Sie auch „Test connection“ und „Fetch mail“ ausführen.

Nach dem Abruf zeigt die Seite, wie viele E-Mails verarbeitet, wie viele Issues erstellt und wie viele Kommentare hinzugefügt wurden.

SMTP

Ausgehendes Profil für Antworten an Clients. Wenn kein Profil ausgewählt ist, zeigt eine Antwort eine Warnung: SMTP unter Einstellungen → ClientDesk → Mail festlegen.

Feedback

When closing an issue, ask the author for a rating:

  • Disabled;
  • Use admin template;
  • Project template — eigener Betreff und Text. Beide Felder sind erforderlich.

Platzhalter der Projektvorlage: %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{vote.url}.

AI-Einstellungen

  • Enable AI suggestions for client replies und der System-Prompt.
  • Enable a prefilled prompt for clients und der Text dieses Prompts.

Verwendung

CRM öffnen

Projekt → ClientDesk.

Registerkarten:

  • Dashboard — Zähler für Clients, Deals und Produkte. Mit Deal-Berechtigung werden auch Währungssummen und Abonnements angezeigt.
  • Clients.
  • Deals.
  • Products.

Die CRM-Kopfzeile bietet eine Suche über Clients, Deals und Produkte im aktuellen Kontext. Listen können gefiltert und als Abfrage gespeichert werden.

Der Eintrag im Top-Menü oder Anwendungsmenü öffnet dasselbe CRM ohne Bindung an ein Projekt. Listen enthalten Datensätze aus Projekten, in denen das Modul aktiviert ist und eine View-Berechtigung besteht.

Clients

Listenfilter: All, Contacts, Companies.

Die Client-Karte zeigt Kontaktdaten, zugehörige Deals, Issues, Notizen und benutzerdefinierte Felder. Für einen Kontakt können Sie eine Firma direkt im Firmenfeld anlegen. Eine Firmenkarte zeigt ihre Kontakte.

Wichtige Kontaktfelder: Vorname, zweiter Vorname, Nachname, E-Mail, Telefon, Position, Firma, Geburtstag, Adresse, Stadt, Region, Land, Sprache, Website, Steuer-ID, Quelle, Bearbeiter und „Do not contact“. Für eine Firma — Name, Branche und Unternehmensgröße.

Dateien können über benutzerdefinierte Felder vom Typ „file“ an einen Client angehängt werden. Das Journal zeigt, wer den Datensatz wann geändert hat.

Ein Client gehört zu einem Primärprojekt. Er kann auch in anderen Projekten sichtbar gemacht werden: Eltern- und Unterprojekte des Primärprojekts, alle Projekte oder die Liste „Additionally available in projects“. Die Verknüpfung eines Issues oder einer E-Mail mit dem Projekt des Clients fügt den Client diesem Projekt nicht von selbst hinzu.

Wenn beim Anlegen eines Kontakts die E-Mail bereits existiert, erstellt das Plugin keine zweite Karte. Es bietet an, den vorhandenen Kontakt zu öffnen, das Projekt zur Sichtbarkeit hinzuzufügen oder das Primärprojekt zu ändern. Verfügbare Aktionen hängen von den Berechtigungen ab.

„Remove from project“ blendet den Client im aktuellen Projekt aus und behält ihn im Primärprojekt. Das Löschen der Karte erfolgt im Primärprojekt. Ein Client, der mit Issues oder Deals verknüpft ist, kann nicht gelöscht werden.

Deals und Abonnements

Ein Deal ist mit einem Client und einem Projekt verknüpft. Er hat einen Namen, Status, Betrag, Währung, Fälligkeitsdatum, Notiz und Positionen. Eine Position ist ein Produkt, Menge, Preis und Ordnungsnummer. Das Produkt stammt aus dem Katalog des ausgewählten Projekts. Der Preis verwendet die Deal-Währung.

Von einer Client-Karte aus können Sie einen Deal mit bereits ausgewähltem Client erstellen. Ein Deal kann in ein anderes Projekt verschoben werden, wenn in beiden Projekten die Berechtigung Manage deals besteht und der Client dort sichtbar ist.

Ein Abonnement ist ein Produkt vom Typ „Subscription“ mit einer Laufzeit von 1 month oder 1 year. Das Startdatum wird am Deal gesetzt; das Enddatum wird aus der Laufzeit berechnet. Wenn das Fälligkeitsdatum des Deals nicht mit den Enddaten der Abonnements übereinstimmt, bietet das Plugin an, das Fälligkeitsdatum zu ersetzen.

Auf der Issue-Seite öffnet das Überfahren des Kontaktnamens eine Karte: Name, E-Mail, Deals und Abonnements. Aktive und abgelaufene Abonnements werden getrennt angezeigt. Wenn der Kontakt eine Firma hat, zeigt die Karte auch deren Deals. Deals anderer Kontakte dieser Firma werden unter „Other deals“ gruppiert.

Produkte

Projektkatalog. Produkttyp: Goods, Service oder Subscription. Ein Abonnement erfordert eine Laufzeit. Ein Produkt hat einen Namen, eine Beschreibung, eine SKU und Preise. Die Preiswährung wird aus „Available currencies“ gewählt.

Ein Produkt, das bereits in einem Deal verwendet wird, kann nicht gelöscht werden. Die Produktkarte zeigt Deals, in denen es verwendet wird.

Issues

Wenn das Modul aktiviert ist und die Berechtigung „View clients“ besteht:

  1. Suchen Sie im Issue-Formular das Kontaktfeld und beginnen Sie, einen Namen einzugeben. Die Suche startet nach zwei Zeichen.
  2. Wählen Sie einen Kontakt aus und speichern Sie das Issue.
  3. Auf der Issue-Seite wird der Kontakt in einem Block und in der Seitenleistenkarte angezeigt. Sie können die Karte ändern oder leeren, ohne das CRM zu öffnen.
  4. Mit der Berechtigung „Manage clients“ können Sie einen Kontakt aus dieser Karte erstellen.

Ein Issue hat einen aktuellen Kontakt. Das Ändern des Kontakts wird in der Anfragehistorie gespeichert.

Sie können der Issue-Liste Spalten und Filter hinzufügen: Kontakt, Firma des Kontakts, Anfragekanal, Zeit der ersten Reaktion, Zeit der ersten Antwort, Lösungszeit, Client-Bewertung, letzte Nachricht und deren Datum. Kanäle: email, phone, chat, API. Ausgewählte Spalten werden in den Export der Issue-Liste aufgenommen.

Antwort an den Client

In einem Kommentar zu einem Issue mit Kontakt gibt es „Reply to client“. Sie können An, Cc und Bcc festlegen. Die E-Mail wird über das Projekt-SMTP gesendet. Das Issue-Journal vermerkt, dass eine Antwort gesendet wurde. Eine Client-Antwort per E-Mail kommt als Kommentar an und wird als Client-Antwort gekennzeichnet.

Über dem Kommentarfeld steht „write a reply with AI“, wenn Vorschläge im Projekt aktiviert sind. Eine kurze Eingabe und Issue-Daten werden an den KI-Dienst gesendet; der resultierende Text wird in das Kommentarfeld gesetzt.

Anfragebewertung

Wenn Bewertungsanfragen im Projekt aktiviert sind, erhält der Autor beim Schließen eines Issues eine E-Mail mit einem Link. Die Bewertungsseite öffnet sich ohne Anmeldung. Bewertungen: Excellent, Normal, Poor. Ein Kommentar ist optional. Die neueste Bewertung wird gespeichert. Sie ist auf dem Issue und in der Spalte der Issue-Liste sichtbar.

Redmine-Suche

Auf der Suchseite und in der Schnellsuche der Kopfzeile gibt es ein Kontrollkästchen Clientdesk. Es durchsucht Clients, Deals und Produkte als eine Gruppe. Der Zähler Clientdesk (N) behält nur diese Ergebnisse.

In einem einzelnen Projekt wird das Kontrollkästchen angezeigt, wenn das Modul aktiviert ist und eine View-Berechtigung besteht. Bei der Suche über mehrere Projekte wird das Kontrollkästchen immer angezeigt, aber Datensätze aus nicht zugänglichen Projekten werden nicht zurückgegeben.

Die Suche umfasst Name, Titel, E-Mail, Telefon, Position, Website, Steuer-ID, Deal-Name und -Notiz, Produktbeschreibung sowie benutzerdefinierte Felder, die als „Searchable“ markiert sind. Notizen und Anhänge werden nicht durchsucht. „Search titles only“ beschränkt die Suche auf Namen und Titel.

Ein Ergebnislink öffnet die Karte im CRM.


Häufig gestellte Fragen

Warum fehlt das ClientDesk-Menü?

Prüfen Sie drei Bedingungen.

  1. Das Modul ClientDesk ist im Projekt aktiviert.
  2. Die Rolle hat mindestens „View clients“, „View deals“ oder „View products“.
  3. Für den Eintrag außerhalb eines Projekts ist „Show in top menu“ oder „Show in application menu“ aktiviert, und dieselbe View-Berechtigung besteht in mindestens einem Projekt.

Warum zeigt die Einstellungsseite „Enable REST web service“?

Das CRM arbeitet über die Redmine REST API. Aktivieren Sie den Dienst unter Administration → Einstellungen → API.

Kann ich CRM-Daten importieren und Issues sofort verknüpfen?

Nein. Zuerst „Import from RedmineUp“, prüfen Sie die Karten, dann „Link issues to new contacts“. Wenn der Import fehlgeschlagen ist, löscht „Delete all“ importierte Daten und lässt Statuswerte, Mail und Vorlagen unberührt.

Warum wurde aus einer E-Mail kein neues Issue?

Wenn der Betreff eine bereits offene Issue-Nummer enthält und „Use issue number from the subject“ aktiviert ist, wird die E-Mail als Kommentar hinzugefügt. Eine E-Mail von der Blacklist erzeugt kein Issue. Eine wiederholte E-Mail ist auf der Registerkarte „Communications“ sichtbar.

Wer kann die Client-Bewertung sehen?

Der Anfrageautor setzt die Bewertung über den E-Mail-Link. In Redmine ist sie auf dem Issue und in der Spalte der Issue-Liste für Benutzer sichtbar, die auf das Issue zugreifen können.