Alguien reporta un error en una conversación. La solución pertenece a Jira, donde miran tus desarrolladores, no a una nota que alguien copiará más tarde. Una sola clave llega a los dos lados: el canal por el que llegó el mensaje y el proyecto de Jira en el que debe convertirse en incidencia.
Lo que necesitas
- Jira conectado en la página de salas: un token de API, con el sitio y la dirección de correo a la que pertenece, pegado una sola vez.
- Un connection_id de GET /jira/v1/connections y un project_id de GET /jira/v1/connections/{connection_id}/projects.
- La conversación en sí, de la API del canal por el que llegó — o una sala, donde ya está.
Abre la incidencia
curl -X POST https://makehybrid.com/jira/v1/connections/$CONNECTION_ID/projects/$PROJECT_ID/tasks \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"title":"Checkout fails on the second card","notes":"From WhatsApp, +44 7700 900123, 12:04. Card declined, no error shown.","status":"open"}'
Lo que vuelve trae el task_id que Jira le dio — su clave de incidencia —, que es con lo que contestar al cliente y lo que hay que modificar con un patch cuando esté hecha.
curl -X PATCH https://makehybrid.com/jira/v1/connections/$CONNECTION_ID/projects/$PROJECT_ID/tasks/$TASK_ID \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"status":"done"}'
La incidencia la abre el miembro cuyo token es la conexión. Jira la registra a nombre de esa persona, así que el historial es el mismo que si la hubiera escrito ella allí.
Que lo haga un agente
En una sala de proyecto con los dos agentes marcados, una sola frase lo hace todo: el agente lee la conversación, abre la incidencia y dice cuál es:
- @scout abre una incidencia de Jira con lo que Dana reportó esta mañana por WhatsApp y dile el número.
Preguntas frecuentes
¿Puede un agente hacerlo sin que se lo pidan cada vez?
Puede, si sus instrucciones lo dicen. Una sala muestra cada respuesta a todos los que están en ella, así que escribe la instrucción para que diga qué está a punto de abrir y espere a que alguien responda «adelante» si la incidencia fuera a llegar a los clientes.
¿Y si el id del proyecto es incorrecto?
404, con las mismas palabras que una conexión que no es tuya. El id de un proyecto se consulta en Jira en cada llamada en lugar de darse por bueno, así que uno equivocado no llega a nada.