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

    • Документація ConnectiveOne
  • Підключення каналів

    • Канали (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
        • Як підключити віджет на сайт
        • Як використовувати Custom Code для віджету
        • Як працювати з віджетом на SPA додатках
  • Обробка звернень

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

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

        • Про обробку звернень в ConnectiveOne
        • Про авторозподіл діалогів між операторами
        • Про автоматичне підключення вільного оператора до нового діалогу
        • Про підключення чату з оператором через операторську панель
        • Про перерозподіл чатів з оператора
      • Інструкції

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

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

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

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

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

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

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

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

    • Сценарій

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

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

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

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

      • Інтегратор — Хаб інтеграцій 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
      • Інструкції

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

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

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

    • Fast Line Pro (FastLinePro)

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

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

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

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

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

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

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

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

    • Налаштування

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

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

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

        • Як увімкнути потік відновлення пароля (Адміністратор)
        • Як згенерувати лінк для скидання пароля вручну (Адміністратор)
        • Як скинути пароль через «Забули пароль?»

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

Viber має особливість у роботі з першим повідомленням від бота: після першого повідомлення система очікує відповіді користувача перед відправкою наступного повідомлення. Це впливає на структуру сценаріїв для Viber та потребує особливого підходу до першого блоку.

Контекст і проблема

У багатьох сценаріях потрібно відправити кілька повідомлень підряд або показати інформацію без очікування відповіді користувача. Однак у Viber після першого повідомлення система автоматично очікує відповіді користувача, що може порушити логіку сценарію.

Проблема:

  • Якщо перший блок — "Повідомлення користувачу", наступне повідомлення не буде відправлене, поки користувач не відповість
  • Це може порушити логіку сценарію, де потрібно показати кілька повідомлень підряд

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

Механізм очікування відповіді

Viber автоматично встановлює режим очікування відповіді після першого повідомлення від бота. Це означає:

  • Система чекає на ввід від користувача
  • Наступні повідомлення не відправляються до отримання відповіді
  • Timeout очікування залежить від налаштувань бота

Правильна структура для Viber

Для забезпечення коректної роботи сценарію в Viber перший блок повинен бути інтерактивним:

  • "Очікування відповіді користувача" — бот чекає на текстовий ввід
  • "Повідомлення з клавіатурою" — бот показує кнопки для вибору

Це забезпечує взаємодію користувача з ботом з самого початку та дозволяє системі продовжити виконання сценарію.

Варіанти підходів

Інтерактивний перший блок vs пасивне повідомлення

Інтерактивний перший блок (рекомендовано):

  • ✅ Плюси: Забезпечує коректну роботу сценарію, дозволяє користувачу одразу взаємодіяти з ботом
  • ❌ Мінуси: Потрібно додати інтерактивний елемент (клавіатуру або очікування вводу)

Пасивне повідомлення:

  • ✅ Плюси: Простота структури
  • ❌ Мінуси: Може порушити логіку сценарію, наступні повідомлення не відправляються

Чому використовуємо інтерактивний перший блок: Це забезпечує коректну роботу сценарію та дозволяє користувачу одразу взаємодіяти з ботом, що покращує користувацький досвід.

Альтернативні рішення

Якщо потрібно відправити кілька повідомлень підряд без очікування відповіді:

  1. Використати action блоки для відправки повідомлень
  2. Об'єднати кілька повідомлень в одне
  3. Використати welcome message (якщо підтримується)

Прийняті рішення

Обов'язкова інтерактивність першого блоку

Для Viber перший блок сценарію повинен бути інтерактивним (клавіатура або очікування вводу). Це забезпечує коректну роботу системи та дозволяє користувачу одразу взаємодіяти з ботом.

Timeout очікування

Timeout очікування відповіді залежить від налаштувань бота. Якщо користувач не відповів протягом timeout, система може перейти до наступного кроку або завершити діалог.

Наслідки для користувачів і імплементації

Для інтеграторів

При створенні сценаріїв для Viber важливо:

  1. Перевірити перший блок — він повинен бути інтерактивним
  2. Додати клавіатуру або очікування вводу — для забезпечення коректної роботи
  3. Об'єднати повідомлення — якщо потрібно показати кілька повідомлень підряд
  4. Використати action блоки — для відправки повідомлень без очікування відповіді

Типові помилки

Помилка: Наступні повідомлення не відправляються після першого
Проблема: Перший блок — пасивне повідомлення без інтерактивності
Рішення: Додати клавіатуру або очікування вводу до першого блоку

Помилка: Сценарій "зависає" після першого повідомлення
Проблема: Система очікує відповіді, але користувач не знає, що робити
Рішення: Додати інструкції або кнопки для навігації

Обмеження

  • Viber вимагає взаємодії користувача після першого повідомлення
  • Timeout очікування відповіді залежить від налаштувань бота
  • Деякі типи повідомлень можуть не підтримуватися

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

  • Reference: Viber Bot API Documentation — офіційна документація Viber
  • Explanation: Стилізація клавіатури у Viber — налаштування клавіатури для Viber