Исправление ошибок «Номер телефона должен быть в формате E.164»

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

Ошибка «номер телефона должен быть в формате E.164» означает, что для выполнения проверки регистрации в Telegram предоставленное значение должно быть приведено к международному формату. Начните с правильного кода страны и национального номера, добавьте в начало знак плюс и удалите символы отображения, а также любые национальные префиксы набора, которые не входят в международный формат. Проверьте преобразованное значение на соответствие исходной записи перед повторной отправкой; синтаксически корректный, но неверный номер все равно является ошибочным входным данным.

Что проверяет требование E.164

E.164 — это международный план нумерации, опубликованный Международным союзом электросвязи. В повседневном использовании его привычное представление начинается со знака плюс, за которым следуют код страны и национальный значимый номер. Знак плюс обозначает международный контекст набора; пробелы, скобки и дефисы могут помочь человеку прочитать номер телефона, но они не являются частью компактного значения, которое ожидает API проверки.

Ошибка форматирования возникает до получения значимого ответа о регистрации. Ее не следует записывать как «Не зарегистрирован» в Telegram. Реальная проверка регистрации по одному номеру в TG Validator требует, чтобы номер телефона был представлен в формате E.164. Как только ввод принят, результат проверки касается наличия учетной записи Telegram для этого номера на момент проверки. Сама проверка формата ничего не говорит о наличии учетной записи, личности, владении или разрешении на контакт.

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

Диагностика наиболее частых ошибок ввода

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

Twilio E.164 error guide иллюстрирует общее требование на стороне сервиса к такому же компактному виду. Оно не определяет результат регистрации в TG Validator. Для преобразования с учетом страны обратитесь к авторитетным руководствам по нумерации; общее правило «удалить все нули» небезопасно, так как ноль может входить в состав национального значимого номера.

Нормализация в контролируемой последовательности

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

Например, номер в национальном формате Великобритании может иметь начальный 0, используемый при внутреннем наборе. В международном представлении код страны Великобритании — +44, а этот внутренний префикс 0 обычно отбрасывается. Преобразование должно основываться на проверенном номере Великобритании; это не универсальное правило для всех стран. Определение национального префикса в ITU-T Recommendation E.164 объясняет, почему строка национального набора и международный номер могут отличаться. Держите исходное и преобразованное значения рядом, чтобы проверяющий мог заметить случайную потерю цифр.

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

Проверка того, что на самом деле хранит электронная таблица или CRM

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

Перед отправкой пакета экспортируйте небольшой образец и изучите необработанный TXT или CSV в средстве просмотра простого текста. Проверьте первую и последнюю строки, несколько записей с национальными префиксами и несколько международных записей. Подсчитайте количество цифр в исходных и преобразованных значениях для этих образцов. Если строка содержит добавочный номер, сохраните его в отдельном поле CRM; это не номер телефона для проверки регистрации в Telegram.

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

Повторная отправка после исправления ввода

Для одной записи используйте панель управления TG Validator «Проверка одного номера» или REST-проверку регистрации в реальном времени после нормализации. Одиночная REST-проверка соответствует задокументированному пути POST /api/v1/check. Завершенная проверка возвращает результат регистрации в той же сессии запроса. Неопределенная проверка — это отдельный результат с ненулевым бизнес-кодом; его не следует классифицировать как ошибку формата или как отрицательный результат регистрации.

Для небольшого набора маршрут пакетной проверки в реальном времени может проверить до 100 номеров через API, а «Пакетная проверка в реальном времени» на панели управления может принять до 500 вставленных номеров. Гораздо более длинный подготовленный список следует отдельному асинхронному рабочему процессу с массовыми файлами, с вводом TXT или CSV, мониторингом задач и загрузкой результатов. Ознакомьтесь с текущей документацией TG Validator API перед выбором маршрута или кодированием деталей запроса. Эти рабочие процессы различаются, но каждый из них выигрывает от одного и того же процесса нормализации с сохранением источника.

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

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

Как команды могут исправить отсутствие знака плюс в ошибке E.164?

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

Должны ли команды удалять все начальные нули из номеров телефонов?

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

Что должно произойти с записью, которая все еще выдает ошибку после нормализации?

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

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

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

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