Документація
Документація
Навчання
Релізи
  • English
  • Українська
Документація
Навчання
Релізи
  • English
  • Українська
  • Головна

    • Документація ConnectiveOne
    • Client Portal (підтримка)
  • Підключення каналів

    • Канали (Channels)

      • Інтегратор — Хаб налаштування каналів
      • Інструкції

        • Як налаштувати віджет в Налаштування
        • Як підключити Facebook Messenger та Instagram до ConnectiveOne
        • Як підключити Gmail до ConnectiveOne
        • Як підключити Outlook до ConnectiveOne
        • Як підключити Telegram до ConnectiveOne
        • Як підключити номерні Viber, Telegram та WhatsApp через e-chat
        • Як підключити Viber до ConnectiveOne
        • Як підключити WhatsApp до ConnectiveOne
        • Як кастомізувати кольори віджету
        • Як керувати віджетом з сайту
        • Як передати параметри з сайту до сценарію
        • Як налаштувати відправку SMS через Alpha SMS
        • Як налаштувати відправку Viber/SMS через Infobip
        • Як підключити віджет на сайт
        • Телефонія (Telephony)

          • Що таке інтеграція телефонії
          • Як налаштувати канал телефонії
          • Як налаштувати Ringostat
          • Як протестувати webhook телефонії
          • Як переглянути дзвінки в Операторській панелі
        • Як використовувати Custom Code для віджету
        • Як працювати з віджетом на SPA додатках
  • Обробка звернень

    • Операторська панель (OperatorLine)

      • Оператор — Хаб сценаріїв для Операторської панелі
      • Супервайзер — Хаб сценаріїв для Операторської панелі
      • Адміністратор — Хаб сценаріїв для Операторської панелі
      • Інтегратор — Хаб операторської панелі
      • Пояснення

        • Про обробку звернень в ConnectiveOne
        • Що таке фільтри та навіщо вони потрібні
        • Джерела з бази знань у діалозі (блок «ЦИТАТИ»)
        • Про авторозподіл діалогів між операторами
        • Про автоматичне підключення вільного оператора до нового діалогу
        • Відображення контенту Instagram у діалогах
        • Про підключення чату з оператором через операторську панель
        • Підтримка зображень HEIC/HEIF (фото з iPhone)
        • Про перерозподіл чатів з оператора
        • Режими перегляду листування у поштових діалогах
      • Інструкції

        • Змінити статус звернення
        • Створити фільтр
        • Створити папку
        • Створити вихідне звернення
        • Як створити тікет?
        • Як завантажити вкладення з діалогу?
        • Як експортувати діалог у PDF?
        • Як прив'язати тікети між собою?
        • Як працювати з отримувачами в email-відповіді?
        • Управляти папками
        • Як редагувати поля тікету?
        • Як керувати спостерігачами тікету?
        • Відстежувати статуси операторів
        • Моніторинг черги та аудит розподілу
        • Відкрити звернення
        • Переставити папки
        • Як відповісти клієнту?
        • Позначити тему та теги
        • Як перемкнути режим перегляду листування у поштовому діалозі?
        • Використати копілот
        • Переглянути джерела з бази знань у діалозі
        • Використати швидкі відповіді
        • Переглянути список чатів
        • Переглянути чати у таблиці
        • Переглянути оцінку якості діалогу
        • Переглянути чергу звернень
        • Як переглянути логи тікету?
        • Як переглянути SLA метрики тікету?
    • Client Portal (Центр підтримки)

      • Client Portal — хаб для користувача порталу
      • Client Portal — хаб для адміністратора
      • Що таке Client Portal?
      • Організація та scope тікетів у Client Portal
      • Інструкції

        • Як увійти в Client Portal?
        • Як зареєструвати обліковий запис у Client Portal?
        • Як переглянути список тікетів?
        • Як створити тікет?
        • Як коментувати тікет?
        • Як поставити оцінку CSAT?
        • Як користуватися сповіщеннями?
        • Як увімкнути самостійну реєстрацію в Client Portal?
        • Як налаштувати створення тікетів у Client Portal?
        • Як керувати організаціями Client Portal?
    • Профіль (Profile)

      • Оператор — Хаб сценаріїв для Profile
      • Адміністратор — Хаб сценаріїв для Profile
      • Інструкції

        • Як змінити мову інтерфейсу?
        • Налаштувати папки
        • Налаштувати сповіщення в профілі
        • Налаштувати налаштування звернень у профілі
        • Налаштувати швидкі відповіді
        • Налаштувати підпис
    • Клієнти (BroadcastUsers)

      • Оператор — Хаб сценаріїв для BroadcastUsers
      • Інтегратор — Хаб сценаріїв для BroadcastUsers
      • Адміністратор — Хаб сценаріїв для BroadcastUsers
      • Пояснення

        • Чому в одного клієнта багато каналів?
        • Розділи картки клієнта
        • Про зареєстрований контакт і відвідувачів без профілю
      • Інструкції

        • Створити сегмент за фільтрами
        • Редагувати дані клієнта
        • Експортувати дані клієнтів
        • Відфільтрувати клієнтів
        • Як керувати підпискою на розсилки?
        • Як знайти та об'єднати схожі контакти
        • Як знайти клієнта?
        • Шукати клієнтів за файлом
        • Надіслати розсилку обраним клієнтам
        • Як переглянути картку клієнта?
        • Переглянути канали клієнта
        • Переглянути відвідувачів без профілю клієнта
  • Розсилки

    • Розсилки (Broadcast)

      • Оператор — Хаб розсилок для Broadcast
      • Інтегратор — Хаб налаштувань для Broadcast
      • Аналітик — Хаб аналітики для Broadcast
      • Інструкції

        • Як активувати заплановану розсилку?
        • Як перевірити статус розсилки?
        • Як налаштувати ліміти розсилок?
        • Як створити розсилку?
        • Як створити тему розсилки?
        • Як деактивувати тему розсилки?
        • Як редагувати чернетку розсилки?
        • Як редагувати тему розсилки?
        • Як експортувати результати розсилки в Excel?
        • Як запустити розсилку негайно?
        • Як зберегти розсилку як чернетку?
        • Як переглянути результати розсилки?
        • Як переглянути статистику кліків?
        • Як переглянути статистику доставок?
        • Як переглянути статистику відкриттів?
  • Автоматизація

    • Scenario Builder

      • Scenario Builder — Хаб для інтеграторів
      • Інструкції

        • Як додати переклади до сценарію в Scenario Builder
        • Як налаштувати сценарій для подій Instagram у Scenario Builder
        • Як налаштувати обробку відміток у сторіс Instagram
        • Як налаштувати підключення оператора до коментарів Instagram
        • Як налаштувати каскад черги оператора
        • Як створити новий сценарій бота в Scenario Builder
        • Як створити секцію сценарію в Scenario Builder
        • Як редагувати сценарій в Scenario Builder
        • Як знайти ноду на полотні в Scenario Builder
        • Як експортувати та імпортувати сценарій в Scenario Builder
        • Як надіслати клієнту HTML-лист зі сценарію
        • Як протестувати сценарій в Scenario Builder
        • Як використати action в сценарії Scenario Builder
        • Як використати збережені секрети для сценаріїв у Send Request
        • Як переглянути історію версій сценарію в Scenario Builder
        • Як переглянути C1 Flow (YAML) сценарію в Scenario Builder
    • Scenario Dialog (Legacy)

      • Інтегратор — Хаб сценаріїв для Scenario Dialog (Legacy)
      • Пояснення

        • Actions в сценаріях — що це та як працюють
        • Про використання action autobroadcast__create у сценаріях
        • Про копіювання сценарію існуючого бота
        • Про інтеграцію ConnectiveOne з Corezoid через операторську панель
        • Про виведення зображень користувачу
        • Про категоризацію листів з пошти за допомогою AI
        • Про реферальні мітки з реклами Facebook
        • Про запуск сценарію з реклами на Facebook
        • Про HTML форматування тексту в Telegram та Widget
        • Про інлайн-клавіатуру в Telegram та Widget
        • Про налаштування alias при вихідному діалозі
        • Про оплату через бот
        • Про ботів для груп Telegram
        • Стилізація кнопок клавіатури в Telegram
        • Про Telegram WebApp у сценаріях
        • Про стилізацію клавіатури у Viber
        • Про стартове повідомлення у Viber
      • Інструкції

        • Як додати переклади до сценарію?
        • Як створити новий сценарій бота?
        • Як створити секцію сценарію?
        • Як редагувати існуючий сценарій бота?
        • Як експортувати або імпортувати сценарій?
        • Як використати action в сценарії?
        • Як переглянути та відновити версії сценарію?
    • Action Jail

      • Оператор — Хаб сценаріїв для ActionJail
      • Пояснення

        • Секції редактора дій ActionJail
        • Про те, як дані з Action Jail потрапляють у Scenario Builder
      • Інструкції

        • Як створити кастомну дію в Action Jail
        • Як створити й підтримувати дію в ActionJail (Адміністратор)
        • Налаштування AI-генератора в ActionJail (Адміністратор)
        • Як клонувати дію в ActionJail
        • Як швидко знайти дію в ActionJail
        • Як підключити дію ActionJail до сценарію бота (Інтегратор)
        • Як використати збережені секрети в кастомній дії Action Jail
      • Довідник

        • Actions Reference — Довідник по діях
        • Стандартні константи бота (Operator Panel)
        • Дії (actions)

          • Дія add_to_cart
          • Дія api__callnode
          • Дія apple_google_pay
          • Дія autobroadcast__create
          • Дія autobroadcast__remove
          • Дія broadcast__subscribe
          • Дія broadcast__subscribed
          • Дія broadcast__unsubscribe
          • Дія call_node
          • Дія card_pay
          • Дія card_pay_block_scenario
          • Дія chatroom_update
          • Дія check_language
          • Дія check_schedule
          • Дія clear_constant
          • Дія close_chatroom
          • Дія create_hash
          • Дія create_message
          • Дія custom_modules__export
          • Дія custom_modules__get
          • Дія custom_modules__set
          • Дія custom_modules__update
          • Дія custom_modules_list
          • Дія esputnik__push_contact
          • Дія existing_chatroom
          • Дія fastline
          • Дія fastline_completion
          • Дія fastline_pro
          • Дія fastline_search
          • Дія fastline_summarize
          • Дія fastline_transcribe
          • Дія files__get
          • Дія fl_transfer_to_operator
          • Дія fl_transfer_to_skill_group
          • Дія generate_barcode
          • Дія generate_list
          • Дія get_channel
          • Дія get_chat_room_messages
          • Дія get_client_by_chat_room_id
          • Дія get_command
          • Дія get_language
          • Дія get_ticket_info
          • Дія get_user_input
          • Дія goto_alias
          • Дія if_else
          • Дія interval__end
          • Дія interval__end_all
          • Дія interval__last
          • Дія interval__start
          • Дія language__get
          • Дія language__set
          • Дія log
          • Дія loop__end
          • Дія loop__start
          • Дія loop_end
          • Дія loop_start
          • Дія menu_slider
          • Дія meta_type
          • Дія my_chatrooms_list
          • Дія operator_panel__clear_data
          • Дія operator_panel__connect_to_operator_with_msg
          • Дія operator_panel__get_last_dialog
          • Дія operator_panel__nps_confirm_answer
          • Дія registered_users__check_phone
          • Дія registered_users__get
          • Дія registered_users__set
          • Дія remove_from_cart
          • Дія return_to_chatroom
          • Дія scan_barcode
          • Дія scan_qr
          • Дія schedule__check
          • Дія send_email
          • Дія send_file
          • Дія send_me
          • Дія send_photo
          • Дія send_request
          • Дія send_sticker
          • Дія send_video
          • Дія set
          • Дія set_current_date
          • Дія set_language
          • Дія sleep
          • Дія statistic__set
          • Дія subscription__check
          • Дія subscription__remove
          • Дія subscription__set
          • Дія switch
          • Дія test_list
          • Дія testing__search
          • Дія tickets_clear_input
          • Дія tickets_create
          • Дія tickets_create_v2
          • Дія tickets_create_wrapped
          • Дія tickets_list
          • Дія tickets_update
          • Дія validate
          • Дія verify_online_payment
          • Дія widget__callout
    • Інтеграції

      • Інтегратор — Хаб інтеграцій ConnectiveOne
      • Інструкції

        • Як інтегрувати операторську панель як віджету в CRM/ERP
        • Як налаштувати назву продукту для Zoho CRM
        • Як інтегрувати зовнішню систему через Custom Channel
        • Як отримати дані з API за допомогою send_request
        • Як передати дані з ConnectiveOne через send_request
        • Як налаштувати підписку користувача на нотифікації
        • Як запустити сценарій бота через API call_node
        • Як інтегрувати ConnectiveOne з eSputnik
        • Як надіслати розсилку по телефону через route
        • Як використовувати API ConnectiveOne
        • Як налаштувати webhook панелі оператора
      • Довідник

        • API Reference — Довідник по API ConnectiveOne
    • Користувацькі дані (CustomData)

      • Інтегратор — Custom Data
      • Адміністратор — Хаб сценаріїв для Custom Data
      • Аналітик — Хаб сценаріїв для Custom Data
      • Пояснення

        • Про Custom Data в ConnectiveOne
        • Патерни та приклади Custom Data
        • Складні кейси Custom Data
      • Інструкції

        • Додати поле до моделі
        • Налаштувати тип поля
        • Створити групу
        • Як створити модель даних?
        • Редагувати модель
        • Експортувати відфільтровані дані
        • Як експортувати дані моделі?
        • Як знайти записи за фільтрами?
        • Імпортувати дані з файлу
        • Сортувати записи
        • Валідувати дані
        • Переглянути записи моделі
      • Довідник

        • Довідник розширених налаштувань моделей Custom Data
    • Менеджер файлів (FileManager)

      • Оператор — Хаб сценаріїв для FileManager
      • Інструкції

        • Як скопіювати посилання на файл?
        • ⚠️ DEPRECATED: Як створити завдання в Jira з файлом?
        • Як видалити файл або папку?
        • Як перейти в папку?
        • Як перейменувати файл?
        • Як завантажити новий файл?
        • Як переглянути список файлів?
  • Штучний інтелект

    • Fast Line Pro (FastLinePro)

      • Інтегратор — Хаб сценаріїв для FastLinePro
      • Адміністратор — Хаб сценаріїв для FastLinePro
      • Інструкції

        • Активувати KB Plugin
        • Як перевірити відповідь AI-агента в сценарії?
        • Перевірити статус синхронізації
        • Налаштувати промпт агента
        • Як прив'язати MCP Tool секцію до агента Fast Line Pro
        • Підключити та налаштувати інструменти агента
        • Як налаштувати змінні агента в FastLinePro?
        • Як налаштувати фрагментацію в базі знань FastLinePro?
        • Налаштувати синхронізацію KB Plugin
        • Налаштувати синхронізацію знань
        • Як підключити базу знань до AI-агента в FastLinePro?
        • Створити агента
        • Як створити чат-бота FastLinePro?
        • Як створити базу знань?
        • Деактивувати KB Plugin
        • Як згенерувати ключ Gemini для FastLine Pro
        • Як підготувати файл для бази знань FastLinePro?
        • Запустити синхронізацію KB
        • Оновити файли KB
        • Завантажити файли до KB
        • Як використати дію action_fastline_pro в сценарії?
    • Контроль якості (Quality Assurance)

      • Супервайзер — Хаб сценаріїв для Quality Assurance
      • Адміністратор — Хаб сценаріїв для Quality Assurance
      • Аналітик — Хаб сценаріїв для Quality Assurance
      • Пояснення

        • Як налаштувати чеклист AI QA для якісної оцінки діалогів
      • Інструкції

        • Як корегувати AI-оцінки критеріїв?
        • Як затвердити оцінку?
        • Оцінити звернення
        • Провести перевірку якості
        • Як створити нову оцінку діалогу?
        • Експортувати оцінки
        • Фільтрувати оцінки
        • Використати чеклист
        • Переглянути деталі оцінки
        • Як переглянути список оцінок та знайти потрібну?
        • Переглянути дашборд якості
        • Переглянути звіти якості
  • Статистика

    • Статистика (Statistics)

      • Супервайзер — Хаб сценаріїв для Statistics
      • Адміністратор — Хаб сценаріїв для Statistics
      • Аналітик — Хаб сценаріїв для Statistics
      • Пояснення

        • Гібридна аналітика тікетів: як читати дашборд
      • Інструкції

        • Застосувати фільтри до звіту
        • Як налаштувати CSAT (задоволеність клієнтів) в Statistics?
        • Як створити та налаштувати воронку в Statistics?
        • Створити детальний звіт
        • Створити воронку
        • Експортувати звіт
        • Як експортувати дані статистики?
        • Налаштувати цільові метрики
        • Переглянути щоденний звіт
        • Переглянути дашборд
        • Як переглянути дашборди Metabase в модулі Statistics?
        • Як переглянути робочий графік оператора в Statistics?
        • Як переглянути підсумок якості за період?
        • Переглянути змінний звіт
      • Довідник

        • Метрики статистики — довідник
  • Адміністрування

    • Constructor

      • Constructor — головний екран і навігація
      • Пояснення

        • Що таке база знань інстансу в Constructor
        • Що таке AI Помічник
        • Що таке тури інстансу в базі знань
      • Інструкції

        • Як користуватися головним екраном Constructor?
        • Як працювати з базою знань інстансу
        • Як працювати з турами інстансу
        • Як користуватися AI Помічником
        • Як користуватися веб-пошуком і читанням сайтів у AI Помічнику
        • Як налаштувати доступ до AI Помічника
        • Як увімкнути пошук і читання даних з інтернету в AI Помічнику
    • Налаштування

      • Супервайзер — Хаб налаштувань операторської панелі
      • Адміністратор — Хаб налаштувань системи
      • Інструкції

        • Як активувати або деактивувати бота?
        • Як налаштувати автентифікацію та управління доступом?
        • Як задати параметри розкладу «Автоматична перевірка»
        • Як налаштувати бота?
        • Як налаштувати параметри чатів?
        • Як налаштувати відображення полів у картці клієнта?
        • Як налаштувати поля клієнтів?
        • Як налаштувати шаблони email (хедер і футер)?
        • Як налаштувати параметри файлів?
        • Як отримати токен MCP для інстансу ConnectiveOne
        • Як налаштувати гарячі клавіші?
        • Як налаштувати параметри інстансу?
        • Як увійти як користувач?
        • Як керувати секретами для сценаріїв
        • Як увімкнути Центр нотифікацій на інстансі (root)
        • Як налаштувати операторів у чатах?
        • Як налаштувати ролі та права доступу?
        • Як налаштувати стилі та скрипти?
        • Як налаштувати загальні налаштування системи?
        • Як налаштувати параметри тікетів?
        • Як налаштувати таймери для чатів?
        • Як налаштувати поля користувачів?
        • Як створити нового бота?
        • Як переглянути список ботів?
        • Як переглянути журнал змін налаштувань?
        • Як переглянути стан системи?
        • Як переглянути список користувачів?
      • Пояснення

        • Що таке секрети для сценаріїв?
    • Доступ

      • Відновлення доступу — Хаб сценаріїв
      • Інструкції

        • Як увімкнути потік відновлення пароля (Адміністратор)
        • Як згенерувати лінк для скидання пароля вручну (Адміністратор)
        • Як скинути пароль через «Забули пароль?»
  1. Документація
  2. /Actionjail
  3. /Reference
  4. /Actions
  5. /Дія operator_panel__connect_to_operator_with_msg

