Покрокова інструкція
Markdown статтіПовідомити про помилку

Вивантажити тексти діалогів

Тексти діалогів — це всі репліки клієнта, бота й оператора по кожному діалогу таблиці «Діалоги» за вибраний період. Файл у форматі Markdown або JSONL зручно віддати в базу знань AI-агента або розібрати вручну. Телефони й email за замовчуванням замасковані.

Коли знадобиться

  • Потрібно наповнити базу знань AI-агента реальними переписками.
  • Треба розібрати діалоги за період: якість відповідей, типові питання, помилки бота.
  • Потрібна переписка цілком, а не лише рядок таблиці з даними діалогу.

Що важливо знати

  • Вивантаження працює з карткою «Діалоги» (Статистика → Основна статистика) і бере ті самі фільтри та період, що застосовані на картці.
  • Файл готується у фоні. Вікно можна закрити — коли файл буде готовий, зʼявиться сповіщення з кнопкою «Завантажити».
  • Файл особистий: його може завантажити лише користувач, який запустив вивантаження. Посилання діє обмежений час, після цього файл видаляється — вивантажте ще раз.
  • Кожне вивантаження записується в журнал налаштувань (модуль «Статистика»). Тексти повідомлень у журнал не потрапляють.
  • Внутрішні нотатки й видалені повідомлення у файл не потрапляють. Вкладення позначені назвою файлу, наприклад «[Файл: договір.pdf]»; самі файли не вивантажуються.
  • Обмеження на один файл: до 20 000 діалогів, 300 000 повідомлень і 200 МБ. Вивантаження одного діалогу обмежене 5 000 повідомленнями (у файлі буде позначка, що показано лише останні). Якщо період завеликий, розбийте його на частини, наприклад по тижню.
  • Одночасно виконується одне вивантаження текстів на інстанс. Якщо ви запускаєте те саме вивантаження вдруге, поки перше працює, система поверне вас до першого.

Перед початком

Покрокова інструкція

  1. Відкрийте Меню -> Статистика -> Основна статистика і перейдіть до картки «Діалоги».
  2. Встановіть період і фільтри (канал, оператор, скіл-група, процес).
  3. Натисніть кнопку експорту таблиці — відкриється вікно «Експорт таблиці».
  4. У блоці «Що вивантажити» оберіть «Тексти діалогів».
  1. У блоці «Формат» оберіть «Markdown (.md)» (за замовчуванням) або «JSONL».
  2. За потреби змініть галочки:
    • «Маскувати телефони й email» — увімкнена за замовчуванням; у файлі: +38 067 *** ** 12, o***@gmail.com.
    • «Системні повідомлення» — вимкнена за замовчуванням; додає передачу, зміну теми, закриття діалогу.
  3. Перевірте підсумок: «У файл потрапить N діалогів за період. Фільтри: …».
  4. Натисніть «Експортувати». З'явиться смуга «Готуємо файл… X з N діалогів».
  1. Закрийте вікно або дочекайтеся завершення. Коли файл готовий, зʼявиться сповіщення «Файл з текстами діалогів готовий» з кнопкою «Завантажити».
  1. Натисніть «Завантажити» і збережіть файл.

Що буде у файлі

Файл містить діалоги, які закрито в обраний період. Файл називається dialogs-РРРР-ММ.md (або .jsonl), якщо обрано цілий календарний місяць, інакше dialogs-<від>_<до>.md. Діалоги без жодного повідомлення в файл не потрапляють. Діалоги йдуть за зростанням номера, повідомлення — за порядком надсилання. Час — у часовому поясі статистики. Повідомлення діалогу беруться всі, незалежно від періоду.

Markdown (.md). Заголовок файлу: період, часовий пояс, фільтри, дата вивантаження, кількість діалогів, чи ввімкнена маска. Далі розділи «## Діалог {номер} · {закрито} · {канал} · {тема} · CSAT {оцінка або —}» і рядки на кшталт «Клієнт (дд.мм чч:хх): текст». Автор — «Клієнт», «Бот» або «Оператор» (імʼя і прізвище); «Система» — лише з галочкою «Системні повідомлення».

JSONL. Один рядок JSON на повідомлення з полями dialog_id, dialog_closed_at, channel, subject, csat, message_id, sent_at, author_type (client, bot, operator, system), author_name (лише оператор), text, attachments.

Текст повідомлення подається одним рядком без HTML і не довший за 20 000 символів. Порожнє повідомлення без вкладень — «[без тексту]».

Маскування. Телефон: показано перші 5 і останні 2 цифри, решта — зірочки. Email: перша літера, *** і домен. Номери діалогів, посилання, суми й дати не змінюються. Маска закриває лише телефони й email. Імʼя клієнта чи інші персональні дані, які людина сама написала в тексті повідомлення, не маскуються, так само не маскується імʼя оператора, тож перегляньте файл, перш ніж завантажувати його в AI.

Що відбувається після

Файл зберігається у приватному сховищі. Посилання на нього доступне тільки вам, поки файл не буде видалено. Потрібен файл ще раз — запустіть вивантаження знову.

Як переконатися, що все вдалось

  • У сповіщенні вказано кількість діалогів, період і формат, які ви очікували.
  • У файлі кількість розділів (md) відповідає підсумку у вікні; діалог, закритий кілька разів за період, іде один раз.
  • Телефони й email у файлі замасковані (якщо галочку не знімали).

Якщо щось пішло не так

Що показано Що робити
«Період завеликий — розбийте його на частини…» Скоротіть період (наприклад, до тижня) або додайте фільтри й вивантажте частинами
«За цими фільтрами діалогів немає.» Змініть період або фільтри
«Немає прав на вивантаження текстів діалогів…» Попросіть адміністратора додати право у вашій ролі
«Сховище файлів не готове для текстів діалогів. Зверніться до підтримки.» Зверніться до підтримки
«Вивантаження перервано. Запустіть його ще раз.» Запустіть вивантаження ще раз; якщо повторюється — зверніться до підтримки
«Зараз виконується забагато експортів. Спробуйте ще раз за хвилину.» Зачекайте завершення поточного вивантаження і повторіть

Пов'язані матеріали

Працюєте з власним ШІ-агентом?Встановіть відкритий skill, щоб ваш ШІ-агент працював з актуальною офіційною документацією ConnectiveOne.Отримати skillПотрібна підтримка?Не знайшли відповідь або потрібна допомога команди ConnectiveOne? Створіть запит у Client Portal.Створити запит