يُبقي Spun واتساب على الرقم الذي يستخدمه عملاؤك أصلًا ويربطه بـ Jira Service Management عبر سير عمل في n8n الخاص بك. تصبح كل محادثة واتساب طلبًا في مشروع الخدمة لديك، وتُضاف الرسائل اللاحقة كتعليقات، ويعود التعليق العام الذي يكتبه الموظف إلى العميل على واتساب.
هذا هو إعداد واتساب مع Jira Service Management للفرق التي تتابع الدعم في Jira أصلًا: يواصل الموظفون العمل على الطلبات حيث هي، ويواصل العملاء المراسلة حيث هم. يبقى رمز API الخاص بـ Jira في n8n لديك؛ ولا يتلقاه Spun ولا يخزّنه أبدًا.
ما الذي يفعله سير عمل واتساب مع Jira Service Management
- تفتح الرسالة الأولى في المحادثة طلبًا من نوع الطلب الذي تختاره، مع اسم العميل ورقمه ورسالته في الوصف، والرقم في حقل لرقم واتساب.
- تُضاف الرسائل اللاحقة إلى الطلب المفتوح كتعليقات عامة، مسبوقة باسم المرسل ورقمه.
- يُرسَل التعليق العام الذي يكتبه الموظف إلى العميل على واتساب كنص. أما التعليقات الداخلية فلا تغادر Jira أبدًا.
- تُضاف الردود التي يرسلها فريقك من صندوق الوارد في Spun كتعليقات داخلية، فيمكن الرد من الجانبين.
- تُشغّل أرشفة المحادثة في Spun انتقال الحل (resolve transition) الذي حدّدته، وإلغاء الأرشفة يعيد فتح الطلب عند ضبط انتقال لإعادة الفتح. ويمكن أن يؤدي حل الطلب في Jira إلى أرشفة المحادثة في Spun أيضًا، وهو خيار يبقى معطّلًا حتى تفعّله.
يُفتح كل طلب بواسطة حساب تكامل واحد، وهو موظف (agent) في مشروع الخدمة. لا يُنشئ سير العمل عملاء Jira ولا يطابقهم، لذا تذهب إشعارات العملاء التي يرسلها Jira لهذه الطلبات إلى صندوق بريد ذلك الحساب، لا إلى العميل.
الإعداد خطوة بخطوة
تحتاج إلى موقع Jira Service Management فيه مشروع خدمة، وحساب تكامل يكون موظفًا (agent) في ذلك المشروع (ويعتمد احتساب مقعده في الفوترة على خطة Jira لديك)، ومسؤول Jira مرة واحدة لإنشاء Webhook، ونسخة n8n يمكن لـ Jira وSpun الوصول إليها عبر HTTPS.
- 1
أنشئ رمز API لحساب التكامل
بعد تسجيل الدخول بذلك الحساب، أنشئ رمز API واحفظه في n8n كبيانات اعتماد من نوع «Basic Auth». ويبقى الرمز في n8n لديك.
- 2
أضف حقلًا باسم «رقم واتساب»
حقل نصي قصير في نوع الطلب الذي يجب أن تستخدمه محادثات واتساب.
- 3
ابحث عن الانتقالات لديك
الانتقال الذي يحل الطلب، وبشكل اختياري انتقال يعيد فتحه.
- 4
استورد سير العمل
افتح عقدة «Settings» فيه والصق رابط موقعك، ومكتب الخدمة (service desk)، ونوع الطلب، ومفتاح المشروع، ومعرّف الحقل، والانتقالات، ومعرّف حساب التكامل.
- 5
أنشئ Webhook في Jira
بصفتك مسؤول Jira، أنشئ Webhook إلى رابط الرد الخاص بسير العمل على الحدث «Comment: created»، مع فلتر JQL يقصره على مشروعك، ومحميًا بسر. يوقّع Jira كل عملية تسليم، ويتحقق سير العمل من التوقيع.
- 6
أنشئ مفتاح API في Spun
«الإعدادات»، ثم «الويب هوكس»، ثم «إدارة مفاتيح API»، مع صلاحية «Send Messages». وحدّد أيضًا «إغلاق وإعادة فتح المحادثات» إذا كان حل الطلب في Jira يجب أن يؤرشف المحادثة في Spun.
- 7
وجّه أحداث Spun إلى سير العمل
أضف Webhook لأحداث «رسالة واردة» و«رسالة صادرة» و«تم إغلاق المحادثة» و«تم إعادة فتح المحادثة»، مع ضبط «تنسيق الحمولة» على «خام (افتراضي)»، ثم الصق سر التوقيع الخاص به في سير العمل.
- 8
أرسل رسالة تجريبية
راسل الرقم من هاتف آخر. سيظهر طلب في Jira؛ أضف تعليقًا عامًا بصفتك موظفًا وسيصل الرد إلى الهاتف.
ذات صلة: الوثائق: Jira Service Management عبر n8n، دليل الإعداد الكامل · واتساب + n8n: واجهة API والـ Webhooks التي يقوم عليها
ما يجب معرفته قبل البناء
- تُتخطّى محادثات المجموعات.
- تصل الوسائط إلى الطلب كرابط صالح لمدة 24 ساعة، لا كمرفق في Jira. والردود من Jira نصية فقط؛ ولا تُمرَّر المرفقات الموجودة على تعليق.
- يقبل Jira 20 عملية كتابة على طلب واحد خلال 2 ثانية، و100 خلال 30 ثانية. وخلال دفعة طويلة من الرسائل، لا تُضاف الرسائل الزائدة إلى الطلب؛ بل تبقى في صندوق الوارد في Spun، ويمكن تكرار تشغيل n8n.
- طلب مفتوح واحد لكل محادثة. وتُقتطع التعليقات التي يزيد طولها على 32,000 حرف.
- يستهلك كل حدث يتم تسليمه رموز ذكاء اصطناعي من خطتك في Spun. ولا تزال طريقة احتساب ذلك لاستخدام مكتب المساعدة قيد المراجعة.
ذات صلة: كل تكاملات واتساب مع مكاتب المساعدة · واتساب كمكتب مساعدة بحد ذاته