Iemand meldt een bug in een gesprek. De oplossing hoort in Jira, waar je ontwikkelaars kijken — niet in een notitie die iemand later overtypt. Eén sleutel bereikt beide kanten: het kanaal waarop het bericht binnenkwam en het Jira-project waarin er een issue van moet worden.
Wat je nodig hebt
- Jira gekoppeld op de projectkamerpagina: een API-token met de site en het adres waartoe het behoort, één keer geplakt.
- Een connection_id uit GET /jira/v1/connections en een project_id uit GET /jira/v1/connections/{connection_id}/projects.
- Het gesprek zelf, uit de kanaal-API waarop het binnenkwam — of een kamer, waar het al is.
Het issue openen
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"}'
Wat terugkomt bevat de task_id die Jira eraan gaf — de issuesleutel — en daarmee antwoord je de klant en patch je het issue als het klaar is.
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"}'
Het issue wordt geopend door het teamlid van wie het token de koppeling is. Jira legt het vast als die persoon, dus de geschiedenis is dezelfde als wanneer die persoon het zelf had getypt.
Laat een agent het doen
In een projectkamer waarin beide agents zijn aangevinkt, doet één zin het hele werk — de agent leest het gesprek, opent het issue en zegt welk issue het is:
- @scout open een Jira-issue voor wat Dana vanochtend op WhatsApp meldde, en laat haar het nummer weten.
Veelgestelde vragen
Kan een agent dit doen zonder dat je het elke keer vraagt?
Dat kan, als zijn instructies het zeggen. Een kamer toont elk antwoord aan iedereen erin; schrijf de instructie daarom zo dat hij zegt wat hij gaat openen en wacht tot iemand “go” zegt als het issue klanten zou bereiken.
Wat als het project-id verkeerd is?
404, met dezelfde woorden als bij een koppeling die niet van jou is. Een project-id wordt bij elke aanroep in Jira opgezocht in plaats van vertrouwd, dus een verkeerd id bereikt niets.