Introducción a Live Chat for JSM

Live Chat for JSM es una aplicación Forge para Jira Service Management Cloud que permite la comunicación en tiempo real entre los clientes del portal de servicio y los agentes de soporte. Cada conversación se vincula automáticamente a una solicitud JSM, de modo que el equipo puede consultar todo el historial sin salir de Jira.

Características Principales

• Widget de chat en el portal: Los clientes pueden iniciar un chat directamente desde el portal de servicio JSM. El widget se carga con la configuración del service desk en el que se encuentra el cliente.

• Configuración por portal: Los administradores pueden configurar varios portales de servicio de forma independiente desde Apps → Tus apps → Live Chat for JSM. Cada portal se asocia a un proyecto, service desk y request type único.

• Bandeja del agente: Los agentes autorizados gestionan las sesiones desde la página de proyecto Live Chat, con un layout de tres columnas y colas para organizar las conversaciones.

• Acceso controlado al inbox: El administrador puede limitar qué usuarios y grupos pueden atender chats en cada portal mediante listas de autorización.

• Una sola conversación abierta: Solo puede existir una conversación activa por cliente y portal. Si el cliente vuelve al portal, se recupera el chat activo en el servidor.

• Creación automática de solicitudes: Cada nuevo chat genera automáticamente una solicitud JSM, con los mensajes almacenados como comentarios públicos de la solicitud.

• Asignación automática: Cuando un agente responde o resuelve una conversación desde Jira, la solicitud se asigna automáticamente a ese agente.

• Resolución con resolution: El agente puede cerrar la conversación seleccionando una resolución y añadiendo un comentario de transición.

• Interfaz multidioma: La interfaz está disponible en inglés y español, adaptándose al idioma configurado por el usuario en Jira.

Diferencias con Jira Live Chat (DC)

Característica	Live Chat for JSM (Cloud)	Jira Live Chat (DC)
Plataforma	Atlassian Forge · JSM Cloud	Jira DC / JSM Data Center
Módulos	jiraServiceManagement:portalHeader (Custom UI), jira:projectPage, jira:adminPage	Plugin Servlet + JS/CSS
Acciones	Resolvers Forge (liveChatApi)	REST servlet propio
WebSocket	No — usa polling	No — usa polling
Formulario inicial	No disponible en 1.0.0	Configurable con campos adicionales
Adjuntos	No disponible en 1.0.0	Soportados
Encuesta de satisfacción	No disponible en 1.0.0	Encuesta nativa JSM

info

Este producto es el equivalente Cloud de Jira Live Chat (DC). Si ya utilizas la versión Data Center, consulta las diferencias antes de migrar.

Modelo de datos

• 1 chat = 1 solicitud JSM: Cada conversación crea o se vincula a una solicitud en el Service Desk asociado al portal.
• 1 mensaje = 1 comentario público: Los mensajes del chat se almacenan como comentarios públicos de la solicitud.
• Label jira-dc-live-chat: Las solicitudes creadas por el chat incluyen este label para facilitar la búsqueda con JQL.

Arquitectura técnica

El app está compuesto por tres módulos Forge:

Módulo	Descripción
Widget / Launcher	Se inyecta en el portal del cliente (jiraServiceManagement:portalHeader) mediante Custom UI.
Bandeja del agente	Página de proyecto (jira:projectPage) que muestra las colas y la conversación.
Panel de administración	Página de admin (jira:adminPage con useAsConfig) para configurar portales, accedida desde Apps → Tus apps.

Siguiente paso: Guía de Instalación.