Сопоставление WhatsApp LID с номерами телефонов: руководство по целостности данных CRM

Узнайте, как использовать API WA Lookup для сопоставления WhatsApp LID с номерами телефонов. Синхронно проверяйте регистрацию, наличие аватара и признаки бизнес-аккаунта, чтобы поддерживать целостность данных CRM.

Чтобы проверять регистрацию в WhatsApp и поддерживать процессы сопоставления WhatsApp LID с номерами телефонов, используйте REST API WA Lookup. Отправив номер телефона в формате E.164 на эндпоинт POST /api/v1/check с указанным service_type (ws, ws_avatar или ws_business), вы получите синхронный JSON-ответ, подтверждающий сигнал наличия аккаунта. Этот процесс помогает командам поддерживать чистоту контактных данных и сегментировать CRM в реальном времени.

Почему проверка WhatsApp важна для данных CRM

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

Продукты проверки WA Lookup

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

WhatsApp Checker (тип ws)

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

WhatsApp Avatar Checker (тип ws_avatar)

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

WhatsApp Business Checker (тип ws_business)

Эта проверка подтверждает регистрацию и определяет, использует ли аккаунт WhatsApp Business, возвращая булево поле business. Это помогает командам отделять B2B-контакты от обычных потребительских аккаунтов на этапе загрузки данных.

Интеграция с API WA Lookup

Для интеграции API WA Lookup в CRM или конвейер данных достаточно простого HTTP-запроса. Платформа использует синхронную архитектуру API: результат возвращается в том же HTTP-ответе, что и исходный запрос, а не доставляется асинхронно. Чтобы выполнить проверку, отправьте запрос на эндпоинт POST /api/v1/check. Запрос должен содержать заголовок X-API-Key для аутентификации и заголовок Content-Type: application/json. JSON-тело требует двух полей:

• service_type: укажите ws, ws_avatar или ws_business.
• identifier: передаваемый номер телефона, отформатированный по международному плану нумерации E.164.

Формат E.164 стандартизирует номера телефонов для международного набора и обычно включает знак плюс (+), за которым следуют код страны, код региона и местный абонентский номер. Передача номеров строго в формате E.164 обязательна для точной обработки запроса API WA Lookup. Для завершённой проверки WhatsApp возвращаемый data содержит service_type, identifier и registered; ws_avatar дополнительно включает avatar и avatar_url, а ws_business — business. Внутренние поля записи, транзакции, статуса и биллинга не возвращаются.

Маршрутизация записей на основе сигналов наличия аккаунта

Когда синхронный API вернул сигнал наличия аккаунта, команды по работе с данными могут использовать JSON-ответ для последующей маршрутизации. Например, когда CRM загружает новый список лидов, система может автоматически обращаться к эндпоинту POST /api/v1/check. Номера с положительным статусом registered можно помечать для определённых кампаний, а незарегистрированные — направлять в альтернативные каналы коммуникации. При использовании типа сервиса ws_business процесс может ветвиться дальше. Выявление аккаунта WhatsApp Business помогает командам отделять B2B-контакты от обычных потребительских аккаунтов и выстраивать более адресные стратегии коммуникации. Аналогично проверка ws_avatar может дополнить визуальный контекст профиля CRM, добавив avatar_url в контактную запись. Встраивая эти проверки прямо в этап загрузки данных, организации сокращают время ручной проверки и поддерживают более высокий уровень чистоты данных на своих платформах.

Управление расходами и отчётность в панели

За неудачные, превысившие тайм-аут и неопределённые проверки плата не удерживается. Актуальные сведения об оплате смотрите на странице цен. Новые аккаунты могут обратиться в поддержку и получить 100 бесплатных проверок, чтобы протестировать проверки регистрации, аватара и бизнес-аккаунта перед масштабированием своих процессов. Панель WA Lookup предоставляет полный набор инструментов для управления интеграцией. Администраторы могут использовать панель для управления ключами API и отслеживания доступного баланса. Интерфейс также поддерживает подробную историю проверок, отчётность по продуктам и просмотр недавних проверок. Чтобы помочь командам отслеживать использование во времени, панель показывает расход баланса и активность аккаунта. Отчётность по продуктам позволяет операционным командам разделять использование проверок ws, ws_avatar и ws_business, обеспечивая прозрачность потребления API и работ по обогащению данных CRM.

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

Чем отличаются ws, ws_avatar и ws_business?

Все три используют один и тот же синхронный эндпоинт, но возвращают разные поля в зависимости от service_type. Проверка ws возвращает статус регистрации. Проверка ws_avatar добавляет наличие аватара и поле URL аватара, которое пустое, если URL недоступен. Проверка ws_business добавляет булево значение, указывающее, использует ли аккаунт WhatsApp Business.

Проверяет ли WA Lookup, находится ли пользователь сейчас в сети?

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

Как неудачные запросы к API учитываются при оплате?

За неудачные, превысившие тайм-аут и неопределённые проверки плата не удерживается. Актуальные сведения об оплате смотрите на странице цен.