---
title: "Импорт клиентов из CSV и экспорт диалогов | tuk-tuk.online"
nav_title: "Импорт и экспорт"
url: https://docs.tuk-tuk.online/dialogs/import-export
markdown: https://docs.tuk-tuk.online/dialogs/import-export.md
section: "Диалоги"
description: "Массовый импорт контактов из CSV-файла, фоновый экспорт истории диалогов с фильтрами и удаление тестовых диалогов в tuk-tuk.online."
keywords: ["импорт клиентов CSV", "экспорт диалогов", "массовый импорт контактов", "выгрузка базы клиентов", "CSV экспорт чатов", "массовые операции", "загрузка контактов"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Импорт создаёт диалоги из CSV-файла со списком клиентов, экспорт выгружает историю переписок в CSV по фильтрам и выполняется в фоне. Отдельная кнопка удаляет диалоги с пометкой «Тестовый».
>
> - Где: раздел «Диалоги», кнопки «Импорт», «Экспорт», «Удалить тестовые».
> - Поля импорта: имя (обязательно), телефон, email, Telegram Chat ID, кастомные поля в JSON.
> - Параметры импорта: общие теги, обновление существующих (по телефону, email или Telegram ID), пропуск первой строки с заголовками.
> - Фильтры экспорта: канал, теги, статус, дата сообщений, наличие телефона или email.
> - Статусы экспорта: «В очереди», «Обработка», «Готово», «Ошибка». Файл хранится 7 дней, предупреждение за 3 часа до удаления.
> - Удаление тестовых затрагивает только диалоги с пометкой «Тестовый».
>
> Связанные страницы: https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/dialogs/search-and-filters, https://docs.tuk-tuk.online/dialogs/duplicates, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/api/rest

# Импорт и экспорт

Импорт создаёт диалоги по списку клиентов из CSV-файла. Экспорт выгружает историю переписок в CSV по выбранным фильтрам и выполняется в фоне. Обе операции запускаются кнопками в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs).

## Когда это нужно

- Переезд с другой платформы: база клиентов из 1С, Excel или CRM уже есть, её нужно загрузить одним файлом.
- Отчёт или архив: выгрузить переписки за период, по каналу или по тегу.
- Чистка после настройки: удалить пробные диалоги, которые появились во время тестов.

## Импорт контактов из CSV


![Создание диалога вручную и импорт из файла](https://docs.tuk-tuk.online/assets/screens/dialogs/create-manual.webp)

1. Имя клиента.
2. Канал для первого сообщения.
3. ID или логин получателя в этом канале.
4. Текст первого сообщения.
5. Источник обращения.
6. Телефон.
7. Email.
8. Telegram Chat ID.
9. Telegram @username.
10. Теги.
11. Ключ переменной клиента.
12. Значение переменной.
13. Кнопка «Создать и отправить»; слева «Импорт из файла» для загрузки CSV.

### Поля контакта

| Поле | Обязательное | Пример |
|---|---|---|
| Имя клиента | Да | Иван Петров |
| Телефон | Нет | +79991234567 |
| Email | Нет | ivan@mail.ru |
| Telegram Chat ID | Нет | 123456789 |
| Кастомные поля (JSON) | Нет | {"город": "Москва"} |

### Параметры импорта

| Параметр | Что делает |
|---|---|
| Общие теги | Присваиваются всем импортированным контактам |
| Обновлять существующие | Если клиент уже есть в базе, его данные обновятся. Совпадение ищется по телефону, email или Telegram ID |
| Первая строка: заголовки | Первая строка файла пропускается, если в ней названия столбцов |

### Как импортировать

1. Откройте раздел [Диалоги](https://lk.tuk-tuk.online/dialogs).
2. Нажмите «Импорт»: откроется окно загрузки файла.
3. Загрузите CSV-файл.
4. Сопоставьте столбцы файла с полями контакта и задайте параметры импорта.
5. Нажмите «Импортировать»: по окончании появится отчёт.

### Отчёт после импорта

| Показатель | Значение |
|---|---|
| Создано | Новых диалогов |
| Обновлено | Обновлённых диалогов (если включён параметр «Обновлять существующие») |
| Пропущено | Пустых или дублирующих строк |
| Всего | Обработанных строк |

## Экспорт диалогов


![Массовые действия над выбранными диалогами](https://docs.tuk-tuk.online/assets/screens/dialogs/bulk.webp "Режим выбора: отметьте диалоги, чтобы сменить статус, поставить теги или отправить в архив.")

### Как экспортировать

1. Откройте раздел [Диалоги](https://lk.tuk-tuk.online/dialogs).
2. Нажмите «Экспорт»: откроется окно с фильтрами.
3. Задайте, какие диалоги выгружать: по каналу, тегам и статусу, по дате сообщений, по наличию телефона или email.
4. Нажмите «Запросить экспорт»: запрос появится в списке экспортов со статусом «В очереди».

### Как идёт экспорт

Экспорт выполняется в фоне, ждать на странице не нужно. Когда файл готов, приходит уведомление.

| Этап | Что происходит |
|---|---|
| В очереди | Запрос принят и ждёт обработки |
| Обработка | Система собирает данные |
| Готово | Файл можно скачать |
| Ошибка | Экспорт не удался, причина в описании |

### Срок хранения файла

> [!WARNING] Готовый файл хранится 7 дней. За 3 часа до удаления приходит предупреждение. После удаления файл восстановить нельзя.

### История экспортов

Все запрошенные экспорты видны в списке. По каждому: дата запроса, кто запросил, количество записей, статус и ссылка на скачивание.

## Удаление тестовых диалогов

Во время настройки платформы часто появляются пробные диалоги: сообщения самому себе, проверка цепочек. Их можно удалить одной кнопкой.

1. Нажмите «Удалить тестовые».
2. Подтвердите действие: диалоги с пометкой «Тестовый» исчезнут из списка.

> [!NOTE] Удаляются только диалоги с пометкой «Тестовый». Рабочие диалоги не затрагиваются.