Integrazione Jira
Funziona con Jira
Collega ReplyRabbit a Jira Cloud così le conversazioni di supporto in FreeScout possono diventare issue Jira strutturate. Gli agenti possono creare un'issue Jira da una conversazione, mantenere l'issue collegata visibile in FreeScout e usare ReplyRabbit per preparare il follow-up con il cliente quando il lavoro è completato.
Cerchi la panoramica?
Panoramica
L'integrazione Jira aggiunge un pannello Jira a ReplyRabbit in una conversazione FreeScout. Quando Jira è configurato per una casella di posta, ReplyRabbit può creare un ticket con titolo, descrizione, priorità, etichette, assegnatario, tipo di ticket, progetto e un link alla conversazione di supporto.
Jira è selezionato come issue tracker attivo per una casella di posta. Se una casella di posta usa già Linear o GitHub Issues, mantieni quel tracker selezionato finché non sei pronto a spostare quella casella di posta su Jira.
Prerequisiti
Prima di iniziare, assicurati di avere:
- Un'installazione FreeScout funzionante.
- ReplyRabbit installato e attivato.
- Un piano ReplyRabbit che include la funzionalità Jira che vuoi usare.
- Un sito Jira Cloud come
https://example.atlassian.net. - Un'email account Jira e un token API con accesso al progetto di destinazione.
- Almeno un progetto Jira e un tipo di issue che supportino la creazione di issue.
- Permessi del progetto Jira per il workflow che abiliti: Browse Projects e Create Issues sono obbligatori; Edit Issues, Assign Issues, Transition Issues e Add Comments sono necessari quando usi modifiche di priorità/etichette, assegnazione, transizioni di stato o commenti nel thread.
Se ReplyRabbit non è ancora installato, inizia con Come installare il modulo ReplyRabbit, poi completa Come configurare ReplyRabbit.
Autorizzazioni e token API
ReplyRabbit si collega a Jira Cloud REST API v3 con autenticazione Basic. La casella memorizza tre valori di connessione:
- URL del sito Jira: il
https://example.atlassian.netURL del sito. - Email dell'account: l'email dell'account Atlassian usata con il token API.
- Token API: il token API Jira Cloud per quell'account.
Il token API è memorizzato come impostazione crittografata della casella di posta e non viene mostrato di nuovo per intero dopo il salvataggio. Se il token viene ruotato o rimosso in Atlassian, aggiorna le impostazioni della casella di posta prima di creare altri ticket.
Collega Jira
Apri le impostazioni della casella di posta
In FreeScout, apri la casella che deve creare issue Jira, poi apri Impostazioni e scegli ReplyRabbit.Scegli Jira come issue tracker
Nel Integrazioni sezione, imposta il tracker dei ticket su Jira. Una casella di posta può usare Linear, GitHub Issues, Jira o nessun issue tracker.Aggiungi credenziali Jira
Incolla l'URL del sito Jira Cloud, l'email dell'account e il token API.Carica i progetti Jira
Carica i progetti da Jira, poi scegli il progetto predefinito per i nuovi problemi.Scegli il tipo di ticket
Carica i tipi di problema per il progetto e scegli il tipo di problema predefinito, come Task o Bug.Salva impostazioni
Salva le impostazioni della casella. ReplyRabbit memorizza la connessione Jira per quella casella.
Configura i valori predefiniti
Dopo che Jira è connesso, configura i valori predefiniti di cui il tuo team ha bisogno:
- Progetto predefinito: il progetto Jira usato quando nessuna mappatura di dominio o corrispondenza AI di progetto sceglie un progetto diverso.
- Tipo di problema predefinito: il tipo di ticket per i nuovi ticket, di solito Task o Bug.
- Mappatura delle priorità: mappa i livelli di priorità di ReplyRabbit sui nomi di priorità nativi di Jira.
- Instradamento del progetto: mappa i domini email dei clienti sui progetti Jira quando l'instradamento deve essere deterministico.
- Invio automatico delle issue: nel livello Team, lascia che ReplyRabbit crei automaticamente issue Jira quando il triage indica che serve lavoro di ingegneria.
- Bozza automatica su Done: lascia che ReplyRabbit prepari un follow-up per il cliente quando l'issue Jira collegata raggiunge la categoria di stato Done.
L'instradamento del progetto è facoltativo. Se nessun progetto viene associato con certezza, ReplyRabbit usa il progetto predefinito della casella.
Crea un'issue Jira da una conversazione FreeScout
Apri una conversazione in una casella di posta in cui Jira è configurato. Il pannello ReplyRabbit può creare una issue Jira dal thread del cliente, poi mostrare la issue collegata in FreeScout.
ReplyRabbit invia a Jira una descrizione strutturata in Atlassian Document Format. La descrizione include il riepilogo del supporto, il contesto del cliente e il link alla conversazione FreeScout. Il testo del cliente è trattato come contenuto, non come istruzioni.
Dopo la creazione, rivedi il ticket Jira collegato e regola stato, priorità, assegnatario o etichette dal pannello ReplyRabbit quando necessario.
Mantieni conversazioni e issue sincronizzate
Una volta collegata una issue, la conversazione FreeScout può mostrare lo stato, la priorità, l'assegnatario, le etichette e la chiave della issue Jira attuali. Gli agenti possono aprire la issue in Jira quando hanno bisogno della vista completa di ingegneria.
ReplyRabbit cambia lo stato di Jira tramite le transizioni di Jira. Non scrive direttamente nel campo stato.
ReplyRabbit supporta anche un ciclo di completamento. Un controllo pianificato dello stato esegue il polling delle issue Jira collegate. Quando Jira segnala la categoria di stato Done, ReplyRabbit può aiutare a redigere il follow-up per il cliente così il supporto può chiudere la conversazione con contesto.
Risoluzione dei problemi
| Sintomo | Cosa controllare |
|---|---|
| I progetti non si caricano | Conferma che l'URL del sito sia un Jira Cloud atlassian.net URL, l'email è corretta e il token API ha accesso al progetto. |
| Mancano i tipi di issue | Conferma che il progetto selezionato supporti il tipo di ticket che prevedi di usare. |
| Le issue non vengono create | Conferma che Jira sia selezionato come issue tracker della casella di posta, che sia selezionato un progetto e che il tuo piano ReplyRabbit includa la funzionalità. |
| Le issue automatiche non vengono create | Conferma di essere sul piano Team e Invio automatico delle issue è abilitato. |
| Lo stato non verrà aggiornato | Ricarica la conversazione, poi conferma che Jira esponga una transizione valida per lo stato di destinazione. |
| Le bozze di completamento non compaiono | Conferma Bozza automatica su Done è abilitato e l'issue Jira collegata ha raggiunto la categoria di stato Done. |
Per correzioni più ampie, vedi Risoluzione dei problemi di ReplyRabbit.
Privacy e gestione dei dati
ReplyRabbit invia a Jira il contenuto del problema necessario per il passaggio al reparto tecnico. Ciò può includere il contesto pertinente del cliente, il testo del problema generato, la priorità, le etichette, l'assegnatario e un link o identificatore della conversazione FreeScout.
Non inserire informazioni sensibili in un problema Jira a meno che il tuo workspace Jira Cloud non sia autorizzato a riceverle. Se i dati dei clienti devono rimanere interamente sul tuo server, mantieni Jira disabilitato per quella casella di posta.
FAQ
ReplyRabbit supporta Jira Data Center o Server?
No. ReplyRabbit supporta i siti Jira Cloud che utilizzano un URL atlassian.net.
Serve OAuth per Jira?
No. ReplyRabbit utilizza l'autenticazione Basic di Jira Cloud per casella di posta con un URL del sito, un'email dell'account e un token API di Jira.
Una casella di posta può usare Jira con Linear o GitHub Issues contemporaneamente?
No. Una casella di posta sceglie un solo issue tracker attivo. Le impostazioni di Linear e GitHub Issues restano disponibili quando ne è selezionato uno.
ReplyRabbit può preparare un follow-up per il cliente quando un ticket Jira è completato?
Sì. ReplyRabbit monitora le issue Jira collegate e può preparare una bozza di follow-up per il cliente quando Jira segnala la categoria di stato Done.