Проверка имен пользователей Telegram: существование аккаунта против доступности имени

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

Проверка существования имени пользователя Telegram отвечает на вопрос, отличный от того, который решают обычные инструменты проверки имен. Инструменты доступности сообщают, свободен ли идентификатор для регистрации; проверка существования показывает, привязан ли идентификатор из вашего списка к аккаунту Telegram в текущий момент. Для работы со списками TG Validator решает вторую задачу с помощью сервиса tg_username_batch, а tg_username_profile_batch добавляет дополнительные столбцы профиля для файлов того же типа. Оба сервиса работают как асинхронные пакетные задачи и возвращают один файл result.csv для скачивания.

Два вопроса, использующие одну поисковую фразу

Результаты поиска по запросу "telegram username checker" объединяют две задачи, которые выглядят похожими, но таковыми не являются.

Первая задача — доступность. Кому-то нужен новый идентификатор для бренда, канала или бота, и он хочет узнать, можно ли его зарегистрировать. Telegram документирует это как действие, выполняемое авторизованным пользователем: официальный метод account.checkUsername проверяет имя пользователя и сообщает, можно ли его использовать. Сторонние инструменты используют тот же принцип, а некоторые также просматривают торговые площадки на предмет идентификаторов, которые удерживаются или выставлены на продажу.

Вторая задача — существование. У команды уже есть список идентификаторов, собранный из форм, заметок CRM, экспортов сообществ или партнерских таблиц, и она хочет знать, какие из них все еще указывают на реальный аккаунт. Ответ на этот вопрос помогает очистить список, а не зарегистрировать имя.

Ответы могут даже выглядеть противоположными. Идентификатор, который в инструменте проверки доступности помечен как "занят", — это тот же идентификатор, который "существует" при проверке существования. Идентификатор, который является "свободным", — это тот, который в данный момент не относится ни к одному аккаунту. Если вы используете неподходящий инструмент, вы неверно интерпретируете результат, поэтому определитесь с вопросом, прежде чем выбирать инструмент.

Что показывает проверка существования

Для файлов с именами пользователей TG Validator предлагает два асинхронных пакетных сервиса:

Имена пользователей можно записывать как с символом @, так и без него, поэтому таблицу, в которой смешаны "@example_name" и "example_name", не нужно предварительно редактировать. В отличие от пакетных задач для номеров телефонов, задачи для имен пользователей не требуют выбора страны.

Два примечания помогут правильно интерпретировать результат. Во-первых, activedays, если этот параметр присутствует, — это приблизительное количество дней с момента последней активности; значение может быть неточным, если Telegram скрывает информацию о времени последнего посещения. Во-вторых, результат проверки существования описывает состояние идентификатора на момент проверки. Он подтверждает, что идентификатор соответствует аккаунту; он не описывает, кто управляет аккаунтом или как этот человек использует Telegram.

Запуск пакетной задачи для списка имен пользователей

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

1. Соберите идентификаторы в файл TXT или CSV, по одному имени пользователя в строке. Файлы XLSX не принимаются, поэтому экспортируйте простой столбец из вашей электронной таблицы.
2. Удалите лишний шум. Удалите пустые строки, полные ссылки t.me, вставленные в ячейку, и лишние пробелы. Избегайте дубликатов; идентификатор, проверенный дважды, — это две записи для обработки.
3. Выберите сервис. Используйте tg_username_batch, если вам нужно только узнать, какие идентификаторы существуют. Используйте tg_username_profile_batch, если для очистки списка вам также нужны uid, activedays или URL аватара.
4. Отправьте задачу. В API это POST /api/v1/bulk-tasks. Баланс для задачи резервируется при отправке и сверяется по завершении, при этом неиспользованная часть возвращается.
5. Запросите статус. GET /api/v1/bulk-tasks/{id} сообщает о статусе processing, success или failed. Прогресс по каждой записи не отображается, поэтому проверяйте статус не чаще одного раза в 30 секунд.
6. Скачайте result.csv, когда задача будет выполнена. Файл содержит столбец с вашим исходным идентификатором и столбец activated с результатом; дополнительные столбцы зависят от типа сервиса и могут быть пустыми.

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

Использование результатов для принятия решений по списку

Рассматривайте result.csv как фильтр, а не как окончательный вердикт. Практичный подход — разделить записи на три группы.

• Существует: идентификаторы, которые соответствуют аккаунту. Они остаются в активном списке и могут перейти на следующий этап проверки.
• Не существует: идентификаторы, для которых не найдено аккаунта. Это кандидаты на удаление или на уточнение у того, кто предоставил запись, так как опечатки и заброшенные идентификаторы выглядят здесь одинаково.
• Требует повторной проверки: строки с пустыми необязательными столбцами. Пустые значения в столбцах профиля — это нормальный результат, поэтому не считайте пустой URL аватара или activedays ошибкой импорта.

При использовании tg_username_profile_batch столбец uid полезен в качестве стабильного ключа. Владельцы могут изменять имена пользователей, в то время как uid остается привязанным к аккаунту, поэтому хранение uid рядом с именем пользователя позволяет сверять записи позже. Uid — это ключ базы данных для ваших собственных записей, он ничего не говорит о человеке, стоящем за аккаунтом.

Любой порог activedays — это ваше собственное бизнес-правило. Команда может откладывать строки с количеством дней выше выбранного значения для более легкого списка, но продукт не определяет, что считается активным, и число остается приблизительным.

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

• Использование инструмента проверки доступности для списка очистки. Он покажет, какие идентификаторы свободны для регистрации, что противоположно тому, что нужно для очистки.
• Смешивание номеров телефонов и имен пользователей в одном файле. Задачи для номеров телефонов требуют указания страны и международных кодов; задачи для имен пользователей не требуют выбора страны. Храните их в разных файлах и отправляйте как отдельные задачи.
• Ожидание информации о текущем присутствии. Ни один из сервисов для имен пользователей не сообщает, кто находится в сети прямо сейчас, и не раскрывает личные чаты, группы или контакты.
• Рассмотрение отсутствующего идентификатора как удаленного человека. Человек мог изменить идентификатор, и старый теперь не работает. Уточните у владельца данных, прежде чем удалять саму запись контакта.
• Слишком частые запросы статуса. Отправка задачи и запрос статуса каждые несколько секунд — это пустая трата вызовов. Подождите не менее 30 секунд между запросами.

Если ваш список содержит номера телефонов, а не идентификаторы, лучше подойдут сервис realtime tg и пакетные сервисы для номеров телефонов. Эти два подхода можно комбинировать, проверяя каждый тип ввода в отдельной задаче.

Часто задаваемые вопросы

В чем разница между проверкой существования имени пользователя Telegram и проверкой доступности?

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

Какие сервисы TG Validator проверяют имена пользователей?

tg_username_batch сообщает о существовании аккаунта для имен пользователей, а tg_username_profile_batch добавляет uid, activedays и URL аватара. Оба являются асинхронными пакетными сервисами, которые создают единый файл result.csv.

Как командам форматировать имена пользователей перед отправкой файла?

Используйте файл TXT или CSV с одним именем пользователя в строке. Имена пользователей можно записывать с символом @ или без него; для файлов с именами пользователей не нужно выбирать страну.

Как командам интерпретировать activedays в результатах профиля имени пользователя?

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

Можно ли проверять имена пользователей и номера телефонов в одной задаче?

Нет. Задачи для номеров телефонов и задачи для имен пользователей имеют разные правила ввода, поэтому команды отправляют их как отдельные файлы и задачи.

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

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

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