Ktoś zgłasza błąd w rozmowie. Poprawka należy do Jira, gdzie zaglądają twoi programiści — nie do notatki, którą ktoś przepisze później. Jeden klucz sięga po obie strony: kanał, którym przyszła wiadomość, i projekt Jira, w którym ma się z niej stać zgłoszenie.
Czego potrzebujesz
- Jira podłączona na stronie pokoi projektowych: token API z witryną i adresem, do których należy, wklejony raz.
- connection_id z GET /jira/v1/connections i project_id z GET /jira/v1/connections/{connection_id}/projects.
- Sama rozmowa, z API kanału, którym przyszła — albo pokój, w którym już jest.
Otwórz zgłoszenie
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"}'
To, co wraca, niesie task_id, który nadała Jira — klucz zgłoszenia — i nim odpowiadasz klientowi, i nim patchujesz zgłoszenie, gdy jest gotowe.
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"}'
Zgłoszenie otwiera członek zespołu, którego tokenem jest połączenie. Jira zapisuje je jako tę osobę, więc historia jest taka sama, jakby sama je tam wpisała.
Niech zrobi to agent
W pokoju projektowym z zaznaczonymi obydwoma agentami jedno zdanie załatwia wszystko — agent czyta rozmowę, otwiera zgłoszenie i mówi, które to:
- @scout otwórz zgłoszenie w Jira dla tego, co Dana zgłosiła dziś rano na WhatsApp, i podaj jej numer.
O co ludzie pytają
Czy agent może to robić bez proszenia za każdym razem?
Może, jeśli mówią o tym jego instrukcje. Pokój pokazuje każdą odpowiedź wszystkim w nim; napisz więc instrukcję tak, żeby mówił, co zamierza otworzyć, i czekał, aż ktoś powie „dalej”, jeśli zgłoszenie miałoby dotrzeć do klientów.
Co, jeśli identyfikator projektu jest zły?
404, tymi samymi słowami co przy połączeniu, które nie jest twoje. Identyfikator projektu jest przy każdym wywołaniu sprawdzany w Jira, a nie przyjmowany na wiarę, więc zły nie sięga do niczego.