# Загрузка и выгрузка

Обе команды находятся в меню «⋯» справа над [списком контактов](https://support.watbot.ru/chatbots/contacts/list): «Выгрузить контакты» и «Загрузить контакты».

## Выгрузить контакты

Выгрузка собирает все контакты бота в файл Excel. Фильтры списка на неё не влияют.

1. В списке контактов нажмите «⋯» и выберите «Выгрузить контакты». Откроется страница «Скачать данные бота» с отмеченным пунктом «Контакты».
2. Нажмите «Создать архив». Вы попадёте в список «Данные бота для скачивания».
3. Дождитесь статуса «Готово» и нажмите «Получить ссылку», затем «Скачать».

![Страница «Скачать данные бота» с отмеченным пунктом «Контакты»](https://support.watbot.ru/_media/ru/01-chatbots/07-contacts/_images/export.webp?v=1791781230)

Архив собирается от нескольких секунд до нескольких часов — чем больше контактов, тем дольше. Статус в списке меняется сам: «Обработка», «Создание архива» с процентом готовности, «Готово» или «Ошибка». Страницу можно закрыть и вернуться позже: список архивов открывается и кнопкой «Скачать данные бота» в настройках бота, на вкладке «Дополнительно».

### Что в файле

Скачивается архив ZIP, внутри — таблица `contacts.xlsx`. Одна строка — один контакт.

| Колонка | Что в ней |
|---|---|
| ID | Номер контакта на платформе |
| Имя | Имя контакта |
| Мессенджер | Канал контакта |
| Username | Имя пользователя в Telegram или MAX, для ВКонтакте — номер страницы |
| Телефон, Email, Адрес | Данные, которые сохранил бот или указали вы |
| Первое сообщение | Текст, с которого человек начал переписку |
| Дата создания | Когда контакт появился в боте |
| Telegram ID, Max ID | Номер пользователя в мессенджере |
| Referrer ID | ID контакта, который пригласил этого человека |
| Теги | Теги контакта через запятую |
| Переменные | По одной колонке на каждую переменную из справочника «Подсказки по пользовательским переменным» |

Заголовки колонок пишутся на языке бота.

> [!NOTE]
> Переменная попадает в файл, только если её имя есть в [справочнике подсказок](https://support.watbot.ru/chatbots/contacts/tags-variables). Если вы удалили имя из справочника, колонки с этой переменной в выгрузке не будет, хотя значения у контактов останутся.

### Ограничения

- За сутки можно создать не больше 10 архивов на бота.
- Сотруднику для выгрузки контактов нужно право «Выгрузка контактов».

На той же странице «Скачать данные бота» можно отметить «Диалоги» и «Заявки» — тогда в архив попадут ещё и переписка с заявками. Об этих выгрузках — на странице [Выгрузка данных](https://support.watbot.ru/chatbots/manage/export).

## Загрузить контакты из Excel

Загрузка переносит в бота базу подписчиков Telegram из вашей таблицы: для каждого человека нужен его Telegram ID. Заодно контактам можно проставить теги и переменные.

1. В списке контактов нажмите «⋯» и выберите «Загрузить контакты». Откроется окно «Импорт контактов из Excel».
2. В поле «Мессенджер» оставьте Telegram.
3. Укажите, в каких колонках файла лежат данные. Колонки выбираются по буквам, как в Excel: A, B, C…
   - «Имя» — колонка с именем контакта;
   - «Telegram ID» — колонка с номером пользователя в Telegram;
   - «Теги» — нажмите «Добавить» и выберите колонку с тегами. В ячейке теги перечисляются через запятую;
   - «Переменные» — нажмите «Добавить», выберите колонку и напишите имя переменной, в которую попадёт значение. Строк можно добавить несколько.
4. Нажмите «Далее», загрузите файл Excel и ещё раз нажмите «Далее».

![Окно «Импорт контактов из Excel»: колонки имени, Telegram ID, тегов и переменных](https://support.watbot.ru/_media/ru/01-chatbots/07-contacts/_images/import.webp?v=1791781230)

Импорт идёт в фоне. В окне видно, сколько строк обработано: «Обработано строк», «Отклонено строк», «Обновлено записей», «Новые записи». Когда импорт закончится, появится строка «Импорт завершен» с датой. Кнопка «Импорт нового файла» возвращает к настройке колонок.

### Как обрабатываются строки

- Читается только первый лист файла, до первой строки, в которой пусты все выбранные колонки.
- Если контакт Telegram с таким ID уже есть в боте, он обновится: имя заменится, теги из файла добавятся к имеющимся, переменные запишутся заново. Если контакта нет — он будет создан.
- Строка без Telegram ID или с ID не из цифр отклоняется. Причина с номером ячейки появится в списке «Ошибки». Строка заголовков тоже попадёт в отклонённые — на остальные строки это не влияет.
- Если имя в строке пустое, вместо него запишется Telegram ID.
- Новые контакты входят в число контактов бота, от которого зависит [пакет подписки](https://support.watbot.ru/billing/pro).

## Если что-то не работает

- **«В сутки можно создавать не более 10 архивов.»** Лимит выгрузок на сегодня исчерпан. Скачайте один из готовых архивов или создайте новый позже.
- **«Выберите хотя бы один тип данных для скачивания.»** На странице «Скачать данные бота» не отмечен ни один пункт.
- **Кнопка «Получить ссылку» неактивна.** Архив ещё собирается. Дождитесь статуса «Готово».
- **«Новый импорт запустить невозможно пока идет предыдущий процесс».** Дождитесь окончания текущего импорта.
- **«Обработка принудительно остановлена. Слишком много ошибок.»** В файле набралось больше 1000 отклонённых строк. Проверьте, что колонки выбраны верно, и запустите импорт заново.