دليل إعداد التكامل

تكامل واتساب مع Zendesk: الطريقتان الصادقتان

دليل إعداد وسير عمل n8n قابل للاستيرادآخر تحقق: أكتوبر 2026

هناك طريقتان صادقتان لتشغيل واتساب مع 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. 1

    أنشئ عميل OAuth

    بعد تسجيل الدخول بحساب وكيل التكامل، أضف عميل OAuth في «Admin Center» في Zendesk، وبيانات اعتماد OAuth2 في n8n بنوع المنح «Client Credentials». ورمز API (API token) هو البديل الاحتياطي.

  2. 2

    استورد سير العمل

    افتح عقدة «Settings» فيه والصق عنوان Zendesk الخاص بك ومعرّف المستخدم لوكيل التكامل. أما المجموعة والعلامة التجارية (brand) وحقل التذكرة «Spun line» فهي اختيارية.

  3. 3

    أنشئ Webhook ومشغّل الرد في Zendesk

    Webhook موجّه إلى عنوان الرد في سير العمل، ومشغّل يستدعيه حين تتلقى تذكرة تحمل الوسم spun تعليقًا عامًا. والصق سر التوقيع الخاص بالـ Webhook في سير العمل.

  4. 4

    أنشئ مفتاح API في Spun

    «الإعدادات»، ثم «الويب هوكس»، ثم «إدارة مفاتيح API»، مع صلاحية «Send Messages». وحدّد «إغلاق وإعادة فتح المحادثات» أيضًا إذا كان حل التذكرة في Zendesk يجب أن يؤرشف المحادثة في Spun.

  5. 5

    اربط أحداث Spun بسير العمل

    أضف Webhook للرسائل الواردة والرسائل الصادرة وإغلاق المحادثة وإعادة فتحها، مع ضبط «تنسيق الحمولة» على «خام (افتراضي)»، والصق سر التوقيع الخاص به في سير العمل.

  6. 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 كاملة)

الأسئلة الشائعة

هل لدى Zendesk قناة واتساب خاصة بها؟

نعم، مبنية على Business API: رسمية ومتكاملة، لكن برقم مخصص وقواعد للقوالب ورسوم لكل رسالة ودون دعم للمجموعات. توثّق هذه الصفحة البديل: إبقاء واتساب على رقمك الحالي في Spun وإنشاء تذاكر Zendesk عبر سير عمل n8n.

هل يمكن لرسالة واتساب إنشاء تذكرة Zendesk تلقائيًا؟

نعم. مع سير العمل، تصبح كل محادثة واتساب فردية تذكرة في Zendesk لمقدّم طلب يُعثر عليه أو يُنشأ حسب رقم الهاتف، وتُضاف الرسائل اللاحقة إلى التذكرة نفسها.

هل يستطيع الوكلاء الرد على واتساب من Zendesk؟

نعم. يُرسل التعليق العام على التذكرة إلى العميل على واتساب من رقمك الحقيقي. وتُضاف الردود المرسلة من صندوق الوارد في Spun إلى التذكرة كتعليقات خاصة، فيستطيع الطرفان الرد.

أي الطريقتين أرخص؟

طريقة Spun بلا رسوم Business API على كل رسالة. كل حدث يُسلَّم إلى سير العمل يستهلك رموز الذكاء الاصطناعي من خطتك في Spun، وطريقة احتساب ذلك لاستخدام مكتب المساعدة لا تزال قيد المراجعة. أما قناة Zendesk نفسها فتضيف رسوم محادثات Business API فوق أسعار Zendesk.

دعم واتساب على رقمك أنت

يحوّل Spun رقم واتساب الحالي لديك إلى صندوق وارد مشترك للدعم مع قوائم انتظار وإسناد وملخصات بالذكاء الاصطناعي، إلى جانب Webhooks وواجهة API التي يستخدمها سير العمل هذا. تجربة مجانية.

ابدأ مجانًا: 7 أيام من كل الميزات

عرض كل التكاملات