Integración de incidencias de GitHub
Funciona con GitHub
Conecta ReplyRabbit a GitHub Issues para que las conversaciones de soporte en FreeScout se conviertan en issues estructurados en el repositorio correcto. Los agentes pueden crear un issue desde una conversación, mantener el issue vinculado visible en FreeScout y dejar que ReplyRabbit prepare el traspaso a ingeniería.
¿Buscas la descripción general?
Resumen
La integración de GitHub Issues añade un panel de GitHub a ReplyRabbit en una conversación de FreeScout. Cuando GitHub está configurado, ReplyRabbit puede crear una incidencia con un título útil para desarrolladores, un resumen útil, etiquetas, responsables, contexto del repositorio y un enlace de vuelta a la conversación de soporte.
Cada buzón elige un rastreador de problemas: ninguno, Linear o GitHub. GitHub y Linear son alternativas para el mismo flujo de trabajo de soporte a ingeniería, no dos rastreadores que se ejecutan juntos en un buzón.
La creación manual de incidencias de GitHub está disponible en Pro y Team. La creación automática de incidencias de GitHub a partir de nuevos correos electrónicos de clientes está disponible en Team.
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 GitHub que quieres usar.
- Acceso a una cuenta u organización de GitHub donde se deban crear incidencias.
- Un repositorio con GitHub Issues habilitado.
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 alcance del token
ReplyRabbit se conecta a GitHub con un token de acceso personal que proporcionas en los ajustes del buzón. Se recomienda un token de grano fino, limitado a los repositorios que ReplyRabbit debe usar. Puedes crear uno desde Configuración de tokens de grano fino de GitHub.
Concede al token suficiente acceso para leer metadatos del repositorio, leer etiquetas y responsables, crear y actualizar incidencias y añadir comentarios a incidencias. Para un token de grano fino, empieza con Metadatos: lectura, Contenido: lectura, y Incidencias: lectura y escritura para los repositorios seleccionados.
Para registros de auditoría más estrictos, crea el token desde una cuenta de bot de GitHub dedicada que solo tenga acceso a los repositorios que ReplyRabbit debería usar.
Mantén el token privado. Si el token se rota o se elimina en GitHub, actualiza la configuración del buzón antes de crear más incidencias.
Conectar GitHub Issues
Abre los ajustes del buzón
En FreeScout, abre el buzón que debe crear issues de GitHub, luego abre Configuración y elige ReplyRabbit.Elegir GitHub como gestor de tickets
En el selector de rastreador de issues, elige Incidencias de GitHub. ReplyRabbit muestra los ajustes de GitHub y oculta los ajustes de Linear para ese buzón.Pega el token
Pega tu Token de acceso personal de GitHub. Si ya guardaste un token, ReplyRabbit muestra una vista previa enmascarada en lugar del secreto completo.Cargar repositorios
Hacer clic en el botón para cargar los repositorios desde GitHub y, a continuación, elegir el repositorio predeterminado donde deben crearse los nuevos tickets.Guardar configuración
Guarda la configuración del buzón. ReplyRabbit almacena la conexión de GitHub para ese buzón.
Configurar los valores predeterminados
Después de seleccionar el repositorio predeterminado, configura los valores predeterminados de las incidencias desde los que tus agentes deben empezar:
- Repositorio predeterminado: elige dónde se crean las incidencias cuando ninguna regla de enrutamiento coincide.
- Envío automático de issues: en el nivel Team, deja que ReplyRabbit cree automáticamente incidencias de GitHub cuando el resultado del triaje indique que se necesita trabajo de ingeniería.
- Enrutamiento de repositorios: activa la selección automática de repositorio cuando quieras que ReplyRabbit asocie conversaciones a los repositorios disponibles.
- Asignaciones de dominio: asigna dominios de correo de clientes a repositorios concretos cuando necesites un enrutamiento determinista.
- Etiquetas: elige las etiquetas que ReplyRabbit puede aplicar para el tipo de incidencia, la prioridad u otras etiquetas de flujo de trabajo.
- Etiquetas de prioridad: asigna los niveles de prioridad de ReplyRabbit a etiquetas de GitHub, ya que GitHub Issues no tiene un campo de prioridad nativo.
- Asignado predeterminado: elige el usuario de GitHub que debe recibir nuevas incidencias por defecto.
- Aviso de revisión: cuando la creación automática de incidencias está habilitada, añade una nota de FreeScout que indique a los agentes que la incidencia se creó automáticamente y debe revisarse.
El enrutamiento de repositorios es opcional. Si ningún repositorio coincide con confianza, ReplyRabbit usa el repositorio predeterminado.
Crear un issue de GitHub desde una conversación de FreeScout
Abre una conversación en un buzón donde GitHub esté configurado. El panel de ReplyRabbit puede crear una incidencia de GitHub a partir del hilo del cliente y luego mostrar la incidencia vinculada en FreeScout.
El contenido de la incidencia se genera para un traspaso a ingeniería, no se copia ciegamente de todo el hilo de correo. Revisa el título, el resumen, las etiquetas, los asignados y el repositorio antes de crear la incidencia cuando se usa la creación manual.
ReplyRabbit también puede añadir el contexto del hilo de correo como comentario en un issue de GitHub, para que ingeniería tenga los detalles del cliente sin pedir a soporte que vuelva a pegar el mismo hilo.
Mantén las conversaciones y las incidencias sincronizadas
Una vez vinculada una incidencia, la conversación de FreeScout puede mostrar el identificador, título, estado, etiquetas y responsables actuales de la incidencia de GitHub. Los agentes pueden abrir la incidencia en GitHub cuando necesiten la vista completa de ingeniería.
ReplyRabbit también admite un bucle de finalización: comprueba los issues de GitHub vinculados según una programación, normalmente cada 5 minutos. Cuando GitHub cierra un issue, ReplyRabbit puede ayudar a redactar el seguimiento al cliente para que el soporte pueda cerrar la conversación con contexto. Si su equipo usa motivos de cierre de GitHub, puede restringir los borradores de finalización a los issues cerrados como completados.
Resolución de problemas
| Síntoma | Qué comprobar |
|---|---|
| Los repositorios no se cargarán | Confirma que el token está vigente y puede acceder a los repositorios de GitHub seleccionados. |
| No se crean incidencias | Confirmar que GitHub es el gestor de tickets seleccionado, que hay un repositorio predeterminado 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 repositorio es incorrecto o falta | Confirmar que el enrutamiento de repositorios o las asignaciones de dominio están configurados. ReplyRabbit usa el repositorio predeterminado cuando no hay una coincidencia fiable. |
| Las etiquetas o los responsables no se actualizarán | Vuelva a cargar la conversación y luego confirme que el token sigue teniendo acceso al repositorio vinculado. |
| GitHub devuelve errores de límite de velocidad | Espera a que se restablezca el límite de la API de GitHub del token y luego considera reducir el acceso a repositorios o disminuir la actividad automatizada de incidencias. |
| Los tickets cerrados no generan borradores | Confirmar Borrador automático al marcar como hecho está activado y, si el modo de solo completadas está activo, la incidencia de GitHub se cerró como completada. |
Para correcciones más amplias, consulta Resolución de problemas de ReplyRabbit.
Privacidad y tratamiento de datos
ReplyRabbit envía a GitHub el contenido del problema necesario para el traspaso a ingeniería. Eso puede incluir contexto relevante del cliente, el título del problema generado, el resumen generado, etiquetas, asignados y el enlace o identificador de la conversación de FreeScout.
No ponga información sensible en un problema de GitHub a menos que el repositorio esté autorizado a recibirla. Si los datos del cliente deben permanecer completamente en su propio servidor, mantenga GitHub deshabilitado para ese buzón.
Próximos pasos
- Continuar con Cómo configurar ReplyRabbit si el buzón aún necesita configuración de proveedor, contexto o estilo.
- Leer Integración con Slack si tu equipo quiere notificaciones de creación o finalización de incidencias en Slack.
- Comparar con Integración con Linear si estás decidiendo qué gestor de incidencias debe usar un buzón.
Preguntas frecuentes
¿Necesito un token de acceso personal de GitHub?
Sí. ReplyRabbit se conecta a GitHub con un token de tu propia cuenta u organización de GitHub.
¿Puede un buzón usar Linear y GitHub al mismo tiempo?
No. Cada buzón elige un rastreador de incidencias: ninguno, Linear o GitHub.
¿Puede ReplyRabbit elegir el repositorio de GitHub?
Sí, cuando el enrutamiento de repositorios está configurado. ReplyRabbit admite asignaciones por dominio y coincidencia de repositorios con IA para los repositorios a los que tu token puede acceder.
¿Qué plan incluye GitHub Issues?
La creación manual de incidencias de GitHub es una función de Pro. La creación automática de incidencias de GitHub es una función de Team.
¿ReplyRabbit envía toda la conversación del cliente a GitHub?
ReplyRabbit envía el contenido del problema necesario para el traspaso a ingeniería, incluido el contexto relevante del cliente y el resumen generado.