Как преобразовать список номеров в формат E.164 перед проверкой в Telegram
Пошаговое руководство по преобразованию номеров в формат E.164: удаление символов, префиксов, добавление кодов стран и проверка перед использованием в Telegram.
Рабочий процесс на уровне электронной таблицы для приведения локальных номеров телефонов к формату E.164, чтобы их могла распознать Проверка регистрации в Telegram или файл для массовой проверки по одной стране.
Чтобы преобразовать номера телефонов в E.164, удалите пробелы и символы, уберите национальный префикс (например, ведущий ноль) и добавьте знак «плюс», за которым следует код страны и оставшиеся цифры. Результат не должен содержать пробелов или знаков препинания и должен состоять максимум из 15 цифр. Выполнение этой операции в электронной таблице перед Проверкой регистрации в Telegram позволяет корректно считывать номера как при проверке в реальном времени, так и в файлах для массовой проверки по одной стране.
Требования стандарта E.164
E.164 — это международный план нумерации для публичных телекоммуникаций, опубликованный ITU и описанный на странице рекомендаций ITU. В повседневной работе с данными это означает единый канонический вид: знак «плюс», код страны, затем номер абонента, включая код города, без пробелов, скобок и дефисов. Общая длина составляет не более 15 цифр.
Две привычки чаще всего приводят к ошибкам преобразования. Первая — это обращение с локальным номером как с международным. Номер, записанный так, как его набирают внутри страны, часто начинается с префикса, который не является частью международного формата. Вторая — это восприятие знака «плюс» как декоративного элемента. В электронных таблицах ведущий плюс часто интерпретируется как оператор формулы, поэтому ячейка может его автоматически удалять.
Проверка в реальном времени от TG Validator принимает один номер телефона в формате E.164. Панель управления и файлы для массовой проверки номеров телефонов ожидают международные коды стран, поэтому чистый столбец E.164 — это правильная подготовка для любого из этих методов.
Шаг 1: Установите текстовый формат столбца и создайте резервную копию
Прежде чем что-либо менять, скопируйте исходный столбец на новый лист или вкладку. В процессе преобразования легко допустить ошибку, а нетронутый оригинал позволит восстановить любой номер.
Затем установите формат рабочего столбца на «обычный текст». В Excel или Google Sheets это предотвратит удаление ведущих нулей или интерпретацию ведущего плюса как арифметического действия. Если файл поступает в формате CSV, импортируйте его, явно указав тип столбца с телефонами как текстовый, вместо того чтобы позволять программе угадывать формат.
Шаг 2: Удалите все, что не является цифрой
Удалите пробелы, дефисы, точки, скобки и любой текст, например, метки добавочных номеров. В Google Sheets замена по регулярному выражению для столбца выполняет это за один шаг: замените любой нецифровой символ на пустоту. В Excel вложенные функции SUBSTITUTE для каждого символа позволяют достичь того же результата, или же шаг очистки текста в Power Query может обработать весь столбец целиком.
Отметьте номера, которые начинались со знака «плюс» или с международного префикса «00» перед удалением. Они уже содержат код страны и требуют иного подхода на следующем шаге. Вспомогательный столбец, фиксирующий, начинался ли оригинал с плюса или двойного нуля, упростит эту задачу.
Шаг 3: Удалите префикс и добавьте код страны
Этот шаг требует индивидуального решения для каждой страны, поэтому работайте с каждой страной отдельно.
- Уже международный формат. Если оригинал начинался с плюса или префикса «00», следующие за ними цифры — это код страны и номер. Удалите префикс «00» и поставьте плюс в начале.
- Локальный номер с префиксом. Во многих странах национальные номера пишутся с ведущим нулем, который отбрасывается в международном формате. Удалите эту первую цифру, затем добавьте плюс и код страны.
- Локальный номер без префикса. В некоторых национальных планах нумерации нет префикса, поэтому цифры остаются без изменений, добавляется только плюс и код страны.
Для таблицы со столбцом страны, справочная таблица соответствия названия страны коду, а также столбец, фиксирующий использование ведущей цифры префикса, позволяют автоматизировать формулу. Результатом будет один новый столбец: плюс, код, затем номер с удаленным префиксом там, где это применимо.
Не пытайтесь угадать страну для номера, если она не указана. Список строк без четко определенной страны лучше отложить в сторону, чем присваивать им значение по умолчанию, которое отправит их в неверную группу.
Шаг 4: Проверьте длину и найдите аномалии
Несколько быстрых проверок позволяют выявить большинство ошибок, пропущенных формулами.
- Длина. После знака «плюс» номер должен содержать не более 15 цифр. Все, что длиннее, является ошибкой.
- Слишком короткие номера. Очень короткие результаты обычно означают пропущенный код города или вставленный добавочный номер.
- Повторяющиеся коды стран. Номер, который уже содержал код и получил его повторно, будет начинаться с кода дважды. Отсортируйте по первым нескольким цифрам, чтобы обнаружить такие случаи.
- Смешанные страны в файле для одной страны. Массовые задачи по номерам телефонов работают с одной выбранной страной, поэтому группируйте строки по коду страны и экспортируйте по одному файлу на страну. Список должен состоять преимущественно из номеров выбранной страны, так как файл с большой долей кодов других стран будет отклонен.
Сохраняйте вкладку с отклоненными номерами, содержащую исходное значение, преобразованное значение и причину ошибки. Эта вкладка станет рабочим списком для ручного исправления.
Шаг 5: Экспорт для проверки в реальном времени или массового файла
Выберите маршрут в зависимости от размера списка.
Для небольшого набора используйте Проверку регистрации в Telegram в реальном времени. REST-маршрут — POST /api/v1/check, аутентификация через X-API-Key, с одним номером в формате E.164 и типом сервиса tg, а POST /api/v1/batch-check принимает до 100 номеров в одном запросе. Вкладка Batch Check в панели управления принимает до 500 вставленных номеров. Все они возвращают результат в рамках одной сессии.
Для списка, значительно превышающего этот объем, экспортируйте файл TXT или CSV с одним номером на строку, загрузите его как массовую задачу для выбранной страны, дождитесь выполнения задачи и скачайте result.csv. Точные лимиты для каждого сервиса указаны в текущей документации API и на странице цен, поэтому ознакомьтесь с ними перед запуском большого объема.
Номера материкового Китая, Гонконга и Макао можно проверять по одному в небольших объемах через проверку в реальном времени, но асинхронные массовые файлы не поддерживают эти регионы, поэтому исключите их из массового экспорта.
Что дает и чего не дает чистый файл E.164
Правильное форматирование устраняет наиболее распространенную причину нечитаемости входных данных, но не меняет смысл проверки. Результат регистрации — это сигнал о наличии учетной записи на платформе в момент проверки. Он не показывает активность, личность, владение, согласие или вероятность ответа, поэтому придерживайтесь своих обычных правил получения разрешений и оценки релевантности после проверки.
Полезная привычка — сохранять преобразованный столбец рядом с оригиналом в основной таблице с датой преобразования, чтобы последующие импорты можно было сопоставить без повторения работы.
Часто задаваемые вопросы
Как команды могут преобразовать локальные номера телефонов в E.164 в электронной таблице?
Команды могут удалить нецифровые символы, убрать национальный префикс, а затем добавить знак «плюс» и код страны. Работа с одной страной за раз с использованием справочной таблицы делает формулу простой.
Какова максимальная длина номера E.164?
Номер E.164 содержит не более 15 цифр после знака «плюс», без пробелов и знаков препинания. Более длинные результаты обычно указывают на дублирование кода страны.
Как команды могут предотвратить удаление ведущего знака «плюс» в электронной таблице?
Установите формат столбца с телефонами как «обычный текст» перед вводом или импортом значений, а также импортируйте файлы CSV с указанием типа столбца как текстового, чтобы знак «плюс» и ведущие нули сохранялись.
Нужна ли для массовых файлов Telegram одна страна?
Да. Массовые задачи по номерам телефонов работают с одной выбранной страной, поэтому группируйте строки по коду страны и экспортируйте по одному файлу на страну; файлы с большой долей кодов других стран отклоняются.
Узнать больше
Выберите информацию о продукте, которая соответствует следующему шагу вашего рабочего процесса.