Biri bir sohbette bir hata bildirir. Düzeltmenin yeri, geliştiricilerinizin baktığı Jira'dır — birinin sonra aktaracağı bir not değil. Tek bir anahtar iki tarafa da ulaşır: mesajın geldiği kanala ve ondan kayıt açılacak Jira projesine.
Neye ihtiyacınız var
- Jira, proje odaları sayfasında bağlı: site ve ait olduğu adresle birlikte bir API token'ı, bir kez yapıştırılmış.
- GET /jira/v1/connections adresinden bir connection_id ve GET /jira/v1/connections/{connection_id}/projects adresinden bir project_id.
- Sohbetin kendisi, geldiği kanalın API'sinden — ya da zaten içinde olduğu bir oda.
Kaydı açın
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"}'
Dönen yanıt, Jira'nın verdiği task_id'yi — kayıt anahtarını — taşır; müşteriye onunla yanıt verirsiniz ve iş bitince onu patch'lersiniz.
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"}'
Kaydı, bağlantının token'ı kimin ise o üye açar. Jira bunu o kişi olarak kaydeder; yani geçmiş, kişi onu kendisi yazmış gibi aynıdır.
Bir ajana yaptırın
İki ajanın da işaretli olduğu bir proje odasında tek cümle hepsini yapar — ajan sohbeti okur, kaydı açar ve hangisi olduğunu söyler:
- @scout Dana'nın bu sabah WhatsApp'ta bildirdiği şey için bir Jira kaydı aç ve ona numarasını söyle.
İnsanların sorduğu sorular
Bir ajan bunu her seferinde istenmeden yapabilir mi?
Talimatları öyle diyorsa yapabilir. Bir oda her yanıtı içindeki herkese gösterir; bu yüzden talimatı, ajanın neyi açmak üzere olduğunu söylemesi ve kayıt müşterilere ulaşacaksa birinin “devam” demesini beklemesi şeklinde yazın.
Proje kimliği yanlışsa ne olur?
404, sizin olmayan bir bağlantıyla aynı sözcüklerle. Bir proje kimliğine güvenilmez, her çağrıda Jira'da aranır; yani yanlış olan hiçbir şeye ulaşmaz.