Jira-Integration
Funktioniert mit Jira
Verbinden Sie ReplyRabbit mit Jira Cloud, damit Support-Gespräche in FreeScout zu strukturierten Jira-Issues werden können. Agenten können ein Jira-Issue aus einem Gespräch erstellen, das verknüpfte Issue in FreeScout sichtbar halten und ReplyRabbit nutzen, um das Kunden-Follow-up vorzubereiten, wenn die Arbeit erledigt ist.
Suchen Sie die Übersicht?
Übersicht
Die Jira-Integration fügt ReplyRabbit in einem FreeScout-Gespräch ein Jira-Panel hinzu. Wenn Jira für ein Postfach konfiguriert ist, kann ReplyRabbit ein Issue mit Titel, Beschreibung, Priorität, Labels, Zugewiesenem, Issue-Typ, Projekt und einem Link zurück zum Support-Gespräch erstellen.
Jira ist als aktiver Issue-Tracker für ein Postfach ausgewählt. Wenn ein Postfach bereits Linear oder GitHub Issues verwendet, behalte diesen Tracker ausgewählt, bis du bereit bist, dieses Postfach auf Jira umzustellen.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:
- Eine funktionierende FreeScout-Installation.
- ReplyRabbit installiert und aktiviert.
- Ein ReplyRabbit-Plan, der die gewünschte Jira-Funktion enthält.
- Eine Jira Cloud-Site wie
https://example.atlassian.net. - Eine Jira-Konto-E-Mail und ein API-Token mit Zugriff auf das Zielprojekt.
- Mindestens ein Jira-Projekt und ein Issue-Typ, die die Issue-Erstellung unterstützen.
- Jira-Projektberechtigungen für den Workflow, den du aktivierst: Browse Projects und Create Issues sind erforderlich; Edit Issues, Assign Issues, Transition Issues und Add Comments werden benötigt, wenn du Prioritäts-/Label-Bearbeitungen, Zuweisung, Statusübergänge oder Thread-Kommentare verwendest.
Wenn ReplyRabbit noch nicht installiert ist, beginnen Sie mit So installieren Sie das ReplyRabbit-Modul, dann schließen Sie ab So richten Sie ReplyRabbit ein.
Berechtigungen und API-Tokens
ReplyRabbit verbindet sich mit der Jira Cloud REST API v3 über Basic-Auth. Das Postfach speichert drei Verbindungswerte:
- Jira-Site-URL: die
https://example.atlassian.netSite-URL. - Konto-E-Mail: die Atlassian-Konto-E-Mail-Adresse, die mit dem API-Token verwendet wird.
- API-Token: das Jira Cloud API-Token für dieses Konto.
Das API-Token wird als verschlüsselte Postfach-Einstellung gespeichert und nach dem Speichern nicht mehr vollständig angezeigt. Wenn das Token in Atlassian rotiert oder entfernt wird, aktualisieren Sie die Postfach-Einstellungen, bevor Sie weitere Issues erstellen.
Jira verbinden
Öffnen Sie die Postfacheinstellungen
Öffnen Sie in FreeScout das Postfach, das Jira-Issues erstellen soll, und öffnen Sie dann Einstellungen und wählen Sie ReplyRabbit.Jira als Issue-Tracker auswählen
In der Integrationen Abschnitt, setzen Sie den Issue-Tracker auf Jira. Ein Postfach kann Linear, GitHub Issues, Jira oder keinen Issue-Tracker verwenden.Jira-Anmeldedaten hinzufügen
Fügen Sie die Jira Cloud-Site-URL, die Konto-E-Mail und das API-Token ein.Jira-Projekte laden
Projekte aus Jira laden und dann das Standardprojekt für neue Issues wählen.Den Vorgangstyp auswählen
Issue-Typen für das Projekt laden und den Standard-Issue-Typ wählen, z. B. Task oder Bug.Einstellungen speichern
Speichere die Postfacheinstellungen. ReplyRabbit speichert die Jira-Verbindung für dieses Postfach.
Standardeinstellungen konfigurieren
Nachdem Jira verbunden ist, konfigurieren Sie die Standardwerte, die Ihr Team benötigt:
- Standardprojekt: das Jira-Projekt, das verwendet wird, wenn keine Domain-Zuordnung oder KI-Projektübereinstimmung ein anderes Projekt auswählt.
- Standard-Issue-Typ: der Issue-Typ für neue Issues, normalerweise Task oder Bug.
- Prioritätszuordnung: ordnen Sie ReplyRabbit-Prioritätsstufen nativen Jira-Prioritätsnamen zu.
- Projekt-Routing: ordnen Sie Kunden-E-Mail-Domains Jira-Projekten zu, wenn das Routing deterministisch sein soll.
- Issues automatisch einreichen: im Team-Tarif lassen Sie ReplyRabbit automatisch Jira-Issues erstellen, wenn die Triage besagt, dass Engineering-Arbeit nötig ist.
- Auto-Entwurf bei Erledigt: lassen Sie ReplyRabbit eine Kunden-Nachverfolgung vorbereiten, wenn das verknüpfte Jira-Issue die Statuskategorie Done erreicht.
Projekt-Routing ist optional. Wenn kein Projekt sicher zugeordnet werden kann, verwendet ReplyRabbit das Standardprojekt des Postfachs.
Ein Jira-Issue aus einem FreeScout-Gespräch erstellen
Öffnen Sie eine Konversation in einem Postfach, in dem Jira konfiguriert ist. Das ReplyRabbit-Panel kann aus dem Kunden-Thread ein Jira-Issue erstellen und dann das verknüpfte Issue in FreeScout anzeigen.
ReplyRabbit sendet Jira eine strukturierte Beschreibung im Atlassian Document Format. Die Beschreibung enthält die Support-Zusammenfassung, den Kundenkontext und den FreeScout-Konversationslink. Kundentext wird als Inhalt behandelt, nicht als Anweisung.
Prüfen Sie nach der Erstellung das verknüpfte Jira-Issue und passen Sie bei Bedarf Status, Priorität, Assignee oder Labels im ReplyRabbit-Panel an.
Halte Konversationen und Issues synchron
Sobald ein Issue verknüpft ist, kann die FreeScout-Konversation den aktuellen Jira-Status, die Priorität, den Zugewiesenen, die Labels und den Issue-Key anzeigen. Agenten können das Issue in Jira öffnen, wenn sie die vollständige Engineering-Ansicht benötigen.
ReplyRabbit ändert den Jira-Status über Jira-Übergänge. Es schreibt nicht direkt in das Statusfeld.
ReplyRabbit unterstützt auch eine Abschlussschleife. Eine geplante Statusprüfung fragt verknüpfte Jira-Issues ab. Wenn Jira die Statuskategorie Done meldet, kann ReplyRabbit beim Entwerfen der Kunden-Nachverfolgung helfen, damit der Support die Konversation mit Kontext schließen kann.
Fehlerbehebung
| Symptom | Was zu prüfen ist |
|---|---|
| Projekte werden nicht geladen | Bestätigen Sie, dass die Site-URL eine Jira Cloud ist atlassian.net URL, die E-Mail ist korrekt und das API-Token hat Projektzugriff. |
| Issue-Typen fehlen | Bestätigen, dass das ausgewählte Projekt den Vorgangstyp unterstützt, den Sie voraussichtlich verwenden werden. |
| Issues werden nicht erstellt | Bestätigen, dass Jira als Postfach-Issue-Tracker ausgewählt ist, ein Projekt ausgewählt ist und Ihr ReplyRabbit-Tarif die Funktion enthält. |
| Automatische Issues werden nicht erstellt | Bestätigen Sie, dass Sie im Team-Tarif sind und Issues automatisch einreichen ist aktiviert. |
| Status wird nicht aktualisiert | Laden Sie die Konversation neu und bestätigen Sie dann, dass Jira einen gültigen Übergang für den Zielstatus bereitstellt. |
| Abschluss-Entwürfe erscheinen nicht | Bestätigen Auto-Entwurf bei Erledigt ist aktiviert und das verknüpfte Jira-Issue hat die Statuskategorie Done erreicht. |
Für umfassendere Behebungen siehe Fehlerbehebung bei ReplyRabbit.
Datenschutz und Datenverarbeitung
ReplyRabbit sendet Jira die für die Übergabe an die Entwicklung benötigten Vorgangsinhalte. Dazu können relevanter Kundenkontext, generierter Vorgangstext, Priorität, Beschriftungen, Bearbeiter und ein FreeScout-Konversationslink oder -Bezeichner gehören.
Geben Sie keine sensiblen Informationen in ein Jira-Issue ein, es sei denn, Ihr Jira Cloud Workspace darf sie erhalten. Wenn Kundendaten vollständig auf Ihrem eigenen Server bleiben müssen, lassen Sie Jira für dieses Postfach deaktiviert.
FAQ
Unterstützt ReplyRabbit Jira Data Center oder Server?
Nein. ReplyRabbit unterstützt Jira Cloud-Sites, die eine atlassian.net-URL verwenden.
Brauche ich OAuth für Jira?
Nein. ReplyRabbit verwendet Jira Cloud Basic Auth pro Postfach mit einer Site-URL, Konto-E-Mail und einem Jira-API-Token.
Kann ein Postfach Jira gleichzeitig mit Linear oder GitHub Issues verwenden?
Nein. Ein Postfach wählt einen aktiven Issue-Tracker. Die Einstellungen für Linear und GitHub Issues bleiben verfügbar, wenn eines davon ausgewählt ist.
Kann ReplyRabbit eine Kunden-Nachverfolgung entwerfen, wenn ein Jira-Vorgang abgeschlossen ist?
Ja. ReplyRabbit fragt verknüpfte Jira-Issues ab und kann einen Kunden-Follow-up-Entwurf vorbereiten, wenn Jira die Statuskategorie Done meldet.