Jira-integratie
Werkt met Jira
Verbind ReplyRabbit met Jira Cloud zodat supportgesprekken in FreeScout gestructureerde Jira-issues kunnen worden. Agenten kunnen een Jira-issue aanmaken vanuit een gesprek, het gekoppelde issue zichtbaar houden in FreeScout en ReplyRabbit gebruiken om klantopvolging voor te bereiden wanneer het werk klaar is.
Op zoek naar het overzicht?
Overzicht
De Jira-integratie voegt een Jira-paneel toe aan ReplyRabbit in een FreeScout-gesprek. Wanneer Jira voor een mailbox is geconfigureerd, kan ReplyRabbit een issue aanmaken met een titel, beschrijving, prioriteit, labels, toegewezen persoon, issuetype, project en een link terug naar het supportgesprek.
Jira is geselecteerd als de actieve issue-tracker voor een mailbox. Als een mailbox al Linear of GitHub Issues gebruikt, houd die tracker dan geselecteerd tot je klaar bent om die mailbox naar Jira te verplaatsen.
Vereisten
Voordat je begint, zorg dat je het volgende hebt:
- Een werkende FreeScout-installatie.
- ReplyRabbit geïnstalleerd en geactiveerd.
- Een ReplyRabbit-abonnement dat de Jira-functie bevat die je wilt gebruiken.
- Een Jira Cloud-site zoals
https://example.atlassian.net. - Een Jira-account-e-mail en API-token met toegang tot het doelproject.
- Ten minste één Jira-project en issue-type dat het aanmaken van issues ondersteunt.
- Jira-projectmachtigingen voor de workflow die je inschakelt: Browse Projects en Create Issues zijn vereist; Edit Issues, Assign Issues, Transition Issues en Add Comments zijn nodig wanneer je prioriteit/label-bewerkingen, toewijzing, statusovergangen of threadreacties gebruikt.
Als ReplyRabbit nog niet is geïnstalleerd, begin dan met Hoe je de ReplyRabbit-module installeert, en voltooi dan Hoe je ReplyRabbit instelt.
Machtigingen en API-tokens
ReplyRabbit verbindt met Jira Cloud REST API v3 via Basic-auth. De mailbox bewaart drie verbindingswaarden:
- Jira Site-URL: de
https://example.atlassian.netsite-URL. - Account-e-mail: het Atlassian-account-e-mailadres dat bij het API-token hoort.
- API-token: het Jira Cloud API-token voor dat account.
Het API-token wordt opgeslagen als een versleutelde mailboxinstelling en wordt na opslaan niet volledig teruggetoond. Als het token in Atlassian wordt geroteerd of verwijderd, werk dan de mailboxinstellingen bij voordat je meer issues aanmaakt.
Jira verbinden
Open de mailboxinstellingen
Open in FreeScout de mailbox die Jira-issues moet aanmaken en open dan Instellingen en kies ReplyRabbit.Kies Jira als de issue-tracker
In de Integraties sectie, stel de issuetracker in op Jira. Een mailbox kan Linear, GitHub Issues, Jira of geen issue tracker gebruiken.Jira-referenties toevoegen
Plak de Jira Cloud-site-URL, het account-e-mailadres en het API-token.Jira-projecten laden
Laad projecten uit Jira en kies vervolgens het standaardproject voor nieuwe issues.Kies het issue-type
Laad issuetypen voor het project en kies het standaard issuetype, zoals Taak of Bug.Instellingen opslaan
Sla de mailboxinstellingen op. ReplyRabbit slaat de Jira-verbinding voor die mailbox op.
Standaardwaarden configureren
Nadat Jira is verbonden, configureer je de standaardwaarden die je team nodig heeft:
- Standaardproject: het Jira-project dat wordt gebruikt wanneer geen domeinmapping of AI-projectmatch een ander project kiest.
- Standaard issuetype: het issuetype voor nieuwe issues, meestal Task of Bug.
- Prioriteitstoewijzing: koppel ReplyRabbit-prioriteitsniveaus aan native Jira-prioriteitsnamen.
- Projectroutering: koppel e-maildomeinen van klanten aan Jira-projecten wanneer routering deterministisch moet zijn.
- Issues automatisch indienen: op de Team-tier, laat ReplyRabbit automatisch Jira-issues aanmaken wanneer triage zegt dat engineeringwerk nodig is.
- Auto-concept bij Done: laat ReplyRabbit een klantopvolging voorbereiden wanneer het gekoppelde Jira-issue de statuscategorie Done bereikt.
Projectroutering is optioneel. Als er geen project met zekerheid wordt gematcht, gebruikt ReplyRabbit het standaardproject van de mailbox.
Maak een Jira-issue aan vanuit een FreeScout-gesprek
Open een gesprek in een mailbox waar Jira is geconfigureerd. Het ReplyRabbit-paneel kan een Jira-issue aanmaken vanuit de klantthread en vervolgens het gekoppelde issue in FreeScout tonen.
ReplyRabbit stuurt Jira een gestructureerde beschrijving in Atlassian Document Format. De beschrijving bevat de supportsamenvatting, klantcontext en de link naar het FreeScout-gesprek. Klanttekst wordt als inhoud behandeld, niet als instructies.
Controleer na het aanmaken het gekoppelde Jira-issue en pas indien nodig status, prioriteit, toegewezene of labels aan vanuit het ReplyRabbit-paneel.
Houd gesprekken en issues synchroon
Zodra een issue is gekoppeld, kan het FreeScout-gesprek de huidige Jira-status, prioriteit, toegewezen persoon, labels en issue-sleutel tonen. Agenten kunnen het issue in Jira openen wanneer ze de volledige technische weergave nodig hebben.
ReplyRabbit wijzigt de Jira-status via Jira-transities. Het schrijft niet rechtstreeks naar het statusveld.
ReplyRabbit ondersteunt ook een afrondingslus. Een geplande statuscontrole pollt gekoppelde Jira-issues. Wanneer Jira de Done-statuscategorie meldt, kan ReplyRabbit helpen de klantopvolging op te stellen zodat support het gesprek met context kan sluiten.
Probleemoplossing
| Symptoom | Wat te controleren |
|---|---|
| Projecten worden niet geladen | Bevestig dat de site-URL een Jira Cloud is atlassian.net URL, het e-mailadres correct is en het API-token projecttoegang heeft. |
| Issue-typen ontbreken | Bevestig dat het geselecteerde project het issue-type ondersteunt dat je verwacht te gebruiken. |
| Issues worden niet aangemaakt | Bevestig dat Jira is geselecteerd als de mailbox-issue-tracker, een project is geselecteerd en je ReplyRabbit-plan de functie bevat. |
| Automatische issues worden niet aangemaakt | Bevestig dat je op het Team-niveau zit en Issues automatisch indienen is ingeschakeld. |
| Status wordt niet bijgewerkt | Herlaad het gesprek en bevestig dat Jira een geldige overgang biedt voor de doelstatus. |
| Afrondingsconcepten verschijnen niet | Bevestigen Auto-concept bij Done is ingeschakeld en het gekoppelde Jira-issue de statuscategorie Done heeft bereikt. |
Voor bredere oplossingen, zie Probleemoplossing ReplyRabbit.
Privacy en gegevensverwerking
ReplyRabbit stuurt Jira de issue-inhoud die nodig is voor de engineeringoverdracht. Dat kan relevante klantcontext, gegenereerde issuetekst, prioriteit, labels, assignee en een link of identifier van het FreeScout-gesprek omvatten.
Zet geen gevoelige informatie in een Jira-issue tenzij uw Jira Cloud-workspace die mag ontvangen. Als klantgegevens volledig op uw eigen server moeten blijven, houd Jira dan uitgeschakeld voor die mailbox.
FAQ
Ondersteunt ReplyRabbit Jira Data Center of Server?
Nee. ReplyRabbit ondersteunt Jira Cloud-sites die een atlassian.net-URL gebruiken.
Heb ik OAuth nodig voor Jira?
Nee. ReplyRabbit gebruikt per-mailbox Jira Cloud Basic-auth met een site-URL, account-e-mail en Jira API-token.
Kan één mailbox Jira tegelijk met Linear of GitHub Issues gebruiken?
Nee. Een mailbox kiest één actieve issue tracker. De instellingen voor Linear en GitHub Issues blijven beschikbaar wanneer een van beide is geselecteerd.
Kan ReplyRabbit een klantopvolging opstellen wanneer een Jira-issue is afgerond?
Ja. ReplyRabbit pollt gekoppelde Jira-issues en kan een concept voor een klantopvolging voorbereiden wanneer Jira de Done-statuscategorie meldt.