Дія operator_panel__connect_to_operator_with_msg

Створює чат у Operator Panel і підключає клієнта до оператора. Параметри задаються в JSON-конфігурації ноди (або у полях Node Inspector). Усі параметри опціональні, якщо не зазначено інше.

System ID: action_operator_panel__connect_to_operator_with_msg
У сценарії також: operator_panel__connect_to_operator_with_msg

Концепція ноди в Scenario Builder: Живий оператор у діалозі.
Короткий рядок у каталозі: Довідник actions — Operator Panel.


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

Після виконання action повертає одну з гілок. Кожну потрібно з’єднати з наступними нодами.

ПодіяКоли виникає
successЧат створено (типовий успіх, якщо на ноді немає окремих гілок queue / connected)
connectedОператор уже підключений / чат у статусі processed — лише якщо на ноді є вихід connected
queueЧат у черзі або режим очікування (continue, status: "queue") — лише якщо на ноді є вихід queue
bannedКористувач у активному бані; клієнту може піти текст причини бану
limitУвімкнено auto_connect_operator, але вільного оператора не знайдено
errorНе вдалося створити чат або інший збій

Якщо на ноді немає виходів queue / connected, успішний результат завжди йде в success (навіть коли чат фактично в черзі).

Кнопки add_button / add_return_button — це UI чату, а не події (гілки) сценарію.


