Configurar la integración con Jira
Ruta: ¡Hola! Store → Jira → Instalar
Visión general
La app Jira conecta ¡Hola! Suite con tus proyectos de Jira. Cuando un ítem (tarjeta) cambia de estado en Jira, ¡Hola! Suite envía un mensaje automático: a las atenciones que mencionan ese ítem, o a grupos del chat interno. Así, clientes y equipo acompañan el avance de las demandas sin salir de ¡Hola! Suite.
La configuración tiene tres partes: crear el token de API en Jira, instalar la app en ¡Hola! Suite y crear la automatización de Jira que avisa a ¡Hola! Suite. Después, defines las reglas de cada proyecto.
La app es gratuita en ¡Hola! Suite. Jira sigue tu plan con Atlassian. Solo puede haber una app de gestión de proyectos instalada.
Requisitos previos
- Permiso para visualizar ¡Hola! Store en tu grupo de permisos.
- Una cuenta de Jira Cloud, con permiso para crear reglas de automatización en los proyectos.
- La dirección de tu Jira con
https://(ej.:https://suaempresa.atlassian.net). - Para notificar a clientes: atenciones con el enlace del ítem de Jira registrado en las observaciones.
Paso a paso
Crear el token de API en Jira
- Accede a la página de tokens de API de Atlassian e ingresa con la cuenta de Jira.
- Haz clic en Crear token de API, ponle un nombre y elige la fecha de vencimiento. El token es válido de 1 a 365 días (ayuda de Atlassian).
- Haz clic en Crear y copia el token.
Cuando el token vence, la conexión con Jira se interrumpe. Crea un nuevo token y actualiza la app en Registro.
Instalar la app en ¡Hola! Suite
- Accede a ¡Hola! Store → Jira y haz clic en Instalar. Se abre la ventana Instalar Jira.
- Completa los campos:
- Url: la dirección de tu Jira, con
https://, sin nada después del dominio. - Correo electrónico de la cuenta: el correo electrónico de la cuenta de Jira que creó el token.
- Clave API: el token copiado.
- Url: la dirección de tu Jira, con
- Haz clic en Instalar.
Crear la automatización en Jira
- En Jira, abre el proyecto, accede a Configuración del proyecto → Automatización y crea una regla.
- Define el disparador, por ejemplo, cuando un ítem cambie de estado.
- Agrega la acción Enviar solicitud web (Send web request) con:
- URL:
https://[dirección de tu ¡Hola! Suite]/webhook/jira - Método: POST
- Cuerpo: los datos del ítem en el formato de la automatización de Jira.
- URL:
- Guarda y activa la regla.
¡Hola! Suite solo reacciona a ítems de proyectos que configuraste en la pestaña Proyectos.
Resultado esperado
La app aparece como Instalado y el botón Ver configuraciones abre las pestañas Registro y Proyectos. La pestaña Proyectos lista los proyectos de Jira de la cuenta conectada.
Configuraciones disponibles
Haz clic en un proyecto de la lista para abrir las secciones Información del proyecto, Notificar a los clientes y Notificar a usuarios internos. En cada sección de notificación, activa la opción, ajusta los campos y guarda.
Notificar a los clientes
| Campo | Qué hace |
|---|---|
| Notificar atenciones | Activa o desactiva el aviso a las atenciones. |
| Estado a notificar | Los estados de Jira que disparan el mensaje. Obligatorio cuando la notificación está activa. |
| Mensaje a enviar | El texto enviado. Obligatorio cuando la notificación está activa. Acepta las variables de abajo. |
El mensaje va a las atenciones En curso que tengan el enlace del ítem en las observaciones. Se envía en nombre del agente responsable de la atención. Si el ítem cambió de nombre en Jira, ¡Hola! Suite también considera los enlaces antiguos del historial. En WhatsApp, la atención debe estar dentro de la ventana de atención.
Notificar a usuarios internos
| Campo | Qué hace |
|---|---|
| Notificar internamente | Activa o desactiva el aviso a los grupos. |
| Usuario que notificará | El usuario en cuyo nombre se envía el mensaje en los grupos. |
| Estado a notificar | Los estados de Jira que disparan el mensaje. |
| Grupos a notificar | Los grupos del chat interno que reciben el mensaje. |
| Mensaje a enviar | El texto enviado. Acepta las variables de abajo. |
Consulta cómo funcionan los grupos en Chat interno.
Variables del mensaje
| Variable | Qué trae |
|---|---|
| Enlace del ítem | La dirección del ítem en Jira. |
| Identificador del ítem | El código del ítem (ej.: ABC-123). |
| Título del ítem | El resumen del ítem. |
| Estado del ítem | El estado actual. |
| Tipo del ítem | El tipo del ítem (ej.: Tarea, Bug). |
¡Hola! Suite compara el estado del ítem, ya sin acentos, con los estados que registraste. Por eso, registra los estados sin acento (ej.: "Concluido" para el estado "Concluído").
Problemas comunes
| Síntoma | Qué verificar |
|---|---|
| El mensaje no le llega a nadie | Verifica si la automatización de Jira está activa y apunta a /webhook/jira, si el proyecto está configurado en la pestaña Proyectos y si la notificación está activa. |
| El estado del ítem está en la lista y el mensaje no sale | Registra el estado sin acento. |
| El cliente no lo recibió | El enlace del ítem debe estar en las observaciones de una atención en curso. En WhatsApp, la atención debe estar en la ventana de atención. |
| La lista de proyectos no carga, o aparece que la integración tiene problemas | Verifica la Url, el Correo electrónico de la cuenta y la Clave API, y si el token no venció. |
Buenas prácticas
- Registra solo los estados que importan para el cliente, para no generar demasiados mensajes.
- Usa las variables para que el mensaje traiga el enlace y el estado del ítem.
- Renueva el token antes de la fecha de vencimiento.