Spun mantiene WhatsApp en el número que tus clientes ya usan y lo conecta a Jira Service Management mediante un flujo de trabajo en tu propio n8n. Cada conversación de WhatsApp se convierte en una solicitud en tu proyecto de servicio, los mensajes posteriores se agregan como comentarios, y un comentario público de un agente vuelve al cliente por WhatsApp.
Esta es la configuración de WhatsApp para Jira Service Management pensada para equipos que ya gestionan el soporte en Jira: los agentes siguen trabajando las solicitudes donde están, y los clientes siguen escribiendo donde están. El token de API de Jira se queda en tu n8n; Spun nunca lo recibe ni lo guarda.
Qué hace el flujo de trabajo de WhatsApp con Jira Service Management
- El primer mensaje de una conversación crea una solicitud del tipo de solicitud que elijas, con el nombre, el número y el mensaje del cliente en la descripción, y el número en un campo de número de WhatsApp.
- Los mensajes posteriores se agregan a la solicitud abierta como comentarios públicos, precedidos por el nombre y el número de quien escribe.
- Un comentario público de un agente se envía al cliente por WhatsApp como texto. Los comentarios internos nunca salen de Jira.
- Las respuestas que tu equipo envía desde la bandeja de entrada de Spun se agregan como comentarios internos, así que ambos lados pueden responder.
- Archivar la conversación en Spun ejecuta tu transición de resolución, y desarchivarla reabre la solicitud cuando hay una transición de reapertura configurada. Resolver en Jira también puede archivar la conversación en Spun, una opción que está desactivada hasta que la actives.
Todas las solicitudes las crea una sola cuenta de integración, un agente del proyecto de servicio. El flujo de trabajo no crea ni empareja clientes de Jira, así que las notificaciones a clientes de Jira para estas solicitudes van al buzón de esa cuenta, no al cliente.
Configuración, paso a paso
Necesitas un sitio de Jira Service Management con un proyecto de servicio, una cuenta de integración que sea agente en ese proyecto (si esa licencia se cobra depende de tu plan de Jira), un administrador de Jira una vez para crear el webhook, y una instancia de n8n a la que Jira y Spun puedan llegar por HTTPS.
- 1
Crea un token de API para la cuenta de integración
Con la sesión iniciada en esa cuenta, crea un token de API y guárdalo en n8n como una credencial “Basic Auth”. Se queda en tu n8n.
- 2
Agrega un campo “WhatsApp number”
Un campo de texto corto en el tipo de solicitud que deben usar las conversaciones de WhatsApp.
- 3
Busca tus transiciones
La transición que resuelve una solicitud y, si quieres, una que la reabre.
- 4
Importa el flujo de trabajo
Abre su nodo “Settings” y pega la URL de tu sitio, el service desk, el tipo de solicitud, la clave del proyecto, el id del campo, las transiciones y el id de la cuenta de integración.
- 5
Crea el webhook de Jira
Como administrador de Jira, un webhook hacia la URL de respuesta del flujo de trabajo en “Comment: created”, filtrado con JQL a tu proyecto y protegido con un secreto. Jira firma cada entrega y el flujo de trabajo lo verifica.
- 6
Crea una clave de API de Spun
“Configuraciones”, luego “Webhooks”, luego “Gestionar claves API”, con el permiso “Enviar mensajes”. Marca también “Cerrar y reabrir conversaciones” si resolver en Jira debe archivar la conversación en Spun.
- 7
Suscribe Spun al flujo de trabajo
Agrega un webhook para mensajes entrantes, mensajes salientes, conversación cerrada y conversación reabierta, con el “Formato de carga útil” en “Crudo (predeterminado)”, y pega su secreto de firma en el flujo de trabajo.
- 8
Envía un mensaje de prueba
Escríbele a la línea desde otro teléfono. Aparece una solicitud en Jira; agrega un comentario público como agente y la respuesta llega al teléfono.
Relacionado: Documentación: Jira Service Management con n8n, la guía de configuración completa · WhatsApp + n8n: la API y los webhooks que hay debajo
Lo que debes saber antes de construirlo
- Los chats de grupo se omiten.
- Los archivos multimedia entran a la solicitud como un enlace válido durante 24 horas, no como un adjunto de Jira. Las respuestas desde Jira son solo texto; los adjuntos de un comentario no se reenvían.
- Jira acepta 20 escrituras en una misma solicitud en 2 segundos y 100 en 30 segundos. Durante una ráfaga larga de mensajes, los que sobran no se agregan a la solicitud; se quedan en la bandeja de entrada de Spun y la ejecución de n8n se puede repetir.
- Una solicitud abierta por conversación. Los comentarios de más de 32.000 caracteres se recortan.
- Cada evento entregado usa tokens de IA de tu plan de Spun. Cómo se mide esto para el uso con mesas de ayuda todavía está en revisión.
Relacionado: Todas las integraciones de WhatsApp con mesas de ayuda · WhatsApp como la mesa de ayuda en sí