Документація
  • 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?
        • Переглянути змінний звіт
      • Довідник

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

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

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

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

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

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

Про категоризацію листів з пошти за допомогою AI

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

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

У багатьох випадках потрібно автоматично обробляти вхідні листи:

  • Велика кількість листів потребує швидкої обробки
  • Різні типи запитів потребують різних операторів або тем
  • Ручна категоризація займає багато часу
  • Потрібна швидка реакція на запити клієнтів

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

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

Етапи обробки листа

Етап 1: Отримання листа

  • Блок receive_email_message автоматично зчитує нові листи
  • Текст листа зберігається в email_message
  • Тема листа зберігається в email_subject
  • Адреса відправника зберігається в email_to

Етап 2: Категоризація за допомогою AI

  • Блок fastline_completion використовує AI для аналізу тексту
  • AI визначає найкращу категорію запиту
  • Результат зберігається в completion (або вказана змінна)

Етап 3: Передача в операторську панель

  • Лист з категорією передається в операторську панель
  • Категорія відповідає темі (subject) в операторській панелі
  • Тема повинна мати alias, який відповідає значенню AI

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

AI категоризація vs ручна категоризація

AI категоризація:

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

Ручна категоризація:

  • ✅ Плюси: Точність, контроль
  • ❌ Мінуси: Повільність, не масштабується

Чому використовуємо AI: AI дозволяє автоматично обробляти велику кількість листів та швидко передавати їх операторам, що покращує швидкість реагування на запити клієнтів.

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

Використання fastline_completion

Action fastline_completion використовується для аналізу тексту листа та визначення категорії. Промпт повинен:

  • Описувати задачу категоризації
  • Вказувати доступні категорії
  • Повертати тільки одну категорію

Відповідність alias тем

Значення, яке повертає AI, повинно точно відповідати alias теми в операторській панелі. Це забезпечує коректне призначення листа відповідній темі.

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

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

При налаштуванні категоризації важливо:

  1. Налаштувати receive_email_message — для отримання листів
  2. Створити промпт для AI — з описом категорій та інструкціями
  3. Налаштувати теми в операторській панелі — з alias, які відповідають категоріям AI
  4. Перевірити точність категоризації — налаштувати промпт для кращих результатів

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

Помилка: AI повертає неправильну категорію
Проблема: Недостатньо детальний промпт або некоректні інструкції
Рішення: Покращити промпт, додати приклади та чіткі інструкції

Помилка: Лист не призначається темі
Проблема: Alias теми не відповідає значенню AI
Рішення: Перевірити відповідність alias тем значенням, які повертає AI

Помилка: Категоризація працює повільно
Проблема: Використано повільну модель або великий промпт
Рішення: Використати швидшу модель або оптимізувати промпт

Приклади використання

Конфігурація fastline_completion

{
  "model": "gpt-4o",
  "temperature": 0.3,
  "prompt": "Тобі потрібно категоризувати електронні листи клієнтів. На основі наданого повідомлення '{{email_message}}' та теми '{{email_subject}}', визнач найкращу відповідну тему з наведених: консультація, скарга, уточнення. Повертай лише одну тему без додаткових пояснень.\nВажливо: обирай тільки одну категорію. Якщо жодна з них не підходить, поверни 'Інше' (other)."
}

Конфігурація operator_panel__connect_to_operator_with_msg

{
  "subject_alias": "{{completion}}"
}

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

  • Explanation: Підключення чату з оператором — передача в операторську панель