Как WA Lookup проверяет номер WhatsApp

Выполнение одной проверки

Этот раздел посвящён проверкам в реальном времени: панель SaaS и синхронные эндпоинты REST используют один сервис проверки и одинаковое значение ответа. Для очень больших списков есть асинхронный массовый вариант — он описан в конце страницы.

1. 1

   Отправьте номер

   Отправьте номер, который нужно проверить, в формате, указанном в документации API.

2. 2

   Выберите продукт

   ws — для регистрации, ws_avatar добавляет поля аватара, ws_business добавляет поля аккаунта Business. Для дней активности есть соответствующий продукт асинхронной массовой проверки.

3. 3

   Прочитайте результат

   Прочитайте registered в том же ответе. Запустите новую проверку, когда понадобится обновлённый статус.

В каком формате отправлять номер

WA Lookup принимает один номер на проверку в формате E.164: знак плюс, код страны, затем номер абонента без пробелов и знаков препинания — например, +17253100591. В этом же формате номера хранит само приложение WhatsApp, поэтому номер в таком виде соответствует ровно одному аккаунту. Номер без кода страны надёжно проверить нельзя: одни и те же цифры существуют во многих странах.

• Всегда указывайте код страны; не рассчитывайте на страну вашего аккаунта.
• Удаляйте пробелы, дефисы, скобки и ведущие нули, используемые при внутреннем наборе, — оставляйте только + и цифры.
• Номера в неверном формате отклоняются до списания; отклонённый формат — это не результат «не зарегистрирован».

Что означает registered?

registered — это ответ проверки WhatsApp. Он присутствует только в успешном ответе и имеет логический тип: true означает, что номер зарегистрирован в WhatsApp на момент запроса, false — что нет. Всё остальное — тайм-аут, неопределённый результат, недопустимый номер — возвращается как код ошибки, и WA Lookup автоматически возвращает средства за такую проверку. Поэтому отсутствие поля registered никогда не означает «не зарегистрирован»; это значит, что проверка не дала результата. Значение отражает момент запроса: аккаунты постоянно создаются и удаляются, поэтому повторяйте проверку перед тем, как действовать на основе старого результата, а не кешируйте его на недели.

• registered=true означает «зарегистрирован».
• registered=false означает «не зарегистрирован».
• Другие исходы обрабатывайте по коду ответа API; не выводите значение registered самостоятельно.

Выбирайте продукт по задаче

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

• ws возвращает статус регистрации.
• ws_avatar дополнительно возвращает поля аватара; avatar_url — пустая строка, если аватар недоступен.
• ws_business дополнительно возвращает поля аккаунта Business.

Используйте результат в пределах его назначения

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

• Проверка не подтверждает, кому принадлежит номер, находится ли владелец в сети прямо сейчас, и не раскрывает содержимое сообщений; массовый продукт активности возвращает количество дней с последней активности, а не текущее присутствие.
• Статус «зарегистрирован» не означает согласия на контакт с этим номером.
• Запускайте новую проверку, когда для бизнес-решения нужен актуальный статус.

Очень большие списки: асинхронный вариант

Множественная проверка в панели и эндпоинт множественной проверки API подходят для большинства списков. Только если список намного превышает эти лимиты, имеет смысл отправить весь файл как одну асинхронную массовую задачу — вы выбираете страну, к которой относится список, и он должен в основном состоять из номеров этой страны.

• Загрузите файл .txt или .csv с одним номером E.164 на строку — на странице массовой проверки или через API.
• При отправке выберите страну, к которой относятся номера; список должен в основном состоять из номеров этой страны. Если номеров из других стран слишком много, задача завершится ошибкой при подготовке файла — она не будет отправлена на проверку, и сумма вернётся полностью.
• При отправке баланс резервируется за допустимые строки, списание идёт только за номера, по которым получен результат, а разница возвращается.
• Задача выполняется в фоне; скачайте файл с результатом после завершения. За неудавшуюся задачу сумма возвращается полностью.