- Integraciones
- Jira
Integración con Jira: un error que informa un cliente se convierte en una incidencia de Jira
La integración de Agenola con Jira crea una incidencia en tu proyecto de Jira para un error o petición que informa un visitante, lee el estado de la incidencia y se lo dice al visitante, y añade comentarios y adjuntos a la incidencia. Se conecta con un clic con tu cuenta de Atlassian.
Cómo funciona
Una incidencia se crea con un paso de Jira que añades al flujo, o con una acción que activas en la pestaña Integraciones del paso Asistente de IA. Las solicitudes de soporte no llegan solas a Jira.
El sitio, el proyecto y el tipo de incidencia se eligen en el paso, no en la página de conexión. Si tu cuenta de Atlassian tiene acceso a un solo sitio de Jira, puedes dejar el sitio vacío; si tiene acceso a varios, debes elegirlo en el paso.
Los pasos cubren crear, obtener, buscar, actualizar y eliminar incidencias; historial de cambios, opciones de estado, avisos de Jira, comentarios, adjuntos y detalles de usuarios.
- Cada incidencia lleva la etiqueta "agenola", y los registros marcados como urgentes llevan además la etiqueta "acil", para que puedas filtrar en Jira las incidencias que vienen del chat.
- Los pasos de Jira se ejecutan en nombre de la persona que hizo la conexión: las incidencias se crean en su nombre y solo en proyectos a los que tiene acceso.
- Los pasos de eliminación no se ejecutan hasta marcar la casilla de confirmación del paso.
- Si la conexión no se usa durante 90 días, Atlassian revoca el acceso y tienes que volver a conectar.
Qué hace
Esta lista se genera desde la misma fuente que la página de Jira en el panel: si no aparece aquí, no lo hacemos con Jira. Los pasos del flujo están en el editor de flujos, en Añadir paso → Integraciones → Jira.
IncidenciaAcción · Paso del flujo8
Crear incidencia
Crea una incidencia en el proyecto elegido en nombre de la persona que conectó Jira. Cada incidencia lleva la etiqueta "agenola"; las urgentes también "acil".
Eliminar incidencia
Elimina definitivamente la incidencia; no se puede deshacer. Si tiene subtareas, Jira no la elimina salvo que «Eliminar también las subtareas» esté activado.
Obtener incidencia
Lee el título, el estado, el tipo, la persona asignada, las etiquetas y la descripción de la incidencia.
Buscar incidencias
Encuentra incidencias en el proyecto elegido o con tu consulta y las devuelve como lista. Si ambos están vacíos, devuelve las actualizadas en los últimos 30 días.
Obtener historial de cambios
Devuelve los cambios de la incidencia, los más recientes primero; cada campo cambiado es una fila.
Enviar aviso
Envía el aviso por correo de Jira sobre la incidencia. Si no se elige destinatario, va a la persona asignada y a los observadores.
Obtener opciones de estado
Devuelve como lista los estados a los que puede pasar la incidencia ahora.
Actualizar incidencia
Cambia el título, la descripción, el estado, la prioridad, la persona asignada, las etiquetas o la fecha de vencimiento; los campos vacíos no cambian. Las etiquetas se añaden y las existentes se mantienen.
AdjuntoAcción · Paso del flujo4
Añadir adjunto
Crea un archivo de texto con el contenido que escribas y lo adjunta a la incidencia.
Obtener adjunto
Lee el nombre, la URL, el tamaño y el tipo del adjunto.
Obtener adjuntos
Devuelve como lista todos los adjuntos de la incidencia.
Eliminar adjunto
Elimina definitivamente un adjunto de la incidencia.
ComentarioAcción · Paso del flujo5
Añadir comentario
Escribe un comentario en la incidencia en nombre de la persona que conectó Jira.
Obtener comentario
Lee el texto, el autor y la fecha del comentario.
Obtener comentarios
Devuelve como lista los comentarios de la incidencia, los más recientes primero.
Actualizar comentario
Cambia el texto de un comentario de la incidencia.
Eliminar comentario
Elimina definitivamente un comentario de la incidencia.
UsuarioAcción · Paso del flujo1
Obtener usuario
Lee el nombre, el correo y la zona horaria de un usuario de Jira. Si sus ajustes de privacidad ocultan el correo, llega vacío.
Conversaciones de ejemplo
Visitante: Vuestra app móvil se cierra cuando toco "Pagar" en la pantalla de pago.
Agente: Lo paso a nuestro equipo de desarrollo. ¿Me dices el modelo de tu teléfono y la versión de la app?
Visitante: iPhone 13, versión 4.2.1
Agente: Lo he registrado como MOB-482. Puedes preguntar por su estado con ese número.
Entre bastidores: El paso "Crear incidencia" crea un error titulado "La app se cierra en la pantalla de pago" en el proyecto MOB; la descripción lleva el dispositivo, la versión y un resumen de la conversación, y la incidencia recibe la etiqueta "agenola".
Visitante: ¿Cuál es el estado de MOB-482, que informé la semana pasada?
Agente: MOB-482 está ahora "En curso"; nuestro equipo trabaja en una solución.
Entre bastidores: El paso "Obtener incidencia" lee el título y el estado de la incidencia en Jira, y el agente da el estado en el idioma del visitante.
Visitante: Quiero añadir algo a MOB-482: solo pasa al pagar con tarjeta de crédito.
Agente: Lo he añadido a la incidencia; nuestro equipo lo verá.
Entre bastidores: El paso "Añadir comentario" escribe la nota del visitante en MOB-482 como comentario.
Configuración
- 1En Agenola ve a Integraciones → Jira y pulsa "Conectar con Jira".
- 2En la pantalla de consentimiento de Atlassian, elige tu sitio de Jira y da acceso.
- 3En el editor de flujos, añade el paso "Crear incidencia" en Añadir paso → Integraciones → Jira, y elige el sitio, el proyecto y el tipo de incidencia en el paso.
Configuración detallada: ¿Cómo creo registros en Trello y Jira?
Permisos y adónde van tus datos
- Enviado a Jira: el título, la descripción, las etiquetas, los comentarios y los adjuntos de la incidencia; los campos que defines en el paso.
- Leído de Jira: solo cuando un paso lo pide, detalles de incidencias, comentarios, historial y usuarios; los sitios y proyectos a los que accede la cuenta conectada, para elegir sitio y proyecto.
- Permisos solicitados: leer y escribir incidencias de Jira, leer detalles de usuarios y acceso sin conexión para que la conexión siga funcionando.
- Los datos de conexión se guardan cifrados en el servidor. Solo el propietario y los administradores del espacio de trabajo pueden conectarla o quitarla; también puedes revocar el acceso en la página Aplicaciones conectadas de tu cuenta de Atlassian.
Integraciones relacionadas
Ver todas las integraciones
Trello
Tus agentes crean tarjetas en tu tablero y añaden comentarios y listas de comprobación.
Asana
La solicitud de un visitante se convierte en una tarea en tu proyecto de Asana; el agente añade comentarios e informa de su estado.
Slack
Las nuevas solicitudes y avisos llegan a tu canal, y tus agentes envían mensajes.
Preguntas frecuentes
¿Cómo distingo las incidencias que vienen del chat?
Cada incidencia lleva la etiqueta "agenola", y los registros marcados como urgentes llevan además la etiqueta "acil". Puedes filtrar por estas etiquetas en Jira o crear un tablero aparte.
Usamos varios sitios de Jira. ¿Qué hacemos?
Si tu cuenta de Atlassian tiene acceso a varios sitios, elige el sitio en cada paso de Jira; sin él, el paso no se ejecuta. Con un solo sitio, puedes dejar el campo vacío.
¿En nombre de quién se crean las incidencias?
En el de la persona que hizo la conexión, y solo en proyectos a los que tiene acceso. Conectar con una cuenta compartida del equipo mantiene la conexión cuando las personas cambian de puesto.