Alguém relata um bug numa conversa. A correção pertence ao Jira, onde os seus desenvolvedores olham, e não a uma nota que alguém vai copiar depois. Uma só chave alcança os dois lados: o canal por onde a mensagem chegou e o projeto do Jira em que ela deve virar uma issue.
O que você precisa
- O Jira conectado na página de salas: um token de API, com o site e o e-mail a que ele pertence, colado uma única vez.
- Um connection_id de GET /jira/v1/connections e um project_id de GET /jira/v1/connections/{connection_id}/projects.
- A própria conversa, da API do canal por onde ela chegou — ou uma sala, onde ela já está.
Abra a issue
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"}'
O que volta traz o task_id que o Jira lhe deu — a chave da issue —, que é com o que responder ao cliente e o que alterar com um patch quando ela estiver concluída.
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"}'
A issue é aberta pelo membro cujo token é a conexão. O Jira a registra em nome dessa pessoa, então o histórico é o mesmo de quando ela mesma a digita lá.
Peça a um agente
Em uma sala de projeto com os dois agentes marcados, uma única frase faz tudo — o agente lê a conversa, abre a issue e diz qual é:
- @scout abra uma issue no Jira para o que a Dana relatou no WhatsApp hoje de manhã e avise a ela o número.
Perguntas frequentes
Um agente pode fazer isso sem que peçam a cada vez?
Pode, se as instruções dele disserem isso. Uma sala mostra cada resposta a todos que estão nela, então escreva a instrução para que ele diga o que está prestes a abrir e espere alguém responder «pode seguir» se a issue for chegar aos clientes.
E se o id do projeto estiver errado?
404, com as mesmas palavras de uma conexão que não é sua. O id de um projeto é consultado no Jira a cada chamada em vez de ser aceito como está, então um id errado não alcança nada.