Основні налаштування підключення

ПараметрТипОпис
subject_aliasstringAlias теми звернення. Підтримує плейсхолдери ({{...}}). Тема має існувати й не бути видаленою.
auto_connect_operatorbooleantrue — перед створенням чату перевіряє вільних операторів за skill group теми (з урахуванням лімітів діалогів). Якщо нікого немає — подія limit, чат не створюється. false або відсутній — чат створюється без автопризначення.
assigned_operatorstring / numberID оператора (op_user). Працює лише разом з auto_connect_operator: true. Підтримує плейсхолдери.
continuebooleantrue — клієнт може продовжувати сценарій під час очікування (стан wait); гілка зазвичай success (або queue, якщо є).
statusstringПочатковий внутрішній статус чату: new, processed, queue, closed. Без нагальної потреби не змінюйте.
status_namestringКористувацький статус чату (якщо такого статусу немає — не встановиться). Підтримує плейсхолдери.
chat_titlestringЗаголовок чату в панелі оператора. Підтримує плейсхолдери, напр. "Чат підтримки - {{{user_name}}}".
weightnumberВага (пріоритет) діалогу. Якщо не задано — береться вага теми.
tag_idsarrayID тегів для чату. Підтримує плейсхолдери в елементах масиву; неіснуючі ID ігноруються.
history_by_phonebooleanШукати історію клієнта за номером телефону (навіть з інших каналів / chat_id).
history_countnumberСкільки останніх кроків клієнта в боті передати оператору. 0 або відсутній — історію не надсилати.
enable_transition_on_chat_closebooleanЯкщо вимкнено — при закритті чату не виконується перехід за alias.
process_bot_idnumberID бота, процеси якого можна використовувати при підключенні.
typestringТип чат-кімнати (наприклад ticket, fast_line, group). Якщо не задано — визначається автоматично.
instagram_room_typestring / nullДля Instagram: direct — звичайний 1:1 чат; інакше (null / comment) — кімната під тред. Працює для коментарів до поста, mentions і відповідей на Stories.

