Параметри ноди «Підключення до оператора»

Нода Підключення до оператора (action_operator_panel__connect_to_operator_with_msg) створює чат-кімнату та підключає клієнта до оператора. Після виконання діалог відображається в операторській панелі. У Node Inspector (панель справа) доступні такі секції:

Звідки береться форма в інтерфейсі

Поля в інспекторі та їх групування будуються з json_config відповного action у Action Jail (поля parameters, блок ui.groups, за потреби events_schema). Тому для AI-агентів і інтеграторів важливо: не вигадувати назви параметрів — орієнтуватися на форму в конструкторі або на технічний опис у docs/developer/engine/actions/operator_panel__connect_to_operator_with_msg.md.

Події на полотні (гілки сценарію)

Після виконання action рушій повертає одну з гілок (подій). На полотні вони відображаються як окремі виходи з ноди (у порядку, заданому схемою подій). Типовий набір:

Подія (гілка)Коли виникає
successЧат створено, клієнта підключено до оператора
bannedКористувач у бані (активне блокування)
limitНемає доступних операторів (ліміт навантаження)
errorПомилка створення чату або інший збій виконання

Кожну гілку потрібно з’єднати з наступними нодами на полотні (окремі ребра). Це не ті самі кнопки, що параметри add_button / add_return_button (див. нижче) — події описують результат виконання action, а додаткові кнопки в інтерфейсі оператора/клієнта налаштовуються окремими полями JSON-конфіга.

Основні налаштування

  • Тема звернення (subject_alias) — тема, під якою створюється чат (вибір з налаштованих тем).
  • Автоматичне підключення (auto_connect_operator) — чи підключати вільного оператора автоматично.
  • Призначений оператор (assigned_operator) — конкретний оператор (якщо не використовується авто-підключення).
  • Теги (tag_ids) — теги, які додаються до звернення при підключенні.

Кнопки в чаті (параметри JSON)

  • Додати кнопку (add_button) — додати кнопку закриття чату в контексті операторської панелі (тексти з констант бота).
  • Додати кнопку повернення (add_return_button) — кнопка повернення до автоматичного діалогу (текст з констант).

Це сервісні опції інтерфейсу чату, а не «події на полотні» з розділу вище.

Таймаути

  • Таймаут передачі (transfer_timeout) — скільки секунд чекати відповіді оператора перед автоматичним переходом (якщо налаштовано).

Повідомлення

  • Текст оператору (customTextToOperator) — повідомлення, яке побачить оператор при підключенні (контекст діалогу, підсумок тощо).

Alias для переходів (зберігаються в константи стану)

Поля alias у конфігу action задають, куди перейде сценарій при певних життєвих подіях чату (закриття, таймаут тощо). Назви полів у JSON відповідають формі в Node Inspector, наприклад:

  • chat_closed_alias — перехід, коли чат закрито (оператором або за правилами продукту).
  • alias_return_scenario — сценарій/гілка при натисканні кнопки повернення (якщо увімкнено add_return_button).
  • За потреби також: chat_closed_by_timeout_alias, connection_timeout_alias, chat_closed_by_client_alias — див. повний список у технічній документації action.

Вони доповнюють звичайні ребра на полотні (події success / banned / limit / error), а не замінюють їх.

Пов'язані документи