--- title: "Для інтегратора" description: "Повний посібник для інтеграторів ConnectiveOne. Від першого сценарію до Action Jail, Custom Data, Fast Line Pro та налаштування системи." --- # Можливості для інтегратора Огляд можливостей для інтеграторів — спеціалістів, які налаштовують чат-ботів, канали та інтеграції в інтерфейсі ConnectiveOne. > **Практика:** пройдіть [Практичний трек навчання інтегратора](/uk/learn/implementer/training/index.md) — самостійні Use Case від FAQ-бота до інтегрованого сценарію. --- ## 1. Вступ та огляд Для **інтегратора** — ви працюєте в інтерфейсі продукту ConnectiveOne. Що ви можете? - **Створювати чат-ботів** для різних месенджерів (Telegram, Viber, Facebook Messenger) - **Будувати сценарії** з логікою, умовами, збереженням даних - **Інтегрувати з API** зовнішніх систем (CRM, ERP, сервіси) - **Використовувати Action Jail** для кастомної логіки - **Працювати з Custom Data** — схеми, імпорт, використання в сценаріях - **Налаштовувати AI-агентів** (Fast Line Pro) для автоматизованих відповідей ### Можливості ConnectiveOne у створенні ботів ConnectiveOne дозволяє: - Підключати **нативні канали**: Telegram, Viber, Facebook, Instagram, WhatsApp, веб-виджет - Запускати сценарії через **webhook**, **внутрішні події**, **розклад** - Викликати **зовнішні API** через action `action_send_request` - Зберігати дані в **Custom Data** та **Registered Users** - Підключати **операторську панель** для передачі діалогів людям - Використовувати **Fast Line Pro** для AI-відповідей на основі баз знань Очікуваний результат: **налаштований бот з кастомними action-блоками**. Типовий проєкт включає: реєстрацію користувача за номером телефону, перевірку клієнта через зовнішній API (GET-запит), підключення до оператора з розподілом за сегментом, FAQ (кнопки або пошук у Custom Data), скаргу з збереженням у Custom Data та нотифікацією, Fast Line Pro при ліміті черги операторів. - [Scenario Builder — хаб для інтеграторів](/uk/scenariobuilder/integrator-hub.md) --- ## 2. Підготовка до роботи Інтегратор працює в інтерфейсі ConnectiveOne — усе в браузері. ### Що потрібно - **Браузер** — Chrome, Firefox або Edge - **Доступ до ConnectiveOne** — URL інстансу (`https://вашінстанс.connectiveone.io`) - **Обліковий запис** — логін і пароль від адміністратора - **Роль інтегратора** — доступ до Scenario Builder, Action Jail, Settings (канали, Custom Data, Fast Line Pro) **Важливо:** Якщо не бачите потрібний модуль у меню — зверніться до адміністратора. - [Налаштувати ролі](/uk/settings/how-to/configure-roles.md) - [Створити та редагувати користувачів](/uk/settings/how-to/create-edit-users.md) --- ## 3. Канали та токени ConnectiveOne підтримує месенджери, email, віджет на сайт та інші канали. Для кожного каналу потрібно отримати токен або ключ доступу у відповідній платформі, потім вказати його в ConnectiveOne: **Settings → Bots → оберіть бота → Канали**. ### Месенджери | Канал | Інструкція | |-------|------------| | Telegram | [Підключити Telegram](/uk/channels/how-to/connect-telegram.md) | | Viber | [Підключити Viber](/uk/channels/how-to/connect-viber.md) | | WhatsApp | [Підключити WhatsApp](/uk/channels/how-to/connect-whatsapp.md) | | WhatsApp (Maytapi) | [Підключити WhatsApp через Maytapi](/uk/channels/how-to/connect-whatsapp-maytapi.md) | | Facebook Messenger, Instagram | [Підключити Facebook Messenger та Instagram](/uk/channels/how-to/connect-facebook-messenger-instagram.md) | ### Email | Канал | Інструкція | |-------|------------| | Gmail | [Підключити Gmail](/uk/channels/how-to/connect-gmail.md) | | Outlook | [Підключити Outlook](/uk/channels/how-to/connect-outlook.md) | ### Віджет на сайт [Підключити віджет на сайт](/uk/channels/how-to/widget/setup-widget-on-website.md) — вставити код віджету на сайт, налаштувати домени. [Що таке віджет](/uk/channels/explanation/what-is-widget.md). - [Канали — хаб інтеграторів](/uk/channels/integrator-hub.md) — усі інструкції з каналів --- ## 4. Побудова першого сценарію Сценарій — це послідовність блоків (нод), які виконує бот під час діалогу з користувачем. У Scenario Builder ви будуєте логіку візуально. - [Процеси та сценарії](/uk/learn/scenario-builder/processes-and-scenarios.md) — огляд Scenario Builder та роботи зі сценаріями ### Основні типи блоків | Задача | Блок | |--------|------| | Відправити текст або меню | Повідомлення з кнопками | | Зібрати дані від користувача | Очікування вводу | | Розгалужити за умовою | Router | | Перейти в іншу секцію | Точка виходу → Точка входу | | Підключити оператора | Operator connection | | Виконати дію (API, логіка) | Action | ### 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. - [Створити сценарій](/uk/scenariobuilder/how-to/create-scenario.md) - [Протестувати сценарій](/uk/scenariobuilder/how-to/test-scenario.md) - [Використати action в сценарії](/uk/scenariobuilder/how-to/use-action-in-scenario.md) ### Секції та еліаси Секції дозволяють розбити великий сценарій на логічні блоки. Еліаси — унікальні імена точок входу для API-викликів. #### Створення секції У лівій панелі Scenario Builder: «Додати секцію» → ввести назву. Кожна секція має власні ноди та точки входу/виходу. #### Точка виходу (Exit point) Нода завершує поточну секцію та передає керування в іншу. Налаштуйте перехід — виберіть цільову секцію та точку входу (Alias). #### Еліас для зовнішніх викликів Еліас — унікальне ім'я точки входу. Зовнішні системи можуть викликати секцію за еліасом (webhook, API). Дані з виклику доступні через `{{user_input}}`, `{{user_name}}`. - [Створити секцію](/uk/scenariobuilder/how-to/create-section.md) --- ## 5. Action-блоки та Action Jail ### Стандартні actions Action-блоки виконують дії: виклик API, збереження даних, підключення до оператора. У ноді Action оберіть потрібну дію зі списку. | Дія | Призначення | Документація | |-----|-------------|--------------| | `action_send_request` | Виклик зовнішнього API (CRM, ERP) | [Довідник actions — Send Request](/uk/actionjail/reference/actions-reference.md#core-actions-63) | | `registered_users__get` / `registered_users__set` | Отримання та збереження даних користувача | [Довідник actions — Registered Users](/uk/actionjail/reference/actions-reference.md#registered-users-3) | | `operator_panel__connect_to_operator_with_msg` | Підключення до оператора | [Дія connect_to_operator_with_msg](/uk/actionjail/reference/actions/operator_panel__connect_to_operator_with_msg.md) | | `custom_modules__get` / `custom_modules__set` | Робота з Custom Data | [custom_modules__set](/uk/customdata/how-to/use-custom-modules-set.md), [custom_modules__get](/uk/customdata/how-to/use-custom-modules-get.md) | | `action_fastline_pro` | Виклик AI-агента | [Використати action_fastline_pro](/uk/fastlinepro/how-to/use-action-fastline-pro.md) | - [Довідник actions — усі дії](/uk/actionjail/reference/actions-reference.md) ### Action Jail — написання кастомних дій Коли стандартних actions недостатньо — створюйте власні на JavaScript. Меню → Action Jail. Код редагується в інтерфейсі: вбудований редактор, AI-генерація коду, тестування перед підключенням до сценарію. **Призначення:** розширення логіки, складні умови, інтеграція з CRM/ERP з нестандартними вимогами. **Збереження токенів:** не зберігайте токени в коді. Використовуйте Instance Settings → передавайте в параметрах ноди як `{{instance_settings.integration_api_token}}`. **Практика:** створіть action (AI-генерація допоможе) → протестуйте в розділі «Тестування» → додайте в сценарій. - [Як створити й підтримувати дію в Action Jail](/uk/actionjail/how-to/admin-manage-actions.md) --- ## 6. Операторська панель Інтегратор налаштовує логіку розподілу діалогів та передачу між операторами. - [Огляд для оператора](/uk/learn/operator/operator-overview.md) — оглядовий розділ про операторську панель ### Дія 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: повідомлення про очікування, чергу або Fast Line Pro для AI-відповіді поки клієнт чекає. **Важливо:** для автоматичного підключення потрібно увімкнути налаштування в операторській панелі: Меню → Операторська панель → налаштування → «Автоматичне підключення вільного оператора до нового діалогу». ### Розподіл за сегментом клієнта Оператор заповнює поле сегмент у картці клієнта. Налаштуйте скіл-групи відповідно до сегментів, використовуйте умови для передачі в потрібну скіл-групу. - [Підключення чату до оператора](/uk/operatorline/explanation/connect-chat-to-operator.md) — детальний гайд з прикладами - [Автоматичне підключення оператора](/uk/operatorline/explanation/auto-connect-free-operator.md) - [Налаштувати операторів](/uk/settings/how-to/configure-operators.md) --- ## 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 та Ask AI Custom Data підтримує імпорт з CSV/XLS та wizard v2 (Google Sheets). **Ask AI** на екрані створення моделі — prefill для ConnectiveOne Instance Agent (замість legacy AI Magic). - [Інтегратор Hub Custom Data](/uk/customdata/integrator-hub.md) - [Створити модель](/uk/customdata/how-to/create-model.md) --- ## 8. Макроси — швидкі дії оператора **Макроси** — це кнопки в діалозі оператора, які запускають готовий сценарій одним кліком. Наприклад: «Перевірити статус депозиту» — оператор вводить ID клієнта, система перевіряє в CRM і повертає результат. Замість переходу в інші системи — все в одному вікні. ### Як зробити секцію макросом 1. **Scenario Builder** → відкрийте бота (або створіть нового) → додайте секцію з потрібною логікою (повідомлення, actions, умови). 2. **Клік по секції** → відкриється модальне вікно параметрів секції. 3. **Увімкніть «Використовується як макрос»** — з'явиться панель для налаштування змінних. 4. **Налаштуйте змінні макросу** — вхідні параметри, які оператор вводить при запуску (наприклад, `order_id`, `customer_phone`). Вони доступні в сценарії через `{{назва_змінної}}`. 5. **Збережіть** — секція стане макросом. ### Де підключити макроси до операторської панелі **Налаштування → Операторська панель → Налаштування для всіх операторів**. У секції **«Службові процеси (Copilot / Process)»** оберіть бота з макросами в полі **«Process макрос»**. Оператори побачать кнопку «Запустити макрос» у діалозі. Альтернатива: у **налаштуваннях конкретного бота** (Settings → Bots → оберіть бота) можна вказати бота для макросів — тоді макроси будуть доступні тільки в діалогах цього бота. ### Зв'язок з Custom Data Один з кроків макросу може бути «записати в Custom Data» — наприклад, після «Скаргу закрито» оператор автоматично заповнює поля в таблиці скарг. - [Процеси та сценарії](/uk/learn/scenario-builder/processes-and-scenarios.md) - [Бібліотека процесів](/uk/scenariobuilder/explanation/what-is-process-library.md) --- ## 9. Fast Line Pro **Fast Line Pro** — модуль для AI-агентів з базами знань. Відповіді генеруються на основі завантажених документів та промпту. Модуль: **Меню → Fast Line Pro**. ### Основні концепції **Агент** — AI-модель з промптом та опцією бази знань. **База знань (Dataset)** — колекція документів (TXT, PDF, DOCX, HTML, CSV). Система шукає відповідні фрагменти в документах і генерує відповідь. ### Створення агента Fast Line 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}}`. У налаштуваннях агента можна задати умови ескалації на оператора. - [Fast Line Pro — хаб для інтеграторів](/uk/fastlinepro/integrator-hub.md) — усі інструкції - [Створити чат-бота](/uk/fastlinepro/how-to/create-chatbot.md) - [Створити агента](/uk/fastlinepro/how-to/create-agent.md) - [Створити базу знань](/uk/fastlinepro/how-to/create-knowledge-base.md) - [Використати action_fastline_pro](/uk/fastlinepro/how-to/use-action-fastline-pro.md) --- ## 10. Розсилки **Розсилка** — масове відправлення повідомлень на канали (Telegram, Viber, Widget). Потрібно: шаблон (сценарій/секція), аудиторія (фільтр клієнтів), розклад. Модуль: **Меню → Розсилка** (Broadcast). Створення: модуль Broadcast → нова розсилка → вибрати сценарій → налаштувати аудиторію → запустити. Обмеження: розсилки працюють у межах існуючих сценаріїв, є технічні ліміти. - [Розсилки — хаб для інтеграторів](/uk/broadcast/integrator-hub.md) — теми, автопідписки, ліміти - [Розсилки — хаб для операторів](/uk/broadcast/operator-hub.md) — створення та запуск - [Створити розсилку](/uk/broadcast/how-to/create-broadcast.md) - [Створити шаблон розсилки](/uk/broadcast/how-to/create-broadcast-template.md) --- ## 11. Налаштування системи Інтегратор налаштовує ролі, панель операторів та параметри інстансу. ### Ролі та доступ Settings → Ролі. Створюються ролі: оператор, супервайзер, адмін, інтегратор. Для кожної ролі налаштовуються права доступу до модулів (перегляд, редагування, видалення). Інтегратору потрібен доступ до Scenario Builder, Action Jail, Custom Data, Fast Line Pro, Settings. ### Налаштування операторської панелі **Settings → Налаштування для всіх операторів** — центральний розділ для операторки. Тут налаштовують: скіл-групи, теми, статуси операторів і діалогів, таймери (TFR, TTC), швидкі відповіді, макроси (Process макрос), відображення папок і фільтрів, налаштування чатів і тікетів. ### Параметри інстансу Instance Settings, календарі, Client fields, файли. - [Супервайзер — хаб налаштувань операторської панелі](/uk/settings/supervisor-hub.md) — усі інструкції з операторки - [Налаштувати загальні налаштування системи](/uk/settings/how-to/configure-system-settings.md) — огляд op-settings - [Налаштувати ролі](/uk/settings/how-to/configure-roles.md) - [Налаштувати операторів у чатах](/uk/settings/how-to/configure-operators.md) - [Налаштувати інстанс](/uk/settings/how-to/configure-instance.md) - [Admin Hub](/uk/settings/admin-hub.md)