پیوندهای واکنش‌ها

واکنش‌ها به‌ندرت به‌تنهایی کار می‌کنند — از طریق دکمه‌ها، زنجیره‌ها، شاخه «وگرنه»، پاسخ‌های مکالمه و غیره یکدیگر را فراخوانی می‌کنند. پیوندهای واکنش‌ها این نمودار انتقال را نشان می‌دهند: برای هر واکنش مشخص است به کجا می‌رود (پیوندهای خروجی) و از کجا وارد می‌شود (پیوندهای ورودی). این کمک می‌کند در سناریوهای بزرگ گم نشوید و واکنش‌ها را با اطمینان حذف کنید.

پیوند چیست

پیوند یک انتقال جهت‌دار از یک واکنش به واکنش دیگر است که با مکانیزمی که این انتقال را ایجاد کرده علامت‌گذاری شده. پلتفرم واکنش را به‌طور کامل پیمایش می‌کند، تمام انتقال‌های خروجی را جمع‌آوری می‌کند، ارجاع به خود را حذف می‌کند و اهداف خالی را نادیده می‌گیرد، و انتقال‌های تکراری را ادغام می‌کند. فهرست پیوندها از ویرایشگر واکنش و از طریق API در دسترس است: GET /api/bots/{id}/reactions/{id}/links.

ورودی و خروجی

  • خروجی — واکنش‌هایی که واکنش جاری به آن‌ها ارجاع دارد (دکمه‌ها، زنجیره‌ها، شاخه «وگرنه» و غیره).
  • ورودی — واکنش‌هایی که به واکنش جاری ارجاع دارند. قبل از حذف مفید است: اگر کسی به واکنش ارجاع دارد، حذف سناریو را خواهد شکست.

۱۲ مکانیزم پیوند

  • دکمه (button) — دکمه inline از نوع «فراخوانی واکنش» با کلیک واکنش دیگری را باز می‌کند.
  • جایگزینی با دکمه (button_replace) — دکمه با رفتار «جایگزینی پیام» محتوای واکنش مرتبط را درج می‌کند.
  • دکمه پویا (dynamic_button) — دکمه از بلوک «دکمه‌های پویا از فهرست» به واکنش می‌رود. ببینید دکمه‌های پویا و پارامترها.
  • بلوک «واکنش» (block) — بلوک پیامی که در حین ارسال واکنش دیگری را فراخوانی می‌کند.
  • واکنش زنجیره‌ای (chain) — اقدام «واکنش زنجیره‌ای» واکنش دیگری را راه‌اندازی می‌کند.
  • شاخه «وگرنه» (else) — اگر شرط‌ها برآورده نشدند، کنترل به واکنش مشخص‌شده می‌رود.
  • درخواست وب: موفق (web_success) — واکنشی که در درخواست وب موفق اجرا می‌شود.
  • درخواست وب: خطا (web_error) — واکنشی که در خطای درخواست وب اجرا می‌شود.
  • پاسخ مورد انتظار (expected_answer) — واکنشی که در پاسخ کاربر در گام مکالمه اجرا می‌شود.
  • تایم‌اوت انتظار (expected_timeout) — واکنشی که اگر تا تایم‌اوت پاسخی نیامد اجرا می‌شود.
  • واکنش بعدی (goto_next) — اقدام «واکنش بعدی» کنترل را به واکنش مناسب بعدی در فهرست منتقل می‌کند.
  • سناریو (flow) — واکنشی که به تکمیل سناریو (flow) متصل است.

چرا نمودار را بررسی کنیم

  • ناوبری در سناریو — به‌سرعت به واکنش مرتبط بروید بدون اینکه در فهرست دنبالش بگردید.
  • حذف ایمن — پیوندهای ورودی را ببینید و انتقال‌ها را نشکنید.
  • ممیزی — بررسی کنید که همه شاخه‌های سناریو به‌جای درست می‌روند و انتقال «آویزان» وجود ندارد.

بیشتر بخوانید