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

Узнайте, как интегрировать API поиска WhatsApp в реальном времени, чтобы синхронно проверять наличие аккаунта, сокращать задержки и упрощать процессы обогащения B2B-лидов в продажах.
Интеграция API поиска WhatsApp в реальном времени позволяет B2B-воронкам продаж синхронно проверять данные лидов в процессе их поступления. С помощью RESTful POST-запроса разработчики могут мгновенно подтвердить наличие аккаунта WhatsApp, наличие аватара или статус бизнес-аккаунта в рамках одной HTTP-транзакции. Это устраняет задержки, связанные с асинхронными вебхуками, и гарантирует, что команды по операциям продаж получают обогащенные, готовые к работе данные о лидах сразу при их поступлении, что ускоряет процессы квалификации.
Роль синхронных запросов в автоматизации продаж
В автоматизации B2B-продаж скорость обогащения и маршрутизации лида может существенно влиять на эффективность процессов. Традиционные асинхронные методы получения данных часто опираются на вебхуки или механизмы опроса. Такие архитектуры требуют, чтобы система отправила запрос, дождалась завершения фонового процесса, а затем ожидала обратного вызова. Этот многоэтапный процесс вносит задержку в конвейер приема лидов, откладывая последующие этапы маршрутизации и квалификации. API поиска WhatsApp в реальном времени решает эту проблему благодаря синхронной архитектуре. Когда система отправляет запрос, API обрабатывает его и возвращает сигнал наличия аккаунта в том же самом HTTP-ответе. Такое немедленное получение данных позволяет разработчикам встраивать проверку непосредственно в отправку форм, скрипты загрузки данных в CRM или правила маршрутизации при квалификации лидов, не создавая сложную логику управления состоянием. Сокращая задержки, синхронная обработка помогает командам по операциям продаж расставлять приоритеты записей по статусу регистрации на платформе в тот момент, когда лид попадает в базу данных.
Техническая реализация: POST /api/v1/check
Интеграция синхронного API требует простого RESTful-подхода. Разработчики работают с единственным эндпоинтом для проверки наличия аккаунта, что снижает технические затраты на обогащение лидов.
Задокументированный контракт запроса использует метод POST, направленный на /api/v1/check. Для аутентификации запроса системы должны передавать заголовок X-API-Key вместе с заголовком Content-Type: application/json.
JSON-тело требует два поля: service_type и identifier. identifier должен передаваться строго в формате E.164. E.164 — это стандарт международного плана нумерации телефонной связи: номер телефона должен начинаться со знака плюс (+), за которым сразу следуют код страны и абонентский номер, без пробелов, дефисов и специальных символов. Если входные данные не оформлены как номер E.164, запрос завершится неудачей.
Пример требуемой структуры тела запроса: {"service_type": "ws_business", "identifier": "+17253100591"}
Поскольку API синхронный, HTTP-транзакция остается открытой до завершения проверки, после чего сразу возвращаются запрошенные данные в соответствии с выбранным типом сервиса.
Выбор подходящего типа сервиса для обогащения
Все проверки WhatsApp используют один и тот же синхронный эндпоинт. Параметр service_type в теле запроса определяет, какие именно поля данных возвращаются, и задает стоимость запроса, списываемую с баланса. Разработчики могут выбрать один из трех типов сервиса, чтобы адаптировать получение данных к своим задачам B2B-обогащения:
- ws (WhatsApp Checker): стандартная проверка. Возвращает только поле
registered, дающее базовый сигнал наличия аккаунта, чтобы подтвердить, зарегистрирован ли указанный номер телефона на платформе WhatsApp. - ws_avatar (WhatsApp Avatar Checker): этот тип сервиса включает базовую проверку регистрации и добавляет данные для обогащения профиля. Возвращает логическое значение
avatar, показывающее наличие аватара, и строкуavatar_url. Если URL недоступен, поле остается пустым. - ws_business (WhatsApp Business Checker): предназначен для B2B-сегментации; эта проверка подтверждает стандартную регистрацию и добавляет логическое значение
business. Этот сигнал помогает командам определить, использует ли аккаунт WhatsApp Business, что может влиять на процессы планирования работы с контактами или поддержки.
Интерпретация сигнала наличия аккаунта
Для завершенной проверки WhatsApp возвращаемый объект data содержит service_type, identifier и registered; ws_avatar дополнительно включает avatar и avatar_url, а ws_business — business. Внутренние поля записи, транзакции, статуса и биллинга не возвращаются.
Руководителям операций продаж крайне важно понимать границы этих данных. Положительный результат registered отражает поля статуса WhatsApp, доступные в момент проверки. Он служит исключительно сигналом наличия аккаунта.
API не проверяет и не возвращает статус пользователя в сети, отметку «был(а) в сети» или какую-либо историю сообщений. Сигнал лишь помогает принимать внутренние решения, подтверждая, что аккаунт существует на платформе, и позволяя командам соответствующим образом сегментировать списки лидов.
Качество данных и экономическая эффективность
Баланс и историю проверок смотрите в панели; актуальные правила биллинга приведены на странице цен и в документации API. Для новых аккаунтов, тестирующих интеграцию, доступно 100 бесплатных проверок, чтобы оценить проверку регистрации, аватара и аккаунта Business перед переходом к большим объемам.
Часто задаваемые вопросы
Чем отличаются типы сервиса ws, ws_avatar и ws_business?
Все три типа сервиса используют один и тот же синхронный эндпоинт, но возвращают разные поля данных. Тип 'ws' возвращает базовый сигнал регистрации. Тип 'ws_avatar' добавляет логическое значение наличия аватара и поле URL аватара, которое остается пустым, если URL недоступен. Тип 'ws_business' подтверждает регистрацию и добавляет логическое значение, показывающее, использует ли аккаунт WhatsApp Business.
Проверяет ли API, находится ли пользователь сейчас в сети или доступен для общения?
Нет. Результат registered лишь отражает поля статуса WhatsApp, доступные на момент проверки, чтобы подтвердить наличие аккаунта. Он не проверяет и не возвращает статус в сети, отметки «был(а) в сети», историю сообщений или согласие на контакт.
Как в биллинге учитываются неудачные запросы к API?
За неудачные, прерванные по тайм-ауту и неопределенные проверки плата не удерживается. Актуальные условия биллинга приведены на странице цен.
В каком формате должны быть номера телефонов в запросе к API?
Все отправляемые номера телефонов должны быть оформлены по стандарту E.164. Это означает знак плюс (+), за которым сразу следуют код страны и абонентский номер, без пробелов и специальных символов.