Qualcuno segnala un bug in una conversazione. La correzione va in Jira, dove guardano i vostri sviluppatori, non in una nota che qualcuno copierà più tardi. Un'unica chiave raggiunge entrambi i lati: il canale da cui è arrivato il messaggio e il progetto Jira in cui deve diventare una issue.
Cosa vi serve
- Jira collegato nella pagina delle stanze: un token API, con il sito e l'indirizzo e-mail a cui appartiene, incollato una sola volta.
- Un connection_id da GET /jira/v1/connections e un project_id da GET /jira/v1/connections/{connection_id}/projects.
- La conversazione stessa, dall'API del canale da cui è arrivata — oppure una stanza, dove si trova già.
Aprite la 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"}'
Ciò che torna indietro porta il task_id che Jira le ha dato — la sua chiave di issue —, che è ciò con cui rispondere al cliente e ciò che va modificato con un patch quando è conclusa.
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 issue viene aperta dal membro il cui token è la connessione. Jira la registra a nome di quella persona, quindi la cronologia è la stessa che se l'avesse scritta lì.
Lasciatelo fare a un agente
In una stanza di progetto con entrambi gli agenti spuntati, basta una frase: l'agente legge la conversazione, apre la issue e dice quale è:
- @scout apri una issue Jira per ciò che Dana ha segnalato stamattina su WhatsApp e dille il numero.
Domande frequenti
Un agente può farlo senza che glielo si chieda ogni volta?
Può, se le sue istruzioni lo dicono. Una stanza mostra ogni risposta a tutti quelli che ci sono, quindi scrivete l'istruzione in modo che dica cosa sta per aprire e aspetti che qualcuno risponda «vai» se la issue dovesse arrivare ai clienti.
E se l'id del progetto è sbagliato?
404, con le stesse parole di una connessione che non è vostra. L'id di un progetto viene cercato in Jira a ogni chiamata invece di essere dato per buono, quindi uno sbagliato non raggiunge nulla.