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

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

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

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

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

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

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

- [x] Вашій ролі надано право **«Вивантаження текстів діалогів»** (Налаштування → Користувачі → Ролі → Статистика). Без нього вікно експорту містить лише таблицю. Див. [Налаштувати ролі](/uk/settings/how-to/configure-roles.md).
- [x] У ролі є доступ до модуля `Статистика`, вкладки «Основна статистика».
- [x] Ви встановили період і фільтри на картці «Діалоги».

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

1. Відкрийте `Меню -> Статистика -> Основна статистика` і перейдіть до картки **«Діалоги»**.
2. Встановіть період і фільтри (канал, оператор, скіл-група, процес).
3. Натисніть кнопку експорту таблиці — відкриється вікно **«Експорт таблиці»**.
4. У блоці **«Що вивантажити»** оберіть **«Тексти діалогів»**.

<!-- screenshot: вікно «Експорт таблиці», блок «Що вивантажити» з варіантами «Таблиця» і «Тексти діалогів» — додасть демо -->

5. У блоці **«Формат»** оберіть **«Markdown (.md)»** (за замовчуванням) або **«JSONL»**.
6. За потреби змініть галочки:
   - **«Маскувати телефони й email»** — увімкнена за замовчуванням; у файлі: `+38 067 *** ** 12`, `o***@gmail.com`.
   - **«Системні повідомлення»** — вимкнена за замовчуванням; додає передачу, зміну теми, закриття діалогу.
7. Перевірте підсумок: «У файл потрапить N діалогів за період. Фільтри: …».
8. Натисніть **«Експортувати»**. З'явиться смуга «Готуємо файл… X з N діалогів».

<!-- screenshot: смуга поступу «Готуємо файл… X з N діалогів» з підказкою, що вікно можна закрити — додасть демо -->

9. Закрийте вікно або дочекайтеся завершення. Коли файл готовий, зʼявиться сповіщення «Файл з текстами діалогів готовий» з кнопкою **«Завантажити»**.

<!-- screenshot: сповіщення «Файл з текстами діалогів готовий» з кнопкою «Завантажити» — додасть демо -->

10. Натисніть **«Завантажити»** і збережіть файл.

<!-- video: вивантаження текстів діалогів, від вибору «Тексти діалогів» до відкритого файлу з маскою — додасть демо -->

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

Файл містить діалоги, які закрито в обраний період. Файл називається `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 у файлі замасковані (якщо галочку не знімали).

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

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

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

- [Як експортувати дані статистики](/uk/statistics/how-to/export-statistics-data.md)
- [Експортувати звіт](/uk/statistics/how-to/export-report.md)
- [Налаштувати ролі та права доступу](/uk/settings/how-to/configure-roles.md)
