هناك طريقتان صادقتان لتشغيل واتساب مع Zendesk، وهما مختلفتان جدًا. الطريقة الأولى هي قناة واتساب الخاصة بـ Zendesk: رسمية ومبنية على Business API، ما يعني رقمًا مخصصًا، وموافقات على القوالب، ورسومًا على كل رسالة، ولا مجموعات واتساب. أما الطريقة الثانية فتبقي واتساب على الرقم الذي تستخدمه أصلًا، مع Spun كمساحة عمل واتساب، وسير عمل يربط واتساب بـ Zendesk في n8n الخاص بك ويحوّل كل محادثة إلى تذكرة Zendesk.
توثّق هذه الصفحة الطريقة الثانية، وتوضح بصراحة متى تكون الطريقة الأولى هي الأنسب: إذا كانت عمليات الدعم لديك كلها داخل Zendesk وتريد واتساب قناة تذاكر إضافية وفق اقتصاديات API، فاستخدم قناة Zendesk. وإذا كان واتساب قناتك الأساسية مع العملاء وZendesk نظامًا واحدًا من عدة أنظمة، فإن إبقاءه على رقمك الحقيقي مع صندوق وارد للفريق يخدم العملاء عادةً بشكل أفضل.
1. تذاكر Zendesk من واتساب: ما الذي يفعله سير العمل
كل محادثة واتساب فردية على الخط تصبح تذكرة في Zendesk، دون الحاجة إلى تطبيق تسمية أولًا. وتُضاف الرسائل اللاحقة إلى التذكرة نفسها، ويعود التعليق العام الذي يكتبه الوكيل إلى العميل على واتساب.
- مقدّم الطلب مستخدم في Zendesk يعثر عليه سير العمل أو ينشئه لرقم هاتف العميل، وتُنشأ التذكرة لهذا المستخدم.
- تُرسل تعليقات الوكلاء العامة في Zendesk إلى العميل على واتساب كنص، من رقمك أنت. وتبقى التعليقات الخاصة داخلية.
- الردود التي يرسلها فريقك من صندوق الوارد في Spun تصبح تعليقات خاصة على التذكرة، فيستطيع الطرفان الرد وتحتفظ التذكرة بالمحادثة كاملة.
- أرشفة المحادثة في Spun تحل التذكرة، وإلغاء الأرشفة يعيد فتحها. ويمكن أن يؤدي حل التذكرة في Zendesk إلى أرشفة المحادثة في Spun أيضًا، وهو خيار يبقى معطلًا حتى تفعّله. ولا يرسل سير العمل أي رسالة حالة إلى العميل في الحالتين.
- يُرسل كل رد مع معرّف تعليق Zendesk كمفتاح منع التكرار، فلا يُرسل الرد مرتين عند إعادة المحاولة.
تُتجاوز الدردشات الجماعية. وتصل الوسائط إلى التذكرة كرابط يبقى صالحًا لمدة 24 ساعة.
2. الإعداد
تحتاج إلى مسؤول في Zendesk يستطيع إنشاء Webhooks ومشغّلات (triggers) وعميل OAuth، ووكيل تكامل مثل «Spun WhatsApp»، ونسخة n8n يستطيع Zendesk وSpun الوصول إليها عبر HTTPS. ويسرد دليل الإعداد كل قيمة ومكان العثور عليها.
- 1
أنشئ عميل OAuth
بعد تسجيل الدخول بحساب وكيل التكامل، أضف عميل OAuth في «Admin Center» في Zendesk، وبيانات اعتماد OAuth2 في n8n بنوع المنح «Client Credentials». ورمز API (API token) هو البديل الاحتياطي.
- 2
استورد سير العمل
افتح عقدة «Settings» فيه والصق عنوان Zendesk الخاص بك ومعرّف المستخدم لوكيل التكامل. أما المجموعة والعلامة التجارية (brand) وحقل التذكرة «Spun line» فهي اختيارية.
- 3
أنشئ Webhook ومشغّل الرد في Zendesk
Webhook موجّه إلى عنوان الرد في سير العمل، ومشغّل يستدعيه حين تتلقى تذكرة تحمل الوسم spun تعليقًا عامًا. والصق سر التوقيع الخاص بالـ Webhook في سير العمل.
- 4
أنشئ مفتاح API في Spun
«الإعدادات»، ثم «الويب هوكس»، ثم «إدارة مفاتيح API»، مع صلاحية «Send Messages». وحدّد «إغلاق وإعادة فتح المحادثات» أيضًا إذا كان حل التذكرة في Zendesk يجب أن يؤرشف المحادثة في Spun.
- 5
اربط أحداث Spun بسير العمل
أضف Webhook للرسائل الواردة والرسائل الصادرة وإغلاق المحادثة وإعادة فتحها، مع ضبط «تنسيق الحمولة» على «خام (افتراضي)»، والصق سر التوقيع الخاص به في سير العمل.
- 6
أرسل رسالة اختبار
راسل الخط من هاتف آخر. ستظهر تذكرة في Zendesk؛ رد بتعليق عام وسيصل الرد إلى الهاتف.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "14155552671",
"text": "Thanks for waiting, your replacement ships today.",
"idempotency_key": "<Zendesk comment id>"
}ذات صلة: الوثائق: Zendesk عبر n8n، دليل الإعداد الكامل · واتساب + n8n: واجهة API وWebhooks التي يقوم عليها
ما يجب معرفته قبل أن تبدأ البناء
- هذا جسر وليس دمجًا للقنوات: محادثات واتساب تبقى في Spun، والتذاكر في Zendesk، وسير العمل يبقيهما متزامنين. إذا كنت تحتاج واتساب كقناة في Zendesk برقمها الخاص، فهذه هي الطريقة الأولى بتكاليفها وحدودها.
- إنه سير عمل n8n تستورده، وليس تطبيقًا من سوق تطبيقات Zendesk. يستخدم جانب Spun مفتاح API، ويستخدم جانب Zendesk عميل OAuth.
- الإغلاق من Zendesk يستدعي نقاط نهاية الإغلاق وإعادة الفتح في Spun، والتي تتطلب صلاحية «إغلاق وإعادة فتح المحادثات» على المفتاح.
- يسمح Zendesk بـ 30 تحديثًا لكل تذكرة كل 10 دقائق، و5 مستخدمين جدد في الدقيقة، و5,000 تعليق لكل تذكرة. وتسمح واجهة Spun API بـ 60 طلبًا في الدقيقة لكل مفتاح.
- كل حدث يُسلَّم يستهلك رموز الذكاء الاصطناعي من خطتك في Spun. وطريقة احتساب ذلك لاستخدام مكتب المساعدة لا تزال قيد المراجعة.
- تكتشف فرق كثيرة أن طبقة التذاكر كانت الجزء الاختياري: فالتسميات والإسناد والمهام في Spun تغطي التذاكر القائمة على الدردشة وحدها. راجع صفحة مكتب المساعدة على واتساب.
ذات صلة: واتساب كمكتب مساعدة بحد ذاته (دون الحاجة إلى Zendesk) · كل تكاملات مكتب المساعدة لواتساب · واتساب + Zapier وMake (واجهة API كاملة)