Массовая проверка номеров в Telegram: как проверить большой список на регистрацию

Пошаговое руководство по проверке регистрации в Telegram для больших списков телефонных номеров с помощью асинхронной задачи tg_batch: от подготовки файла до получения result.csv.

Массовая проверка номеров в Telegram — это асинхронная задача: вы загружаете файл в формате TXT или CSV с одним номером телефона в каждой строке, выбираете страну и сервис tg_batch, дожидаетесь завершения задачи, а затем скачиваете готовый файл result.csv. Он показывает, был ли номер зарегистрирован в Telegram на момент проверки, что помогает команде решить, какие записи оставить в списке для рассылки в Telegram. Сам Telegram не предоставляет официальных инструментов для массовой проверки, поэтому для больших списков требуется специализированный сервис, а не просто вставка данных в форму.

Когда массовая задача — подходящий инструмент

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

Ограничения для каждого способа указаны в актуальной документации API, поэтому ознакомьтесь с ними перед планированием большого объема проверок.

Подготовка файла для массовой проверки номеров в Telegram

Большинство неудачных или отклоненных задач связаны с ошибками в исходном файле. Перед загрузкой:

• Используйте обычный файл TXT или CSV с одним номером телефона в строке. Форматы электронных таблиц, такие как XLSX, не поддерживаются, поэтому сначала сохраните файл в формате CSV.
• Указывайте каждый номер с международным кодом страны.
• Выберите одну страну для задачи. Массовые проверки номеров привязаны к одной выбранной стране, и файл, содержащий преимущественно номера с другими кодами, может быть отклонен. Разделите смешанные списки по странам и отправляйте по одной задаче на каждую страну.
• Удалите явные дубликаты и пустые строки, чтобы не платить за проверку одного и того же номера дважды.
• Исключите из файла номера для материкового Китая, Hong Kong и Macau: асинхронные массовые задачи не охватывают эти регионы.

Если вы не уверены в формате, ознакомьтесь с руководством по ITU-T Recommendation E.164 перед нормализацией списка.

Отправка задачи tg_batch и ожидание

Сервис для массовой проверки только на наличие регистрации называется tg_batch. В панели управления выберите опцию «Массовая проверка», загрузите файл и укажите страну и сервис. Через API задача создается с помощью POST /api/v1/bulk-tasks, а ее статус проверяется через GET /api/v1/bulk-tasks/{id}.

Следует учитывать три особенности:

1. Баланс резервируется при отправке. Платформа заранее резервирует средства для всего файла, списывает оплату за записи, по которым получены результаты, и возвращает неиспользованный остаток после завершения задачи. Если задача завершается с ошибкой, весь резерв возвращается.
2. Отсутствие прогресса по каждому номеру. Задача сообщает о статусах processing, success или failed, поэтому выстраивайте рабочий процесс вокруг этих трех состояний, а не индикатора выполнения.
3. Опрашивайте статус умеренно. Проверяйте статус задачи не чаще, чем раз в 30 секунд. Более частые запросы создают лишнюю нагрузку, не ускоряя получение результатов.

Время выполнения зависит от файла, поэтому не стоит обещать заинтересованным лицам фиксированные сроки.

Работа с result.csv

Завершенная задача предоставляет один файл result.csv для скачивания. Для tg_batch он содержит исходный номер и столбец, показывающий, был ли номер зарегистрирован. Рассматривайте этот столбец как сигнал о наличии учетной записи в Telegram на момент проверки.

Практический способ использования:

• Зарегистрирован: оставьте в сегменте Telegram для рассылки.
• Не зарегистрирован: направьте в другой канал или исключите из кампаний в Telegram.
• Отсутствующие или пустые строки: отправьте их повторно в более поздней, небольшой задаче или проверьте вручную.

Регистрация не означает, что пользователь активен, что номер принадлежит ожидаемому вами контакту или что пользователь дал согласие на получение сообщений. Если вам также нужен приблизительный сигнал о недавней активности, другой массовый сервис, tg_active_batch, возвращает дополнительные столбцы; держите результаты каждого сервиса отдельно, не предполагая, что все файлы имеют одинаковую структуру.

Распространенные ошибки при проверке больших списков

• Загрузка файла со смешанными странами и попытка понять правила через отклонение задачи.
• Отправка без удаления дубликатов, что увеличивает объем зарезервированных средств.
• Опрос статуса каждые несколько секунд в цикле.
• Восприятие регистрации как доказательства согласия или подтверждения личности.
• Повторная отправка всего файла для исправления нескольких строк вместо отправки только оставшихся.

Для получения информации о биллинге ознакомьтесь с актуальной страницей цен и документацией API, а не полагайтесь на цифры, указанные в статьях.

FAQ

Может ли команда проверить список Telegram без собственного аккаунта Telegram?

Да. Команды отправляют файл в сервис проверки через панель управления или REST API и скачивают result.csv, поэтому личный логин в Telegram для проверки не требуется.

Как командам работать со списком, содержащим несколько стран?

Разделите файл по странам и отправьте по одной задаче tg_batch для каждой, так как массовые проверки номеров привязаны к выбранной стране.

Как работает баланс для массовой задачи?

Баланс резервируется при отправке задачи, списывается за записи, по которым получены результаты, а неиспользованный остаток возвращается. При сбое задачи весь резерв возвращается.

Означает ли статус «Зарегистрирован», что контакт ответит?

Нет.

Узнать больше

Выберите информацию о продукте, соответствующую следующему шагу вашего рабочего процесса.

• Просмотреть документацию по продукту →
• Связаться с командой →