Загрузка и выгрузка
Обе команды находятся в меню «⋯» справа над списком контактов: «Выгрузить контакты» и «Загрузить контакты».
Выгрузить контакты
Выгрузка собирает все контакты бота в файл Excel. Фильтры списка на неё не влияют.
- В списке контактов нажмите «⋯» и выберите «Выгрузить контакты». Откроется страница «Скачать данные бота» с отмеченным пунктом «Контакты».
- Нажмите «Создать архив». Вы попадёте в список «Данные бота для скачивания».
- Дождитесь статуса «Готово» и нажмите «Получить ссылку», затем «Скачать».
Архив собирается от нескольких секунд до нескольких часов — чем больше контактов, тем дольше. Статус в списке меняется сам: «Обработка», «Создание архива» с процентом готовности, «Готово» или «Ошибка». Страницу можно закрыть и вернуться позже: список архивов открывается и кнопкой «Скачать данные бота» в настройках бота, на вкладке «Дополнительно».
Что в файле
Скачивается архив ZIP, внутри — таблица contacts.xlsx. Одна строка — один контакт.
| Колонка | Что в ней |
|---|---|
| ID | Номер контакта на платформе |
| Имя | Имя контакта |
| Мессенджер | Канал контакта |
| Username | Имя пользователя в Telegram или MAX, для ВКонтакте — номер страницы |
| Телефон, Email, Адрес | Данные, которые сохранил бот или указали вы |
| Первое сообщение | Текст, с которого человек начал переписку |
| Дата создания | Когда контакт появился в боте |
| Telegram ID, Max ID | Номер пользователя в мессенджере |
| Referrer ID | ID контакта, который пригласил этого человека |
| Теги | Теги контакта через запятую |
| Переменные | По одной колонке на каждую переменную из справочника «Подсказки по пользовательским переменным» |
Заголовки колонок пишутся на языке бота.
Заметка
Переменная попадает в файл, только если её имя есть в справочнике подсказок. Если вы удалили имя из справочника, колонки с этой переменной в выгрузке не будет, хотя значения у контактов останутся.
Ограничения
- За сутки можно создать не больше 10 архивов на бота.
- Сотруднику для выгрузки контактов нужно право «Выгрузка контактов».
На той же странице «Скачать данные бота» можно отметить «Диалоги» и «Заявки» — тогда в архив попадут ещё и переписка с заявками. Об этих выгрузках — на странице Выгрузка данных.
Загрузить контакты из Excel
Загрузка переносит в бота базу подписчиков Telegram из вашей таблицы: для каждого человека нужен его Telegram ID. Заодно контактам можно проставить теги и переменные.
- В списке контактов нажмите «⋯» и выберите «Загрузить контакты». Откроется окно «Импорт контактов из Excel».
- В поле «Мессенджер» оставьте Telegram.
- Укажите, в каких колонках файла лежат данные. Колонки выбираются по буквам, как в Excel: A, B, C…
- «Имя» — колонка с именем контакта;
- «Telegram ID» — колонка с номером пользователя в Telegram;
- «Теги» — нажмите «Добавить» и выберите колонку с тегами. В ячейке теги перечисляются через запятую;
- «Переменные» — нажмите «Добавить», выберите колонку и напишите имя переменной, в которую попадёт значение. Строк можно добавить несколько.
- Нажмите «Далее», загрузите файл Excel и ещё раз нажмите «Далее».
Импорт идёт в фоне. В окне видно, сколько строк обработано: «Обработано строк», «Отклонено строк», «Обновлено записей», «Новые записи». Когда импорт закончится, появится строка «Импорт завершен» с датой. Кнопка «Импорт нового файла» возвращает к настройке колонок.
Как обрабатываются строки
- Читается только первый лист файла, до первой строки, в которой пусты все выбранные колонки.
- Если контакт Telegram с таким ID уже есть в боте, он обновится: имя заменится, теги из файла добавятся к имеющимся, переменные запишутся заново. Если контакта нет — он будет создан.
- Строка без Telegram ID или с ID не из цифр отклоняется. Причина с номером ячейки появится в списке «Ошибки». Строка заголовков тоже попадёт в отклонённые — на остальные строки это не влияет.
- Если имя в строке пустое, вместо него запишется Telegram ID.
- Новые контакты входят в число контактов бота, от которого зависит пакет подписки.
Если что-то не работает
- «В сутки можно создавать не более 10 архивов.» Лимит выгрузок на сегодня исчерпан. Скачайте один из готовых архивов или создайте новый позже.
- «Выберите хотя бы один тип данных для скачивания.» На странице «Скачать данные бота» не отмечен ни один пункт.
- Кнопка «Получить ссылку» неактивна. Архив ещё собирается. Дождитесь статуса «Готово».
- «Новый импорт запустить невозможно пока идет предыдущий процесс». Дождитесь окончания текущего импорта.
- «Обработка принудительно остановлена. Слишком много ошибок.» В файле набралось больше 1000 отклонённых строк. Проверьте, что колонки выбраны верно, и запустите импорт заново.