Integración con Jira
Funciona con Jira
Conecta ReplyRabbit a Jira Cloud para que las conversaciones de soporte en FreeScout se conviertan en issues estructurados de Jira. Los agentes pueden crear un issue de Jira desde una conversación, mantener el issue vinculado visible en FreeScout y usar ReplyRabbit para preparar el seguimiento con el cliente cuando el trabajo esté hecho.
¿Buscas la descripción general?
Resumen
La integración de Jira añade un panel de Jira a ReplyRabbit en una conversación de FreeScout. Cuando Jira está configurado para un buzón, ReplyRabbit puede crear una incidencia con título, descripción, prioridad, etiquetas, responsable, tipo de incidencia, proyecto y un enlace de vuelta a la conversación de soporte.
Jira está seleccionado como el rastreador de incidencias activo para un buzón. Si un buzón ya usa Linear o GitHub Issues, mantén ese rastreador seleccionado hasta que estés listo para mover ese buzón a Jira.
Requisitos previos
Antes de empezar, asegúrate de tener:
- Una instalación de FreeScout en funcionamiento.
- ReplyRabbit instalado y activado.
- Un plan de ReplyRabbit que incluya la función de Jira que quieres usar.
- Un sitio de Jira Cloud como
https://example.atlassian.net. - Un correo de cuenta de Jira y un token API con acceso al proyecto de destino.
- Al menos un proyecto y tipo de issue de Jira que admitan la creación de issues.
- Permisos de proyecto de Jira para el flujo de trabajo que habilites: se requieren Browse Projects y Create Issues; Edit Issues, Assign Issues, Transition Issues y Add Comments son necesarios cuando usas ediciones de prioridad/etiqueta, asignación, transiciones de estado o comentarios en el hilo.
Si ReplyRabbit aún no está instalado, empieza con Cómo instalar el módulo de ReplyRabbit, luego completa Cómo configurar ReplyRabbit.
Permisos y tokens de API
ReplyRabbit se conecta a la API REST v3 de Jira Cloud con autenticación básica. El buzón almacena tres valores de conexión:
- URL del sitio de Jira: el
https://example.atlassian.netURL del sitio. - Correo de la cuenta: el correo de la cuenta de Atlassian usado con el token de API.
- Token API: el token de API de Jira Cloud para esa cuenta.
El token de API se almacena como una configuración de buzón cifrada y no se vuelve a mostrar completo después de guardarse. Si el token se rota o se elimina en Atlassian, actualiza la configuración del buzón antes de crear más incidencias.
Conectar Jira
Abre los ajustes del buzón
En FreeScout, abre el buzón que debe crear issues de Jira, luego abre Configuración y elige ReplyRabbit.Elegir Jira como gestor de tickets
En el Integraciones sección, establece el rastreador de issues en Jira. Un buzón puede usar Linear, GitHub Issues, Jira o ningún gestor de incidencias.Añadir credenciales de Jira
Pega la URL del sitio de Jira Cloud, el correo de la cuenta y el token de API.Cargar proyectos de Jira
Carga los proyectos desde Jira y luego elige el proyecto predeterminado para las nuevas incidencias.Elegir el tipo de ticket
Carga los tipos de incidencia del proyecto y elige el tipo de incidencia predeterminado, como Tarea o Error.Guardar configuración
Guarda la configuración del buzón. ReplyRabbit almacena la conexión de Jira para ese buzón.
Configurar los valores predeterminados
Después de conectar Jira, configura los valores predeterminados que tu equipo necesita:
- Proyecto predeterminado: el proyecto de Jira usado cuando ninguna asignación de dominio ni coincidencia de proyecto por IA elige un proyecto diferente.
- Tipo de problema predeterminado: el tipo de issue para nuevos issues, normalmente Task o Bug.
- Asignación de prioridad: asigna los niveles de prioridad de ReplyRabbit a los nombres de prioridad nativos de Jira.
- Enrutamiento de proyectos: asigna dominios de correo de clientes a proyectos de Jira cuando el enrutamiento deba ser determinista.
- Envío automático de issues: en el nivel Team, deja que ReplyRabbit cree automáticamente incidencias de Jira cuando el triaje indique que se necesita trabajo de ingeniería.
- Borrador automático al marcar como hecho: deja que ReplyRabbit prepare un seguimiento al cliente cuando la incidencia de Jira vinculada alcance la categoría de estado Done.
El enrutamiento de proyectos es opcional. Si no se encuentra una coincidencia segura con ningún proyecto, ReplyRabbit usa el proyecto predeterminado del buzón.
Crear un issue de Jira desde una conversación de FreeScout
Abre una conversación en un buzón donde Jira esté configurado. El panel de ReplyRabbit puede crear una incidencia de Jira a partir del hilo del cliente y luego mostrar la incidencia vinculada en FreeScout.
ReplyRabbit envía a Jira una descripción estructurada en Atlassian Document Format. La descripción incluye el resumen de soporte, el contexto del cliente y el enlace de la conversación de FreeScout. El texto del cliente se trata como contenido, no como instrucciones.
Después de la creación, revisa la incidencia de Jira vinculada y ajusta el estado, la prioridad, el responsable o las etiquetas desde el panel de ReplyRabbit cuando sea necesario.
Mantén las conversaciones y las incidencias sincronizadas
Una vez vinculada una incidencia, la conversación de FreeScout puede mostrar el estado, prioridad, responsable, etiquetas y clave de incidencia actuales de Jira. Los agentes pueden abrir la incidencia en Jira cuando necesiten la vista completa de ingeniería.
ReplyRabbit cambia el estado de Jira mediante transiciones de Jira. No escribe directamente en el campo de estado.
ReplyRabbit también admite un bucle de finalización. Una comprobación de estado programada consulta los issues de Jira vinculados. Cuando Jira informa la categoría de estado Done, ReplyRabbit puede ayudar a redactar el seguimiento al cliente para que el soporte pueda cerrar la conversación con contexto.
Resolución de problemas
| Síntoma | Qué comprobar |
|---|---|
| Los proyectos no se cargan | Confirma que la URL del sitio es un Jira Cloud atlassian.net URL, el correo electrónico es correcto y el token de API tiene acceso al proyecto. |
| Faltan tipos de incidencia | Confirmar que el proyecto seleccionado admite el tipo de ticket que esperas usar. |
| No se crean incidencias | Confirmar que Jira está seleccionado como gestor de tickets del buzón, que hay un proyecto seleccionado y que tu plan de ReplyRabbit incluye la función. |
| No se crean issues automáticos | Confirma que estás en el plan Team y Envío automático de issues está activado. |
| El estado no se actualizará | Vuelva a cargar la conversación y luego confirme que Jira expone una transición válida para el estado de destino. |
| Los borradores de finalización no aparecen | Confirmar Borrador automático al marcar como hecho está activado y la incidencia de Jira vinculada ha alcanzado la categoría de estado Done. |
Para correcciones más amplias, consulta Resolución de problemas de ReplyRabbit.
Privacidad y tratamiento de datos
ReplyRabbit envía a Jira el contenido del problema necesario para el traspaso a ingeniería. Eso puede incluir contexto relevante del cliente, texto del problema generado, prioridad, etiquetas, asignado y un enlace o identificador de la conversación de FreeScout.
No ponga información sensible en un problema de Jira a menos que su espacio de trabajo de Jira Cloud esté autorizado a recibirla. Si los datos del cliente deben permanecer completamente en su propio servidor, mantenga Jira deshabilitado para ese buzón.
Preguntas frecuentes
¿ReplyRabbit es compatible con Jira Data Center o Server?
No. ReplyRabbit admite sitios de Jira Cloud que usan una URL de atlassian.net.
¿Necesito OAuth para Jira?
No. ReplyRabbit usa autenticación básica de Jira Cloud por buzón con una URL del sitio, el correo de la cuenta y un token de API de Jira.
¿Puede un buzón usar Jira con Linear o GitHub Issues al mismo tiempo?
No. Un buzón elige un rastreador de incidencias activo. Los ajustes de Linear y GitHub Issues siguen disponibles cuando se selecciona cualquiera de ellos.
¿Puede ReplyRabbit redactar un seguimiento al cliente cuando se completa un ticket de Jira?
Sí. ReplyRabbit consulta periódicamente las incidencias de Jira vinculadas y puede preparar un borrador de seguimiento para el cliente cuando Jira informa la categoría de estado Done.