يبلّغ أحدهم عن عطل في محادثة. وإصلاحه مكانه Jira حيث ينظر مطوّروك، لا ملاحظة سينسخها أحدهم لاحقاً. ومفتاح واحد يصل إلى الجانبين: القناة التي وصلت منها الرسالة، ومشروع Jira الذي ينبغي أن تصير فيه مشكلة.
ما تحتاج إليه
- ربط Jira في صفحة الغرف: رمز API مع الموقع وعنوان البريد الإلكتروني الذي يعود إليه، يُلصق مرة واحدة.
- معرّف connection_id من GET /jira/v1/connections، ومعرّف project_id من GET /jira/v1/connections/{connection_id}/projects.
- المحادثة نفسها، من واجهة القناة التي وصلت عبرها — أو من غرفة هي فيها أصلاً.
افتح المشكلة
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"}'
ما يعود إليك يحمل task_id الذي أعطاه Jira إياها — أي مفتاح المشكلة — وهو ما تجيب به العميل، وما تعدّله بـ patch عند الانتهاء.
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"}'
تُفتح المشكلة باسم العضو الذي يعود إليه الرمز المستخدم في الربط. ويسجّلها Jira باسم ذلك الشخص، فيكون السجل كما لو كتبها بنفسه.
اترك الأمر لوكيل
في غرفة مشروع حدّدتَ فيها الوكيلين معاً، تكفي جملة واحدة — يقرأ الوكيل المحادثة، ويفتح المشكلة، ويقول أيّ مشكلة هي:
- @scout افتح مشكلة في Jira بخصوص ما أبلغت عنه Dana على WhatsApp هذا الصباح، وأخبرها بالرقم.
أسئلة شائعة
هل يستطيع الوكيل فعل ذلك دون أن يُطلب منه كل مرة؟
يستطيع إن قالت تعليماته ذلك. والغرفة تعرض كل ردّ على كل من فيها، فاكتب التعليمات بحيث يقول ما هو على وشك فتحه وينتظر أن يقول أحدهم «تابع» إن كانت المشكلة ستصل إلى العملاء.
ماذا لو كان معرّف المشروع خاطئاً؟
404، بالكلمات نفسها التي يُردّ بها عن ربط ليس لك. ومعرّف المشروع يُبحث عنه في Jira عند كل استدعاء بدل أن يُصدَّق، فالمعرّف الخاطئ لا يصل إلى شيء.