Quelqu'un signale un bug dans une conversation. Le correctif a sa place dans Jira, là où regardent vos développeurs, pas dans une note que quelqu'un recopiera plus tard. Une seule clé atteint les deux côtés : le canal par lequel le message est arrivé et le projet Jira dans lequel il doit devenir un ticket.
Ce qu'il vous faut
- Jira connecté sur la page des salles : un jeton d'API, avec le site et l'adresse e-mail à laquelle il appartient, collé une seule fois.
- Un connection_id obtenu avec GET /jira/v1/connections, et un project_id obtenu avec GET /jira/v1/connections/{connection_id}/projects.
- La conversation elle-même, depuis l'API du canal par lequel elle est arrivée — ou une salle, où elle se trouve déjà.
Ouvrez le ticket
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"}'
Ce qui revient porte le task_id que Jira lui a donné — sa clé de ticket —, c'est avec lui qu'il faut répondre au client et c'est lui qu'il faut modifier avec un patch quand le ticket est terminé.
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"}'
Le ticket est ouvert par le membre dont le jeton est la connexion. Jira l'enregistre à son nom, de sorte que l'historique est le même que s'il l'avait tapé lui-même.
Laissez un agent le faire
Dans une salle de projet où les deux agents sont cochés, une seule phrase suffit : l'agent lit la conversation, ouvre le ticket et dit lequel c'est :
- @scout ouvre un ticket Jira pour ce que Dana a signalé sur WhatsApp ce matin, et dis-lui le numéro.
Questions fréquentes
Un agent peut-il le faire sans qu'on le lui demande à chaque fois ?
Oui, si ses instructions le disent. Une salle montre chaque réponse à tous ceux qui s'y trouvent, alors écrivez l'instruction pour qu'il dise ce qu'il s'apprête à ouvrir et attende que quelqu'un réponde « go » si le ticket doit atteindre des clients.
Et si l'identifiant du projet est faux ?
404, avec les mêmes mots qu'une connexion qui n'est pas la vôtre. L'identifiant d'un projet est recherché dans Jira à chaque appel au lieu d'être pris tel quel, donc un identifiant erroné n'atteint rien.