الانتقال إلى المحتوى الرئيسي
عندما يملك نظام داخلي رسائل عملاء لا تمر بقناة جاهزة، تحتاج جسراً واضحاً إلى الوارد دون خلطه بأتمتة عامة. تنشئ قناة ويب هوك وارد عنوان استقبال بمخطط ثابت فتنشأ المحادثة في البريد الوارد عند POST ناجح. يشرح هذا الدليل حدود القناة، وكيف تملأ النموذج وترسل حمولة تجريبية، وما الحقول التي تهم التشغيل. في الإضافة: ويب هوك وارد · /channels?add=webhook.

وضّح الحدود أولاً

إن احتجت المنصة أن تستدعي نظاماً خارجياً: ابنِ ذلك داخل مسار أتمتة بطلب HTTP. إن احتجت تطبيق متجر جاهز: راجع التطبيقات.

التعريف والأثر

قبل أن تبدأ

  • نظام خارجي يستطيع إرسال POST إلى عنوان الاستقبال
  • قسم في كرزون
  • فهم الحدود أعلاه: مخطط ثابت لمحادثة واردة — ليس مشغّل أتمتة عاماً

الخطوات

1

افتح إنشاء ويب هوك

القنوات ← إنشاء جديد ← ويب هوك وارد.
نافذة إنشاء ويب هوك بالحقول الاسم والرمز والقسم

نموذج إنشاء ويب هوك وارد

2

عبّئ النموذج

  • الاسم (مطلوب، 2–100 حرفاً)
  • الرمز المميز (اختياري — يُولَّد إن تُرك فارغاً)
  • المصدر / Origin (اختياري — تقييد بالمصدر)
  • السكريبت (اختياري — تحويل بسيط للبيانات قبل المعالجة)
  • القسم (مطلوب)
تعبئة نموذج قناة ويب هوك وارد

ملء الاسم والرمز والقسم

3

احفظ وانسخ بيانات الاستدعاء

بعد الإنشاء استخدم معرّف القناة والرمز في نظامك. الطلب يذهب إلى مسار الاستقبال الخاص بالتكامل.
عنوان استقبال ويب هوك وارد وزر نسخ الرمز

نسخ عنوان الاستقبال والرمز

4

أرسل حمولة تجريبية

أرسل content مع بيانات عميل بسيطة وتأكد من ظهور المحادثة في البريد الوارد.
نتيجة POST تجريبي كمحادثة في البريد الوارد

حمولة تجريبية تظهر كمحادثة في الوارد

من النموذج حتى محادثة الاختبار

المخطط الثابت (ما يهم المشغّل)

جسم الطلب يدعم حقولاً محددة — أهمها للتشغيل: التحقق: يجب أن يمرّر الطلب قيمة تطابق الرمز أو الأصل المعرّفين على القناة (حسب ما ضبطت). هناك أيضاً حماية تكرار قصيرة لنفس المحتوى والعميل — لا ترسل نفس التجربة مرات متتالية وتتوقع محادثات جديدة فورية.
الرد الآلي للبوت غير مدعوم على قناة ويب هوك وارد في المسار الحالي. صمّم التسليم للفريق البشري أو عالج المنطق في نظامك قبل الإرسال.

بعد الربط

للتوثيق البرمجي الأوسع (GraphQL، مفاتيح، ويب هوك مطوّر): تبويب المطوّرين — خارج مركز المساعدة التشغيلي.

أخطاء شائعة

ما بعد الخطوات

إن بقيت المشكلة بعد الخطوات → الحصول على الدعم.

الخطوة التالية

تعلّمت حدود الوارد الثابت وكيف تختبر POST. بعد ذلك:

ذات صلة

آخر تعديل في ٩ أغسطس ٢٠٢٦