Зарегистрируйтесь и обратитесь в поддержку, чтобы получить 100 бесплатных проверок.Зарегистрироваться бесплатно
Иллюстрация процесса CarrierLookup к статье «Определение оператора связи для номеров США: данные об исходном операторе для номеров +1»
Наглядная схема процесса, рассматриваемого в этой статье CarrierLookup.

Узнайте исходного оператора, тип номера и географию распределения для номеров США с учетом переноса номеров и подготовки списков.

Определение оператора связи по номеру телефона США позволяет узнать оператора, которому был изначально выделен диапазон номеров +1, а также тип номера и географию его распределения. Этот метод не определяет оператора, обслуживающего перенесенный номер в настоящее время. Для проверки нескольких номеров используйте синхронный запрос, а для подготовки списка по всей стране — отдельную задачу с файлом, выбрав Соединенные Штаты, и проверьте полученные значения перед добавлением их в CRM.

Подготовка номера США +1 для единичного запроса

Начните с проверенного исходного номера США. В формате E.164 значение начинается с +1, за которым следует национальный номер без пробелов, скобок и дефисов. Не считайте по умолчанию, что каждый номер +1 принадлежит США: Канада и другие страны Североамериканского плана нумерации также используют +1. Исходная запись или другие надежные данные о стране должны подтверждать, что номер относится к списку США.

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

Функция Определение исходного оператора в реальном времени от CarrierLookup принимает один номер E.164 через панель управления или POST /api/v1/check. Она возвращает результат в том же сеансе при завершении обработки. Начните с одной известной строки, чтобы убедиться, что нормализация и сопоставление полей в вашей команде работают корректно, прежде чем обрабатывать остальную часть списка.

Чтение данных об операторе и регионе как контекста распределения

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

FCC разъясняет перенос номеров как сохранение номера при смене провайдера. Таким образом, перенесенный номер США может обслуживаться другим провайдером, отличным от того, который указан в данных об исходном распределении. В поле CRM следует указывать «исходный оператор», а не просто «оператор», чтобы это различие было очевидно для будущих пользователей. Если команде требуется иная концепция оператора, следует выбрать отдельно задокументированный источник для этого вопроса.

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

Использование вставки пакета для короткого списка США

Когда у оператора есть несколько записей для проверки, CarrierLookup предлагает пакетную проверку в реальном времени через панель управления для вставки до 500 номеров. Синхронный мульти-эндпоинт REST принимает до 100 номеров E.164 и возвращает упорядоченные результаты в рамках одного сеанса запроса. Маршрут REST multi может включать номера из разных стран, но каждый ввод должен быть сопоставлен с собственной исходной записью и известной страной.

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

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

Подготовка более крупной задачи с файлом только для США

Для большого объема данных в CarrierLookup предусмотрен асинхронный рабочий процесс для глобальной проверки оператора через файл. Подготовьте одностолбцовый файл TXT или CSV с одним номером с кодом страны в каждой строке и выберите Соединенные Штаты при отправке. Список должен состоять преимущественно из номеров выбранной страны. Поскольку код +1 является общим, не делайте вывод о принадлежности к США только на основе кода страны; используйте доверенные данные CRM о стране, чтобы отделить записи США от остальных перед созданием файла.

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

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

Использование результата без преувеличения возможностей

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

Выборочно проверяйте импортированные результаты. Сравнивайте исходные номера с нормализованными данными, проверяйте записи из нескольких кодов городов и убедитесь, что пустые поля остались пустыми. Проверяйте любую двусмысленность США/Канады в исходных данных +1. Если запись исправляется позже, выполните новую проверку для исправленного номера и сохраните предыдущую проверку как исторические данные. Проверка наиболее полезна, когда ее значение исходного распределения остается понятным от момента получения до использования в CRM.

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

Показывает ли проверка оператора США оператора, обслуживающего перенесенный номер?

CarrierLookup сообщает об исходном распределении диапазона номеров. Номер, сохраненный при смене провайдера, может обслуживаться другим оператором, поэтому помечайте поле в CRM как «исходный оператор».

Можно ли включить любой номер +1 в задачу с файлом для США?

Нет. Код +1 является общим. Используйте доверенные данные об исходной стране, чтобы подготовить список, который преимущественно относится к выбранной группе стран Соединенных Штатов.

Как командам следует обрабатывать пустое поле оператора?

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

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

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

Источники