Повідомлення та комунікація

Повідомлення оператору

ПараметрТипОпис
customTextToOperatorstringТехнічне повідомлення лише для оператора. Підтримує плейсхолдери.
parse_modebooleantrue — обробити customTextToOperator як Markdown/HTML.

Повідомлення клієнту про очікування

ПараметрТипОпис
waiting_messageobjectЛокалізовані тексти очікування: ключі — коди мов (uk, en, …). Підтримує плейсхолдери в значеннях.
waiting_message_timenumberЧерез скільки секунд показати waiting_message. Типово 300.
{
  "waiting_message": {
    "en": "Please wait, connecting you to an operator...",
    "uk": "Будь ласка, зачекайте, з'єднуємо вас з оператором..."
  },
  "waiting_message_time": 60
}

Кнопки для клієнта

ПараметрТипОпис
add_return_buttonbooleanКнопка «Повернутися назад». Текст — константа return_button_text.
alias_return_scenariostringAlias блоку сценарію при натисканні кнопки повернення.
add_buttonbooleanКнопка виходу з чату на повідомленнях оператора/системи. Текст — константа close_chat_button_text.

Завершення діалогу та alias

Alias зберігаються в константи стану й спрацьовують після життєвих подій чату (не замінюють гілки success/limit/…).

ПараметрКонстанта стануКоли спрацьовує
chat_closed_by_client_aliasalias_closed_by_clientКлієнт закрив чат кнопкою
chat_closed_aliasalias_chat_closedОператор закрив чат (текст клієнту — chat_closed_by_operator)
chat_closed_by_timeout_aliasalias_chat_closed_by_timeoutЗакриття через неактивність (текст — chat_closed_by_timeout)
connection_timeout_aliasalias_connection_timeoutНе дочекалися підключення оператора
alias_on_operator_connectedalias_operator_connectedОператор підключився до чату (для сценаріїв з чергою / cascade)
alias_return_scenarioalias_return_scenarioКнопка повернення

