API поиска по номеру vs Проверка WhatsApp: что возвращает каждый из них

Сравнение универсальных API для поиска по номеру телефона и проверок регистрации в WhatsApp с рекомендациями о том, когда в рабочем процессе очистки списков требуется один, другой или оба инструмента.

API поиска по номеру и проверка WhatsApp отвечают на разные вопросы об одном и том же номере телефона. API поиска по номеру описывает состояние номера в телефонной сети: как правило, его формат, страну, оператора и тип линии (мобильная, стационарная или VoIP). Проверка регистрации в WhatsApp описывает одну конкретную платформу: был ли аккаунт WhatsApp привязан к этому номеру на момент проверки. Командам, которые отправляют SMS или совершают звонки, необходим поиск по номеру; командам, решающим, стоит ли использовать WhatsApp, нужна проверка регистрации; рабочие процессы очистки списков, предусматривающие маршрутизацию по нескольким каналам, обычно выполняют обе проверки в указанном порядке.

API поиска по номеру vs Проверка WhatsApp: краткий обзор

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

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

Что возвращает API поиска по номеру

«Поиск по номеру» охватывает несколько уровней, и поставщики услуг компонуют их по-разному:

1. Валидация формата и плана нумерации. Парсер, такой как libphonenumber, проверяет, имеют ли номер и префикс допустимую для региона длину, и преобразует их в формат E.164. Это выполняется локально и не требует запроса к сети.
2. Оператор и тип линии. Сетевой поиск возвращает текущего оператора и тип линии. Например, Line Type Intelligence от Twilio возвращает название оператора, коды страны и сети, а также тип: мобильный, стационарный, фиксированный VoIP, нефиксированный VoIP или бесплатный номер.
3. Дополнительные данные о рисках или переносе номера. Некоторые провайдеры добавляют историю переноса номера, данные о замене SIM-карты или переназначении номера в качестве отдельных продуктов.

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

Что возвращает проверка регистрации в WhatsApp

Проверка WhatsApp напрямую задает вопрос конкретной платформе. В WA Lookup проверка в реальном времени принимает один номер в формате E.164 и возвращает результат в том же ответе; значение service_type определяет, какой именно сигнал вы получите.

ws: регистрация

Был ли аккаунт WhatsApp зарегистрирован на номере на момент проверки. Это основной сигнал доступности для выбора канала.

ws_avatar: регистрация плюс доступность аватара

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

ws_business: регистрация плюс тип бизнес-аккаунта

Добавляет информацию о том, является ли аккаунт аккаунтом WhatsApp Business. Это описывает тип аккаунта, а не подтвержденную юридическую компанию.

Проверка доступна в виде API-запроса для одного номера, синхронного мультизапроса до 100 номеров, через панель управления и через сервер MCP для AI-клиентов. Проверка, результат которой не удалось определить, возвращает ненулевой бизнес-код; ее следует повторить, а не сохранять как Не зарегистрирован.

Когда использовать API поиска по номеру, проверку WhatsApp или оба инструмента

Сопоставьте инструмент с решением, которое принимает ваш рабочий процесс:

Две модели поведения приводят к наибольшим неоправданным расходам. Первая — выполнение поиска оператора для контактов, которым сообщения будут отправляться только в WhatsApp, где тип линии не влияет на решение. Вторая — использование типа линии в качестве косвенного признака WhatsApp: мобильный номер может как иметь, так и не иметь аккаунта, а номер, указанный как VoIP или стационарный, все равно может быть зарегистрирован в WhatsApp, поэтому проверка регистрации является единственным прямым ответом.

Рабочий процесс очистки списков, объединяющий оба метода

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

1. Нормализация и валидация формата в автономном режиме. Преобразуйте каждый номер в E.164 с помощью библиотеки планов нумерации и удалите дубликаты. Номера, не прошедшие парсинг, отправляются на проверку; они не стоят платного запроса.
2. Выполните проверку регистрации в WhatsApp для оставшихся номеров. Используйте проверки в реальном времени для небольших наборов, до 100 номеров на синхронный API-запрос для импорта или вставку в Realtime Batch Check в панели управления. Для очень больших файлов асинхронные пакетные задачи принимают загрузку TXT или CSV и возвращают файл с результатами для скачивания, с учетом лимитов по продуктам, указанных в документации.
3. Выполняйте поиск оператора и типа линии только там, где планируется канал SMS или голосовой связи, например, для контактов, которые не зарегистрированы в WhatsApp, но получат SMS в качестве резервного варианта.
4. Сохраняйте каждый результат в отдельном поле с указанием источника и даты проверки: тип линии и оператор из поиска по номеру, регистрация и опциональные сигналы аватара или бизнес-аккаунта из проверки WhatsApp.
5. Держите неопределенные результаты отдельно и повторяйте их, вместо того чтобы объединять с любой из групп.

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

Оценка провайдеров для каждого шага

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

Для API поиска по номеру: какие пакеты данных являются отдельными продуктами, как определяются типы линий, в каких странах есть покрытие операторов и существуют ли пакетные запросы или каждый номер — это отдельный запрос.

Для проверки WhatsApp: приходят ли результаты в том же ответе или через рабочий процесс задач, как сообщается о неопределенных проверках, оплачиваются ли как зарегистрированные, так и незарегистрированные ответы, какие регионы поддерживаются для каких путей и зависит ли сервис от вашей собственной сессии WhatsApp. WA Lookup, например, поддерживает номера материкового Китая, Гонконга и Макао в небольших объемах проверок в реальном времени, в то время как его пакетные файловые задачи не принимают эти регионы.

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

FAQ

Как команды могут узнать, есть ли у номера WhatsApp, с помощью поиска по номеру?

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

Когда команде нужны и API поиска по номеру, и проверка WhatsApp?

Когда контакты маршрутизируются по разным каналам, например, сначала WhatsApp, а затем SMS в качестве резервного варианта. Проверка WhatsApp информирует первый канал, а поиск типа линии — резервный.

Как следует хранить оба результата в CRM?

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

Какой шаг должен выполняться первым в рабочем процессе очистки списка?

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

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

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

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