Jira Service Management
Conecte Jira Service Management con un token de API de Atlassian para que un agente pueda abrir tickets, añadir notas y consultar tickets.
Qué conseguirá
Jira Service Management mostrará Connected.
Descripción general y casos de uso
La conexión puede crear una solicitud de servicio, comentarla, consultarla y enumerar los tipos de solicitud y los centros de servicio: la base para convertir una llamada en un ticket.
Requisitos previos
- Un sitio de Jira Service Management Cloud y una cuenta de Atlassian.
Configuración de la cuenta externa (en Atlassian)
Atlassian controla estas pantallas. La guía de Atlassian: Service desk REST API.
- Cree un API token en id.atlassian.com/manage-profile/security/api-tokens. Puede tener ámbitos o no; Phynxa detecta cuál.
- Anote la dirección de su sitio, como
your-site.atlassian.net, y el correo de la cuenta a la que pertenece el token. - Opcionalmente anote un Service desk ID y un Request type ID para usarlos como valores predeterminados.
Conéctelo en Phynxa
- Integrations, Connect en Jira Service Management.
- Escriba Site, Account email y API token. Opcionalmente escriba Service desk ID y Request type ID.
- Elija Check and connect.
Permisos y ajustes
La autenticación es el correo de la cuenta con el token. Un token con ámbitos funciona solo a través de la pasarela de Atlassian, y uno clásico en el sitio; Phynxa prueba primero el sitio y recurre a la pasarela, así que no necesita saber cuál creó. Crear una solicitud requiere un centro de servicio y un tipo de solicitud, y el tipo de solicitud decide qué campos son obligatorios.
Úselo en una llamada
En la pestaña Tools de un agente, Add tool, Integration, Jira Service Management:
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Create ticket | Abre una solicitud en el centro de servicio y el tipo de solicitud guardados con la conexión. Necesita summary; description es opcional. | En segundo plano |
| Add comment | Añade una nota interna a un ticket (el cliente no la ve). Necesita ticket (como SUP-123) y text. | En segundo plano |
| Get ticket | Lee el estado y los detalles de un ticket. Necesita ticket. | Espera |
Listar tipos de solicitud y centros de servicio sirve para configurar la conexión, y no se ofrece a los agentes.
Pruébelo
Test connection debe responder «Jira Service Management is responding.»
Resultado esperado
La tarjeta muestra Connected.
Solución de problemas
- Falla la comprobación. Revise el sitio, el correo y el token, y que la cuenta del token pueda usar el centro de servicio.
- Se rechaza una solicitud por campos que faltan. Jira nombra los campos que faltan; ajuste el tipo de solicitud.
Seguridad y credenciales
El token se almacena cifrado. Revóquelo en Atlassian para cortar el acceso; Remove lo elimina aquí.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.