Зарегистрируйтесь и обратитесь в поддержку, чтобы получить 100 бесплатных проверок.Зарегистрироваться бесплатно
Иллюстрация процесса CarrierLookup к статье «Определение исходного оператора для телефонных номеров России (+7)»
Наглядная схема процесса, рассматриваемого в этой статье CarrierLookup.

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

Определение исходного оператора для телефонного номера России позволяет узнать, к какому диапазону номеров +7 изначально относился номер, а также получить информацию о типе линии и географии распределения. Этот инструмент не показывает, какой оператор обслуживает номер в данный момент (после переноса), и не определяет текущее местоположение пользователя. Для проверки нескольких номеров используйте синхронный запрос; для подготовленного списка номеров России — файловую задачу с выбором страны. Тщательно проверяйте принадлежность к стране, так как код +7 используется как Россией, так и Казахстаном.

Начните с понимания номера +7

Одного префикса +7 недостаточно, чтобы определить, относится ли запись к списку России или Казахстана. Оперативный бюллетень ITU по зоне нумерации +7 описывает совместное использование этого кода Российской Федерацией и Казахстаном и распределяет диапазоны между ними. Команде CRM следует использовать надежные источники данных и соответствующие правила нумерации, а не помечать каждый контакт с +7 как российский. Это особенно важно при подготовке файловой задачи, где требуется выбрать одну страну.

Приведите номер к формату E.164 для проверки в реальном времени: знак «плюс», код страны и номер абонента без пробелов и разделителей. Сохраняйте исходное значение отдельно, чтобы можно было отследить исправления. Отклоненный формат — это проблема ввода, а не признак того, что у номера нет оператора. Если запись невозможно уверенно отнести к нужной стране, отложите ее для проверки перед созданием файла для России.

Результатом является контекст исходного распределения номера. Поле carrier указывает оператора, которому диапазон был назначен изначально. Это не запрос к текущей сети номера. Перенесенный номер может обслуживаться другим оператором. Команде следует называть поле в CRM «исходный оператор» (originally allocated carrier), а не просто «текущий оператор», чтобы не вводить в заблуждение пользователей.

Выберите синхронный запрос для небольшого количества записей

Сервис Определение исходного оператора от CarrierLookup поддерживает API-запросы для одного номера и синхронные запросы для нескольких номеров. POST /api/v1/check принимает один номер в формате E.164. POST /api/v1/batch-check принимает от 1 до 100 номеров и возвращает упорядоченные результаты в рамках одного потока запроса; номера могут быть из разных стран. Панель управления поддерживает отдельный лимит для вставки номеров. Документация API является основным справочником для выполнения запросов и обработки результатов.

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

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

Подготовьте файловую задачу для большого списка

Для большого подготовленного списка используйте отдельный Глобальный поиск оператора — асинхронную файловую задачу. Входными данными является TXT или CSV файл с одним номером на строку (с кодом страны) и выбранным ISO-кодом страны. Задача для России должна содержать записи, относящиеся к России, а не смесь всех номеров +7 из региональной CRM. Предварительная обработка исключает недействительные, дублирующиеся, некодированные и зарубежные строки. В документации API указаны текущие лимиты на ввод и размер файла, которые следует проверить перед отправкой.

Файловая задача проходит стадии обработки, успеха или ошибки. Опрашивайте статус не чаще одного раза в 30 секунд. После успешного завершения скачайте один CSV-файл; это не ZIP-архив и не потоковая передача данных по каждому номеру. Идентификатор в файле bulk — это цифры с кодом страны без знака «плюс», поэтому при объединении данных в CRM следует учитывать этот формат. Используйте стабильные исходные ID в своей системе, сравнивайте подготовленные входные данные с полученным результатом и откладывайте несовпадающие строки для проверки.

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

Чтение полей распределения без преувеличений

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

Для очистки CRM сохраняйте понятия «проверка принадлежности к стране», «исходный оператор», «тип номера» и «регион распределения» как отдельные категории. Запись с неожиданным регионом может потребовать проверки исходных данных, но сам по себе поиск не может установить неверный адрес или право собственности. Если запись с +7, предназначенная для России, может принадлежать Казахстану, верните ее на этап проверки страны, а не принудительно включайте в российский сегмент.

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

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

Означает ли +7 всегда российский номер?

Нет. Россия и Казахстан совместно используют зону нумерации +7, поэтому для определения страны недостаточно одного префикса.

Может ли поиск показать текущего оператора после переноса номера?

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

Что означает регион в результате?

Это география распределения диапазона номеров, а не текущее местоположение человека или устройства.

Когда команде следует использовать файловую задачу?

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

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

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

Источники