Seseorang melaporkan bug dalam sebuah percakapan. Perbaikannya ada di Jira, tempat pengembang Anda melihat — bukan di catatan yang nanti disalin seseorang. Satu kunci menjangkau kedua sisi: kanal tempat pesan itu masuk, dan proyek Jira tempat pesan itu seharusnya menjadi isu.
Yang Anda butuhkan
- Jira terhubung di halaman ruang proyek: token API beserta situs dan alamat pemiliknya, ditempel sekali.
- connection_id dari GET /jira/v1/connections, dan project_id dari GET /jira/v1/connections/{connection_id}/projects.
- Percakapannya sendiri, dari API kanal mana pun tempat ia masuk — atau sebuah ruang, tempat ia sudah ada.
Buka isunya
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"}'
Yang dikembalikan membawa task_id yang diberikan Jira — kunci isunya — yang dipakai untuk menjawab pelanggan dan untuk di-patch saat selesai.
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"}'
Isu dibuka oleh anggota yang tokennya dipakai koneksi itu. Jira mencatatnya atas nama orang itu, jadi riwayatnya sama seperti kalau mereka mengetiknya sendiri.
Minta agen yang mengerjakannya
Di ruang proyek dengan kedua agen dicentang, satu kalimat menyelesaikan semuanya — agen membaca percakapan, membuka isu, dan menyebutkan isu yang mana:
- @scout buka isu Jira untuk apa yang dilaporkan Dana di WhatsApp pagi ini, dan beri tahu dia nomornya.
Pertanyaan yang sering diajukan
Bisakah agen melakukan ini tanpa diminta setiap kali?
Bisa, jika instruksinya menyatakan demikian. Ruang menampilkan setiap balasan kepada semua orang di dalamnya, jadi tulis instruksi agar agen menyebutkan apa yang akan dibukanya dan menunggu seseorang berkata “lanjut” jika isu itu akan sampai ke pelanggan.
Bagaimana jika id proyeknya salah?
404, dengan kata-kata yang sama seperti koneksi yang bukan milik Anda. ID proyek dicari di Jira pada setiap panggilan, bukan dipercaya begitu saja, jadi yang salah tidak menjangkau apa pun.