Integraciones: Jira, Trello y Slack

Qué obtienes

• Jira y Trello: convierte cualquier ticket en una incidencia de Jira o una tarjeta de Trello, con el número de ticket, el asunto, el primer mensaje y un enlace de vuelta a EspressoDesk.
• Slack: recibe un mensaje en Slack cuando lleguen tickets nuevos o urgentes.

Planes

• Notificaciones de Slack: incluidas en Pro y Scale.
• Jira + Trello: add-on Dev Tools (19 USD/mes) desde el plan Pro, incluido en Scale.

Dónde se configura

Panel → Ajustes → Integraciones. Solo el propietario, un administrador o un agente con el permiso «Ajustes: SLA, automatizaciones y campos» puede conectar o desconectar.

Jira — paso a paso

1. Dominio: inicia sesión en Jira y mira la barra de direcciones: https://tuequipo.atlassian.net/jira/.... Copia solo tuequipo.atlassian.net (sin https:// ni barra final).
2. Correo: el correo con el que entras en Atlassian. Debe ser una cuenta con acceso al proyecto; si no, Jira responde «unauthorized».
3. Token de API: abre https://id.atlassian.com/manage-profile/security/api-tokens (o: avatar → Gestionar cuenta → Seguridad → Crear y gestionar tokens de API). Pulsa Crear token de API, ponle el nombre «EspressoDesk», pulsa Crear y Copiar. El token solo se muestra una vez: pégalo directamente en EspressoDesk. Nunca uses tu contraseña.
4. Clave de proyecto por defecto (opcional): abre el proyecto en Jira; la clave es el prefijo de cada incidencia, p. ej. SUP-123 significa clave SUP (también en Proyectos → columna «Clave»). Si lo dejas vacío, eliges el proyecto en un desplegable dentro de cada ticket.
5. Pulsa Conectar. Llamamos a Jira al instante y solo guardamos las credenciales si funcionan.

Requisitos: la cuenta de Atlassian necesita el permiso «Crear incidencias» en ese proyecto. En Jira Server / Data Center usa el dominio de tu servidor y un token de acceso personal.

Trello — qué introducir

1. Clave de API — entra en https://trello.com/power-ups/admin (con tu sesión de Trello), crea un Power-Up (cualquier nombre, p. ej. «EspressoDesk», elige tu workspace) o abre uno existente. En la pestaña API key copia el valor Key: 32 caracteres. No uses el Secret (64 caracteres) ni pegues aquí el token; Trello respondería «invalid key».
2. Token — en la misma página, junto a la clave, pulsa el enlace Token, autoriza con Allow y copia el token largo que aparece.
3. ID de lista por defecto (opcional) — puedes dejarlo vacío. Si lo dejas vacío, al crear una tarjeta usamos la primera lista de tu primer tablero abierto. Para fijar una lista concreta, abre la URL del tablero añadiendo .json y copia el id de esa lista.

Verificamos clave y token al instante. Si Trello los rechaza, te indicamos qué campo falla («invalid key» o «invalid token») y no se guarda nada.

Slack — paso a paso

1. En Slack, crea el canal que recibirá los avisos, p. ej. #soporte.
2. Abre https://api.slack.com/apps → Create New App → From scratch, ponle el nombre «EspressoDesk» y elige tu workspace. (Atajo: en Slack pulsa Apps → Add apps → Incoming Webhooks y salta al paso 4.)
3. En el menú de la app elige Incoming Webhooks y activa Activate Incoming Webhooks.
4. Pulsa Add New Webhook to Workspace, selecciona el canal y confirma con Allow.
5. Copia la Webhook URL generada: empieza por https://hooks.slack.com/services/. Solo aceptamos URLs de esa dirección.
6. Pégala en EspressoDesk, marca los eventos que quieras (tickets nuevos, urgentes) y pulsa Conectar. Enviamos un mensaje de prueba al momento para que compruebes el canal.

Necesitas permiso para instalar apps en el workspace de Slack; si no lo tienes, pide a tu administrador que cree el webhook y te pase la URL.

Seguridad

Las credenciales se guardan cifradas y no se vuelven a mostrar. Al desconectar se eliminan. Solo enviamos los datos del ticket necesarios para la acción solicitada.

Dentro de un ticket (panel «Dev tools y Slack»)

Abre un ticket y usa la sección Dev tools y Slack de la barra lateral derecha:

• Crear en Jira / Crear tarjeta de Trello: crea una incidencia o tarjeta a partir del ticket (número, asunto, primer mensaje y enlace de vuelta).
• Vincular existente: pega una clave de Jira como SUP-123 o el id/URL de una tarjeta de Trello. Comprobamos que existe realmente antes de guardar.
• Abrir: te lleva a la incidencia o tarjeta vinculada.
• Desvincular: elimina solo el enlace en EspressoDesk; no se borra nada en Jira ni en Trello.
• Compartir en Slack: publica el resumen del ticket en tu canal cuando lo necesites, además de las notificaciones automáticas de tickets nuevos o urgentes.

Slack es unidireccional (EspressoDesk → Slack): no se puede responder a un ticket desde Slack. Si Slack o el webhook fallan, la creación del ticket nunca se bloquea: el error solo se registra y se muestra en Ajustes.