Таймаути

ПараметрОдиницяОпис
custom_timeout_timeхвилиниТаймаут неактивності саме для цього діалогу (перекриває глобальне налаштування).
connection_timeout_timeсекундиСкільки чекати підключення оператора, перш ніж закрити діалог.
transfer_timeoutсекундиСкільки чекати прийняття ручної передачі чату іншому оператору (типово ~120).

Інтеграція та ШІ

ПараметрТипОпис
event_webhook_urlstringURL для подій чату в реальному часі. Див. налаштування webhook.
fastline_operatorbooleantrue — підключити Fast Line як оператора (чат у режимі очікування з AI).
copilot_bot_idnumber / stringID ШІ-бота (Copilot) для чату. Якщо не вказано — система може підставити Copilot за пріоритетом налаштувань. У каналі copilot Copilot не підключається повторно.

Що робить система без окремих параметрів

ПоведінкаКоли
Тип group, заголовок з назви діалогуВхідне повідомлення з групового чату (is_group)
Тип fast_line, статус processedfastline_operator: true
Повідомлення prev_step операторуУ віджеті є константа prev_step (редирект)
Facebook Ads first message у чатіУвімкнений відповідний feature flag і є дані першого Ads-повідомлення
Instagram story-room або comment-roomКанал Instagram + відповідний тип події, якщо instagram_room_type ≠ direct

