Jemand meldet in einer Unterhaltung einen Fehler. Die Behebung gehört in Jira, wo Ihre Entwickler hinschauen — nicht in eine Notiz, die später jemand überträgt. Ein Schlüssel erreicht beide Seiten: den Kanal, auf dem die Nachricht ankam, und das Jira-Projekt, in dem daraus ein Vorgang werden soll.
Was Sie brauchen
- Jira auf der Projektraum-Seite verbunden: ein API-Token mit der Site und der Adresse, zu der es gehört, einmal eingefügt.
- Eine connection_id aus GET /jira/v1/connections und eine project_id aus GET /jira/v1/connections/{connection_id}/projects.
- Die Unterhaltung selbst, aus der Kanal-API, über die sie ankam — oder ein Raum, in dem sie schon ist.
Den Vorgang anlegen
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"}'
Die Antwort enthält die task_id, die Jira vergeben hat — seinen Vorgangsschlüssel —, mit der Sie dem Kunden antworten und die Sie patchen, wenn der Vorgang erledigt ist.
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"}'
Der Vorgang wird von dem Mitglied angelegt, dessen Token die Verbindung ist. Jira verzeichnet ihn unter dieser Person, die Historie ist also dieselbe, als hätte sie ihn selbst eingetippt.
Einen Agenten das erledigen lassen
In einem Projektraum, in dem beide Agenten angekreuzt sind, erledigt ein Satz alles — der Agent liest die Unterhaltung, legt den Vorgang an und sagt, welcher es ist:
- @scout legen Sie einen Jira-Vorgang für das an, was Dana heute Morgen auf WhatsApp gemeldet hat, und nennen Sie ihr die Nummer.
Häufige Fragen
Kann ein Agent das tun, ohne jedes Mal gefragt zu werden?
Er kann es, wenn seine Anweisungen es vorsehen. Ein Raum zeigt jede Antwort allen darin; schreiben Sie die Anweisung deshalb so, dass der Agent sagt, was er anlegen will, und auf ein Go wartet, wenn der Vorgang Kunden erreichen würde.
Was, wenn die Projekt-ID falsch ist?
404, mit denselben Worten wie bei einer Verbindung, die nicht Ihre ist. Eine Projekt-ID wird bei jedem Aufruf in Jira nachgeschlagen, statt ihr zu vertrauen; eine falsche erreicht also nichts.