Можливості для інтегратора

Облгяд можливостей для інтеграторів — спеціалістів, які налаштовують чат-ботів, канали та інтеграції в інтерфейсі ConnectiveOne.

1. Вступ та огляд

Для інтегратора — ви працюєте в інтерфейсі продукту ConnectiveOne. Що ви можете?

• Створювати чат-ботів для різних месенджерів (Telegram, Viber, Facebook Messenger)
• Побудовувати сценарії з логікою, умовами, збереженням даних
• Інтегрувати з API зовнішніх систем (CRM, ERP, сервіси)
• Використовувати Action Jail для кастомної логіки
• Працювати з Custom Data — схеми, імпорт, використання в сценаріях
• Налаштовувати AI-агентів (Fastline Pro) для автоматизованих відповідей

Можливості ConnectiveOne у створенні ботів

ConnectiveOne дозволяє:

• Підключати нативні канали: Telegram, Viber, Facebook, Instagram, WhatsApp, веб-виджет
• Запускати сценарії через webhook, внутрішні події, розклад
• Викликати зовнішні API через action action_send_request
• Зберігати дані в Custom Data та Registered Users
• Підключати операторську панель для передачі діалогів людям
• Використовувати Fastline Pro для AI-відповідей на основі баз знань

Очікуваний результат: налаштований бот з кастомними action-блоками.

Типовий проєкт включає: реєстрацію користувача за номером телефону, перевірку клієнта через зовнішній API (GET-запит), підключення до оператора з розподілом за сегментом, FAQ (кнопки або пошук у Custom Data), жалобу з збереженням у Custom Data та нотифікацією, Fastline Pro при ліміті черги операторів.

• Scenario Builder — хаб для інтеграторів

2. Підготовка до роботи

Інтегратор працює в інтерфейсі ConnectiveOne — усе в браузері.

Що потрібно