Додаткові дані

ПараметрТипОпис
client_extra_dataobjectДодаткові поля клієнта (плейсхолдери в значеннях). Можуть впливати на email/phone/ім’я.
chatroom_extra_dataobjectДодаткові поля чат-кімнати (плейсхолдери в значеннях).
{
  "client_extra_data": {
    "level": "{{user_level}}",
    "vip": "{{is_vip}}"
  },
  "chatroom_extra_data": {
    "product": "{{product_name}}",
    "order_id": "{{order_id}}"
  }
}

Приклад повної конфігурації

{
  "subject_alias": "support",
  "event_webhook_url": "https://example.com/chat_events",
  "auto_connect_operator": true,
  "assigned_operator": "42",
  "continue": false,
  "add_button": true,
  "add_return_button": true,
  "alias_return_scenario": "return_point",
  "transfer_timeout": 30,
  "history_count": 5,
  "history_by_phone": true,
  "customTextToOperator": "Користувач має проблеми з {{{feature}}}.",
  "parse_mode": false,
  "chat_closed_alias": "chat_closed_flow",
  "chat_closed_by_timeout_alias": "timeout_flow",
  "connection_timeout_alias": "connection_lost",
  "chat_closed_by_client_alias": "client_closed",
  "waiting_message": {
    "en": "Please wait, connecting you to an operator...",
    "uk": "Будь ласка, зачекайте, з'єднуємо вас з оператором..."
  },
  "waiting_message_time": 60,
  "connection_timeout_time": 600,
  "custom_timeout_time": 20,
  "chatroom_extra_data": {
    "product": "{{product_name}}",
    "order_id": "{{order_id}}"
  },
  "copilot_bot_id": "345",
  "client_extra_data": {
    "level": "{{user_level}}",
    "vip": "{{is_vip}}"
  },
  "chat_title": "Support Chat - {{{user_name}}}",
  "status": "queue",
  "status_name": "Узято в роботу",
  "weight": 50,
  "tag_ids": [1, 2],
  "enable_transition_on_chat_close": true
}

Стандартні константи бота

Тексти беруться з констант бота для поточної мови (lang_code). Повний довідник (з типовими формулюваннями): Стандартні константи бота (Operator Panel).

КонстантаПризначення
chat_created_msgПовідомлення при створенні діалогу
chat_operator_connectedОператор приєднався (додаються роль і ім’я)
auto_connectedТекст при автопідключенні оператора (якщо немає — часто chat_created_msg)
chat_closed_by_operatorЧат закрито оператором
chat_closed_by_timeoutЧат закрито по таймауту
op_role_supervisorНазва ролі «Супервізор»
op_role_operatorНазва ролі «Оператор»
op_role_adminНазва ролі «Адміністратор»
close_chat_button_textТекст кнопки завершення розмови
return_button_textТекст кнопки повернення
close_chat_commandКоманда закриття чату (якщо задана разом з add_button)

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

  • Довідник actions
  • Живий оператор у діалозі
  • Підключення чату з оператором
  • Автоматичне підключення вільного оператора
  • Webhook операторської панелі
  • Стандартні (вбудовані) actions
Prev
Дія operator_panel__clear_data
Next
Дія operator_panel__get_last_dialog

On this page