Telegram ID Checker: получение значений uid для списка телефонов или имен пользователей

Три пакетных сервиса TG Validator возвращают столбец uid, который команды могут хранить в качестве стабильного ключа рядом с номерами телефонов или именами пользователей.

Идентификатор пользователя Telegram (user ID) — это числовой ключ, который Telegram использует внутри системы для учетной записи. Большинство советов по запросу "telegram id checker" сводятся к использованию ботов для поиска ID по одному пересланному сообщению. Для обработки целого списка TG Validator возвращает столбец uid в трех асинхронных пакетных сервисах: tg_active_batch и tg_profile_batch для файлов с номерами телефонов, а также tg_username_profile_batch для файлов с именами пользователей. Значение uid работает как стабильный ключ для дедупликации и сверки ваших собственных записей.

Что такое идентификатор пользователя Telegram и откуда берутся стандартные советы

Каждая учетная запись Telegram имеет числовой идентификатор пользователя. В отличие от имени пользователя (username), которое владелец может изменить или удалить, этот номер остается привязанным к учетной записи, поэтому разработчики и администраторы CRM предпочитают хранить именно его.

Распространенные советы по поиску идентификатора пользователя Telegram делятся на три группы:

• Боты для поиска. Вы пересылаете сообщение или открываете профиль в Telegram, и бот отвечает числом. Это подходит для одного человека, с которым вы уже общаетесь.
• Самостоятельно развернутые скрипты. Проекты с открытым исходным кодом, например Telegram ID Finder Bot, позволяют запустить бота на собственном сервере и получать ID пользователей, групп и каналов.
• Скрипты для номеров телефонов. Инструменты в стиле telegram-phone-number-checker от Bellingcat используют ваши учетные данные Telegram API для проверки номера и могут вернуть имя пользователя и ID, если настройки учетной записи это позволяют.

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

Какие сервисы TG Validator возвращают uid

Проверка списков осуществляется через пакетные сервисы. Три из пяти асинхронных типов включают столбец uid:

Сервис tg в режиме реального времени, используемый для проверки одного номера через API и на вкладках панели управления, сообщает только статус регистрации и не возвращает uid. Если вам нужен этот ключ, перенесите список в пакетную задачу.

Строки, для которых у сервиса нет данных, сохраняют свое место в файле с пустыми необязательными столбцами. Планируйте импорт так, чтобы пустой uid считался нормальной строкой, а не ошибкой.

Пошаговое получение uid для списка

1. Выберите сервис, соответствующий вашим входным данным. Номера телефонов отправляются в tg_active_batch или tg_profile_batch; имена пользователей — в tg_username_profile_batch. Выбирайте tg_profile_batch, только если вам нужны оценки на основе аватара, так как более легкий tg_active_batch уже возвращает uid.
2. Подготовьте файл. Используйте формат TXT или CSV с одной записью в строке. Для номеров телефонов используйте международный формат и старайтесь, чтобы файл содержал номера преимущественно одной страны, так как пакетные задачи для номеров телефонов требуют указания страны, а файлы со значительной долей кодов других стран отклоняются. Номера материкового Китая, Гонконга и Макао в пакетных задачах не поддерживаются. Для имен пользователей страна не требуется, а символ @ можно как включать, так и опускать.
3. Отправьте задачу через раздел Bulk Check на панели управления или через POST /api/v1/bulk-tasks, используя заголовок X-API-Key. Никогда не вставляйте реальный ключ в общие документы.
4. Опрашивайте статус выполнения с помощью GET /api/v1/bulk-tasks/{id} не чаще чем раз в 30 секунд. Статус может быть processing, success или failed.
5. Скачайте result.csv и объедините его с исходным списком по столбцу идентификатора, который дублирует каждую исходную запись.

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

Использование uid в качестве стабильного ключа

Когда столбец попадает в вашу CRM или базу данных, uid помогает поддерживать гигиену данных, а не раскрывать информацию о человеке.

Дедупликация из разных источников. Одна и та же учетная запись может поступить как номер телефона из формы, имя пользователя из экспорта сообщества и снова как имя пользователя после переименования. Если обе строки возвращают один и тот же uid, они указывают на одну учетную запись, и вы можете объединить их в одну запись.

Сохранение данных при смене имени пользователя. Храните uid рядом с собранным именем пользователя. Когда имя изменится, вы все равно сможете сопоставить запись по uid, не создавая дубликат.

Создание столбца для объединения при экспорте. Многие внутренние инструменты лучше работают с числовыми ключами, чем с текстовыми именами. Столбец uid упрощает создание связей между таблицей контактов и таблицей кампаний.

Отделение от полей идентификации. Не храните uid в поле с названием "проверенный пользователь" и не используйте его, чтобы утверждать, что вы знаете, кто именно является владельцем контакта. Это технический ключ, а сигнал регистрации за ним лишь описывает наличие учетной записи на момент проверки.

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

Чего uid вам не дает

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

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

Если вам нужно найти один ID в Telegram во время общения с кем-то, бот для поиска будет проще. Если вам нужен согласованный ключ для тысяч строк, пакетные сервисы предоставят вам один файл и один процесс для документирования.

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

Какие сервисы TG Validator возвращают uid?

tg_active_batch и tg_profile_batch возвращают его для файлов с номерами телефонов, а tg_username_profile_batch — для файлов с именами пользователей. Сервис tg в реальном времени, а также tg_batch и tg_username_batch не включают uid.

Как команды могут использовать uid в CRM?

Команды хранят его рядом с номером телефона или именем пользователя в качестве стабильного ключа. Это помогает объединять дублирующиеся записи и сохранять соответствие после смены имени пользователя.

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

Да. tg_username_profile_batch принимает имена пользователей (с @ или без), не требует указания страны и возвращает uid вместе с activedays и URL аватара.

Как командам обрабатывать пустые ячейки uid?

Относитесь к пустой ячейке как к нормальному результату для необязательных столбцов. Сохраняйте строку, помечайте ее для своих правил проверки и не считайте это неудачным импортом.

Возвращает ли проверку в реальном времени uid?

Нет. Сервис tg в реальном времени возвращает статус регистрации для номера в формате E.164. Перенесите список в пакетный сервис, если вам нужен uid.

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

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

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