Вивантажити тексти діалогів
Тексти діалогів — це всі репліки клієнта, бота й оператора по кожному діалогу таблиці «Діалоги» за вибраний період. Файл у форматі Markdown або JSONL зручно віддати в базу знань AI-агента або розібрати вручну. Телефони й email за замовчуванням замасковані.
Коли знадобиться
- Потрібно наповнити базу знань AI-агента реальними переписками.
- Треба розібрати діалоги за період: якість відповідей, типові питання, помилки бота.
- Потрібна переписка цілком, а не лише рядок таблиці з даними діалогу.
Що важливо знати
- Вивантаження працює з карткою «Діалоги» (Статистика → Основна статистика) і бере ті самі фільтри та період, що застосовані на картці.
- Файл готується у фоні. Вікно можна закрити — коли файл буде готовий, зʼявиться сповіщення з кнопкою «Завантажити».
- Файл особистий: його може завантажити лише користувач, який запустив вивантаження. Посилання діє обмежений час, після цього файл видаляється — вивантажте ще раз.
- Кожне вивантаження записується в журнал налаштувань (модуль «Статистика»). Тексти повідомлень у журнал не потрапляють.
- Внутрішні нотатки й видалені повідомлення у файл не потрапляють. Вкладення позначені назвою файлу, наприклад «[Файл: договір.pdf]»; самі файли не вивантажуються.
- Обмеження на один файл: до 20 000 діалогів, 300 000 повідомлень і 200 МБ. Вивантаження одного діалогу обмежене 5 000 повідомленнями (у файлі буде позначка, що показано лише останні). Якщо період завеликий, розбийте його на частини, наприклад по тижню.
- Одночасно виконується одне вивантаження текстів на інстанс. Якщо ви запускаєте те саме вивантаження вдруге, поки перше працює, система поверне вас до першого.
Перед початком
Покрокова інструкція
- Відкрийте
Меню -> Статистика -> Основна статистикаі перейдіть до картки «Діалоги». - Встановіть період і фільтри (канал, оператор, скіл-група, процес).
- Натисніть кнопку експорту таблиці — відкриється вікно «Експорт таблиці».
- У блоці «Що вивантажити» оберіть «Тексти діалогів».
- У блоці «Формат» оберіть «Markdown (.md)» (за замовчуванням) або «JSONL».
- За потреби змініть галочки:
- «Маскувати телефони й email» — увімкнена за замовчуванням; у файлі:
+38 067 *** ** 12,o***@gmail.com. - «Системні повідомлення» — вимкнена за замовчуванням; додає передачу, зміну теми, закриття діалогу.
- «Маскувати телефони й email» — увімкнена за замовчуванням; у файлі:
- Перевірте підсумок: «У файл потрапить N діалогів за період. Фільтри: …».
- Натисніть «Експортувати». З'явиться смуга «Готуємо файл… X з N діалогів».
- Закрийте вікно або дочекайтеся завершення. Коли файл готовий, зʼявиться сповіщення «Файл з текстами діалогів готовий» з кнопкою «Завантажити».
- Натисніть «Завантажити» і збережіть файл.
Що буде у файлі
Файл містить діалоги, які закрито в обраний період. Файл називається 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 у файлі замасковані (якщо галочку не знімали).
Якщо щось пішло не так
| Що показано | Що робити |
|---|---|
| «Період завеликий — розбийте його на частини…» | Скоротіть період (наприклад, до тижня) або додайте фільтри й вивантажте частинами |
| «За цими фільтрами діалогів немає.» | Змініть період або фільтри |
| «Немає прав на вивантаження текстів діалогів…» | Попросіть адміністратора додати право у вашій ролі |
| «Сховище файлів не готове для текстів діалогів. Зверніться до підтримки.» | Зверніться до підтримки |
| «Вивантаження перервано. Запустіть його ще раз.» | Запустіть вивантаження ще раз; якщо повторюється — зверніться до підтримки |
| «Зараз виконується забагато експортів. Спробуйте ще раз за хвилину.» | Зачекайте завершення поточного вивантаження і повторіть |