Skip to content

Configurar la integración con Jira ​

Acceso

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 ​

  1. Accede a la página de tokens de API de Atlassian e ingresa con la cuenta de Jira.
  2. 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).
  3. Haz clic en Crear y copia el token.
Un token vencido interrumpe la integración

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 ​

  1. Accede a ¡Hola! Store → Jira y haz clic en Instalar. Se abre la ventana Instalar Jira.
  2. 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.
  3. Haz clic en Instalar.

Crear la automatización en Jira ​

  1. En Jira, abre el proyecto, accede a Configuración del proyecto → Automatización y crea una regla.
  2. Define el disparador, por ejemplo, cuando un ítem cambie de estado.
  3. 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.
  4. 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 ​

CampoQué hace
Notificar atencionesActiva o desactiva el aviso a las atenciones.
Estado a notificarLos estados de Jira que disparan el mensaje. Obligatorio cuando la notificación está activa.
Mensaje a enviarEl 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 ​

CampoQué hace
Notificar internamenteActiva 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 notificarLos estados de Jira que disparan el mensaje.
Grupos a notificarLos grupos del chat interno que reciben el mensaje.
Mensaje a enviarEl texto enviado. Acepta las variables de abajo.

Consulta cómo funcionan los grupos en Chat interno.

Variables del mensaje ​

VariableQué trae
Enlace del ítemLa dirección del ítem en Jira.
Identificador del ítemEl código del ítem (ej.: ABC-123).
Título del ítemEl resumen del ítem.
Estado del ítemEl estado actual.
Tipo del ítemEl tipo del ítem (ej.: Tarea, Bug).
Escribe los estados sin acento

¡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íntomaQué verificar
El mensaje no le llega a nadieVerifica 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 saleRegistra 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 problemasVerifica 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.

Contenidos relacionados ​