• Браузер — Chrome, Firefox або Edge
• Доступ до ConnectiveOne — URL інстансу (https://вашінстанс.connectiveone.io)
• Обліковий запис — логін і пароль від адміністратора
• Роль інтегратора — доступ до Scenario Builder, Action Jail, Settings (канали, Custom Data, Fastline Pro)

Важливо: Якщо не бачите потрібний модуль у меню — зверніться до адміністратора.

• Налаштувати ролі
• Створити та редагувати користувачів

3. Канали та токени

ConnectiveOne підтримує месенджери, email, віджет на сайт та інші канали. Для кожного каналу потрібно отримати токен або ключ доступу у відповідній платформі, потім вказати його в ConnectiveOne: Settings → Bots → оберіть бота → Канали.

Месенджери

Email

Віджет на сайт

Підключити віджет на сайт — вставити код віджету на сайт, налаштувати домени. Що таке віджет.

• Канали — хаб інтеграторів — усі інструкції з каналів

4. Побудова першого сценарію

Сценарій — це послідовність блоків (нод), які виконує бот під час діалогу з користувачем. У Scenario Builder ви будуєте логіку візуально.

• Процеси та сценарії — огляд Scenario Builder та роботи зі сценаріями

Основні типи блоків

Mind map перед створенням

Опишіть потік діалогу, визначте точки розгалуження, позначте зовнішні виклики (API, оператор, Custom Data), намалюйте схему на папері або в Miro/Figma.

Текстові блоки та кнопки

Повідомлення з кнопками — основний блок. Підтримуються placeholders: {{user_name}}, {{variable}}. Після нод registered_users__get або custom_modules__get дані зберігаються в state — доступ через {{назва_поля}} або {{constants.key}}.

Практика

Відкрийте Scenario Builder → додайте Start, MessageKeyboard, Router → з'єднайте → запустіть тест через Runs → Chat preview.

• Створити сценарій
• Протестувати сценарій
• Використати action в сценарії

Секції та еліаси

Секції дозволяють розбити великий сценарій на логічні блоки. Еліаси — унікальні імена точок входу для API-викликів.

Створення секції

У лівій панелі Scenario Builder: «Додати секцію» → ввести назву. Кожна секція має власні ноди та точки входу/виходу.

Точка виходу (Exit point)

Нода завершує поточну секцію та передає керування в іншу. Налаштуйте перехід — виберіть цільову секцію та точку входу (Alias).

Еліас для зовнішніх викликів

Еліас — унікальне ім'я точки входу. Зовнішні системи можуть викликати секцію за еліасом (webhook, API). Дані з виклику доступні через {{user_input}}, {{user_name}}.

• Створити секцію

5. Action-блоки та Action Jail

Стандартні actions

Action-блоки виконують дії: виклик API, збереження даних, підключення до оператора. У ноді Action оберіть потрібну дію зі списку.

• Довідник actions — усі дії

Action Jail — написання кастомних дій

Коли стандартних actions недостатньо — створюйте власні на JavaScript. Меню → Action Jail. Код редагується в інтерфейсі: вбудований редактор, AI-генерація коду, тестування перед підключенням до сценарію.

Призначення: розширення логіки, складні умови, інтеграція з CRM/ERP з нестандартними вимогами.

Збереження токенів: не зберігайте токени в коді. Використовуйте Instance Settings → передавайте в параметрах ноди як {{instance_settings.integration_api_token}}.

Практика: створіть action (AI-генерація допоможе) → протестуйте в розділі «Тестування» → додайте в сценарій.

• Як створити й підтримувати дію в Action Jail

6. Операторська панель

Інтегратор налаштовує логіку розподілу діалогів та передачу між операторами.

• Огляд для оператора — оглядовий розділ про операторську панель

Дія operator_panel__connect_to_operator_with_msg

Ця дія створює чат-кімнату в операторській панелі та підключає користувача до оператора. Додайте ноду Action → виберіть operator_panel__connect_to_operator_with_msg.

Основні параметри (JSON конфіг):

• subject_alias — тема діалогу (відповідає тематиці в Settings). Потрібна для фільтрації та розподілу.
• auto_connect_operator: true — автоматично підключити вільного оператора. Без цього діалог потрапить у папку «Нерозподілені», оператор має взяти його вручну.
• status: "queue" — додати діалог у чергу очікування (папка «У черзі»), якщо всі оператори зайняті.

Події (edges з ноди):

• connected — оператор взяв діалог. Продовжуйте сценарій (наприклад, відправте повідомлення «Оператор на зв'язку»).
• limit — всі оператори зайняті або їх немає. Обов'язково додайте гілку limit: повідомлення про очікування, чергу або Fastline Pro для AI-відповіді поки клієнт чекає.

Важливо: для автоматичного підключення потрібно увімкнути налаштування в операторській панелі: Меню → Операторська панель → налаштування → «Автоматичне підключення вільного оператора до нового діалогу».

Розподіл за сегментом клієнта

Оператор заповнює поле сегмент у картці клієнта. Налаштуйте скіл-групи відповідно до сегментів, використовуйте умови для передачі в потрібну скіл-групу.

• Підключення чату до оператора — детальний гайд з прикладами
• Автоматичне підключення оператора
• Налаштувати операторів

7. Custom Data — зберігання даних

Custom Data — модуль для створення таблиць з власними полями. Це сховище даних: жалоби, FAQ, довідники, картки товарів. Інтегратор створює моделі, бот або оператор записують і читають дані через actions.

Створення моделі

Custom Data → створити модель (наприклад, complaints, faq, shops) → додати поля (текст, число, дата, логічне, JSON) → налаштувати відображення списку та форми.

Використання в сценаріях бота

custom_modules__set — створити/оновити запис. custom_modules__get — отримати за ID. custom_modules__search — пошук з автодоповненням. ID після set зберігається в state — доступ через {{constants.complaint_id}}.

Імпорт CSV та AI Magic

Custom Data підтримує імпорт з CSV. AI Magic — інтелектуальний пошук за природною мовою.

• Інтегратор Hub Custom Data
• Створити модель

8. Макроси — швидкі дії оператора

Макроси — це кнопки в діалозі оператора, які запускають готовий сценарій одним кліком. Наприклад: «Перевірити статус депозиту» — оператор вводить ID клієнта, система перевіряє в CRM і повертає результат. Замість переходу в інші системи — все в одному вікні.

Як зробити секцію макросом

1. Scenario Builder → відкрийте бота (або створіть нового) → додайте секцію з потрібною логікою (повідомлення, actions, умови).
2. Клік по секції → відкриється модальне вікно параметрів секції.
3. Увімкніть «Використовується як макрос» — з'явиться панель для налаштування змінних.
4. Налаштуйте змінні макросу — вхідні параметри, які оператор вводить при запуску (наприклад, order_id, customer_phone). Вони доступні в сценарії через {{назва_змінної}}.
5. Збережіть — секція стане макросом.

Де підключити макроси до операторської панелі

Налаштування → Операторська панель → Налаштування для всіх операторів (/settings-page/op-settings/operators).

У секції «Службові процеси (Copilot / Process)» оберіть бота з макросами в полі «Process макрос». Оператори побачать кнопку «Запустити макрос» у діалозі.

Альтернатива: у налаштуваннях конкретного бота (Settings → Bots → оберіть бота) можна вказати бота для макросів — тоді макроси будуть доступні тільки в діалогах цього бота.

Зв'язок з Custom Data

Один з кроків макросу може бути «записати в Custom Data» — наприклад, після «Жалобу закрито» оператор автоматично заповнює поля в таблиці жалоб.

• Процеси та сценарії
• Бібліотека процесів

9. Fastline Pro

Fastline Pro — модуль для AI-агентів з базами знань. Відповіді генеруються на основі завантажених документів та промпту. Модуль: Меню → Fast Line Pro.

Основні концепції

Агент — AI-модель з промптом та опцією бази знань. База знань (Dataset) — колекція документів (TXT, PDF, DOCX, HTML, CSV). Система шукає відповідні фрагменти в документах і генерує відповідь.

Створення агента

Fastline Pro → створити агента (Чат-бот або Агент з інструментами) → налаштувати промпт → додати змінні → підключити базу знань → вибрати модель (GPT-5, Gemini Flash, Claude).

База знань

Створити dataset → завантажити документи (max 15 MB) → налаштувати фрагментацію та пошук. Створення варіацій фраз може тривати довго — для тесту використовуйте невеликі файли.

action_fastline_pro

У ноді Action виберіть action_fastline_pro → вкажіть agent_name, user_input, save_response. Відповідь доступна через {{ai_answer}}. У налаштуваннях агента можна задати умови ескалації на оператора.

• Fastline Pro — хаб для інтеграторів — усі інструкції
• Створити чат-бота
• Створити агента
• Створити базу знань
• Використати action_fastline_pro

10. Розсилки

Розсилка — масове відправлення повідомлень на канали (Telegram, Viber, Widget). Потрібно: шаблон (сценарій/секція), аудиторія (фільтр клієнтів), розклад. Модуль: Меню → Розсилка (Broadcast).

Створення: модуль Broadcast → нова розсилка → вибрати сценарій → налаштувати аудиторію → запустити. Обмеження: розсилки працюють у межах існуючих сценаріїв, є технічні ліміти.

• Розсилки — хаб для інтеграторів — теми, автопідписки, ліміти
• Розсилки — хаб для операторів — створення та запуск
• Створити розсилку
• Створити шаблон розсилки

11. Налаштування системи

Інтегратор налаштовує ролі, панель операторів та параметри інстансу.

Ролі та доступ

Settings → Ролі. Створюються ролі: оператор, супервайзер, адмін, інтегратор. Для кожної ролі налаштовуються права доступу до модулів (перегляд, редагування, видалення). Інтегратору потрібен доступ до Scenario Builder, Action Jail, Custom Data, Fastline Pro, Settings.

Налаштування операторської панелі

Settings → Налаштування для всіх операторів (/settings-page/op-settings/operators) — центральний розділ для операторки. Тут налаштовують: скіл-групи, тематики (Subjects), статуси операторів і діалогів, таймери (TFR, TTC), швидкі відповіді, макроси (Process макрос), відображення папок і фільтрів, налаштування чатів і тікетів.

Параметри інстансу

Instance Settings, календарі, Client fields, файли.

• Супервайзер — хаб налаштувань операторської панелі — усі інструкції з операторки
• Налаштувати загальні налаштування системи — огляд op-settings
• Налаштувати ролі
• Налаштувати операторів у чатах
• Налаштувати інстанс
• Admin Hub