روابط التفاعلات

نادراً ما تعمل التفاعلات بشكل منفرد — فهي تستدعي بعضها عبر الأزرار والسلاسل وفرع «وإلا» وردود الحوار وغيرها. روابط التفاعلات تعرض مخطط هذه الانتقالات: لأي تفاعل يُرى إلى أين يقود (الروابط الصادرة) ومن أين يُستدعى (الروابط الواردة). يساعد ذلك على عدم الضياع في السيناريوهات الكبيرة وحذف التفاعلات بأمان.

ما هو الرابط

الرابط انتقال موجَّه من تفاعل إلى آخر، مُعلَّم بـ آلية أنشأت هذا الانتقال. تجوب المنصة التفاعل كاملاً وتجمع جميع الانتقالات الصادرة، متجاهلةً الإشارات إلى نفس التفاعل والأهداف الفارغة، وتدمج الانتقالات المتطابقة. قائمة الروابط متاحة من محرر التفاعل وعبر API: GET /api/bots/{id}/reactions/{id}/links.

الواردة والصادرة

  • الصادرة — إلى أي تفاعلات يُشير الحالي (أزراره وسلاسله وفرع «وإلا» وما إلى ذلك).
  • الواردة — أي تفاعلات تُشير إلى الحالي. مفيد قبل الحذف: إن كان ثمة من يُشير إلى التفاعل، سيُفكّك الحذف السيناريو.

12 آلية ربط

  • زر (button) — زر مضمّن من نوع «استدعاء تفاعل» يفتح تفاعلاً آخر عند النقر.
  • استبدال بالزر (button_replace) — زر بسلوك «استبدال الرسالة» يضع محتوى التفاعل المرتبط.
  • زر ديناميكي (dynamic_button) — زر من كتلة «الأزرار الديناميكية من القائمة» يقود إلى تفاعل. راجع الأزرار الديناميكية والمعاملات.
  • كتلة «تفاعل» (block) — كتلة رسالة تستدعي تفاعلاً آخر أثناء الإرسال.
  • تفاعل متسلسل (chain) — إجراء «تفاعل متسلسل» يُشغِّل تفاعلاً آخر.
  • فرع «وإلا» (else) — إن لم تتحقق الشروط ينتقل التحكم إلى التفاعل المحدد.
  • طلب الويب: نجاح (web_success) — التفاعل الذي يُشغَّل عند نجاح طلب الويب.
  • طلب الويب: خطأ (web_error) — التفاعل الذي يُشغَّل عند خطأ طلب الويب.
  • رد منتظر (expected_answer) — التفاعل الذي يُفعَّل برد المستخدم في خطوة الحوار.
  • انتهاء مهلة الانتظار (expected_timeout) — التفاعل الذي يُفعَّل إن لم يأتِ رد قبل انتهاء المهلة.
  • التفاعل التالي (goto_next) — إجراء «التفاعل التالي» ينقل التحكم إلى التفاعل التالي المناسب في القائمة.
  • سيناريو (flow) — التفاعل المرتبط بانتهاء سيناريو (flow).

لماذا ننظر في المخطط

  • التنقل في السيناريو — الانتقال السريع إلى تفاعل مرتبط دون البحث في القائمة.
  • الحذف الآمن — رؤية الروابط الواردة وعدم كسر الانتقالات.
  • المراجعة — التحقق من أن جميع فروع السيناريو تقود إلى المكان الصحيح وعدم وجود انتقالات «معلّقة».

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