Телефонные номера в формате E.164: как форматировать номера для Определение исходного оператора

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

Телефонный номер в формате E.164 записывается с ведущим знаком «плюс», кодом страны и номером абонента без пробелов, тире или скобок, например +442071838750. Согласно международному стандарту E.164, общая длина номера не должна превышать 15 цифр. Для выполнения Определение исходного оператора сначала преобразуйте каждый локальный номер в этот формат, удалив все национальные префиксы, такие как ведущий ноль. При проверке в реальном времени CarrierLookup ожидает наличие ведущего знака «плюс». В строках пакетных файлов используются те же цифры, но без знака «плюс», по одному номеру на строку. Если номер отклонен из-за формата, это означает наличие ошибки форматирования, которую необходимо исправить, а не отсутствие данных об операторе.

Что означает формат E.164

E.164 — это международный план нумерации, опубликованный ITU. Номер в этом плане состоит из трех частей: кода страны (от одной до трех цифр), национального кода назначения и номера абонента. В записи он представляет собой знак «плюс», за которым следуют только цифры. Общая длина ограничена 15 цифрами.

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

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

Пошаговое преобразование локальных форматов

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

1. Удалите все, что не является цифрой или ведущим знаком «плюс». Пробелы, точки, тире и скобки должны быть удалены.
2. Замените ведущий международный префикс набора. Номер, начинающийся с 00, за которым следует код страны, должен начинаться со знака «плюс» и кода страны.
3. Удалите национальный префикс. Во многих странах локальные номера записываются с ведущим нулем, который не является частью международного номера. Мобильный номер в Великобритании, записанный как 07911 123456, превращается в +447911123456, а номер в США (212) 555-0123 становится +12125550123 после добавления кода страны 1.
4. Добавьте код страны, если он отсутствует. Делайте это только в том случае, если вы знаете страну из другого поля, например, из платежного адреса или формы, из которой поступил контакт. Угадывание страны приводит к ошибкам, которые невозможно обнаружить позже.
5. Проверьте длину. Пустой результат или результат длиннее 15 цифр требует проверки вручную, а не автоматического запроса.

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

Проверка в реальном времени против пакетной обработки

CarrierLookup поддерживает два способа ввода, которые не являются взаимозаменяемыми.

Для проверки в реальном времени отправляйте номер в формате E.164 с ведущим знаком «плюс». Одиночная проверка использует POST /api/v1/check, а синхронный множественный запрос — POST /api/v1/batch-check. Проверки в реальном времени не требуют отдельного выбора страны, поэтому один запрос может содержать номера из разных стран.

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

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

Почему отклоненный формат — это не отсутствие данных об операторе

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

Разделяйте три исхода в вашем рабочем процессе:

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

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

Типичные ошибки форматирования

Большинство проблем с форматом возникают из-за нескольких привычек.

• Сохранение национального нуля после кода страны. +4407911123456 — это ошибка. Ноль относится только к локальному формату.
• Использование разных разделителей в одном столбце. Одно четкое правило для всех данных лучше, чем десяток исключений.
• Обработка номеров как числовых данных в электронных таблицах. Ведущие знаки «плюс» и нули исчезают. Храните столбец в текстовом формате.
• Общие коды стран. Несколько стран используют код +1, поэтому один лишь код не идентифицирует страну однозначно. Для пакетных задач выбирайте страну, соответствующую списку.
• Угадывание страны для локального номера. Используйте другое надежное поле или исключите строку.

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

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

Как команды могут преобразовать локальный номер в формат E.164?

Удалите все пробелы и разделители, отбросьте национальный префикс (например, ведущий ноль) и добавьте знак «плюс» и код страны в начало. Добавляйте код страны только в том случае, если другое надежное поле идентифицирует страну. Сохраняйте исходное значение в отдельном столбце для аудита.

Как команды могут подготовить номера для пакетной задачи?

Запишите по одному номеру на строку в файле TXT или CSV в виде цифр с кодом страны без знака «плюс», затем выберите страну, соответствующую списку. Строки, которые являются недействительными, дублирующимися или относятся к другой стране, исключаются при предварительной обработке и не тарифицируются.

Как команды должны обрабатывать отклоненный номер при проверке?

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

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

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

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