Аватар WhatsApp по номеру телефона в реальном времени

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

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

Проверка аватара в реальном времени (ws_avatar) отвечает на вопрос напрямую: есть ли этот номер в WhatsApp и какой публичный аватар он показывает прямо сейчас? В этом руководстве описано, как она работает, что возвращает и какие возможности к ней прилагаются.

Как работает проверка аватара в реальном времени

1. Отправьте один номер в международном формате, например +12345678900. Знак + необязателен; см. Рекомендацию МСЭ-T E.164.
2. WA Lookup проверяет регистрацию и аватар в рамках одного запроса.
3. Получите оба ответа в одном отклике — без очереди, без опроса и без обратных вызовов.

Запускайте проверку там, где вам удобно, — проверка и баланс везде одни и те же:

• Демо на главной странице — переключитесь на Проверка аватара; аккаунт не нужен, действует дневной лимит.
• Личный кабинет — откройте Проверка в реальном времени и выберите Проверка аватара WhatsApp. Аватар появится рядом с результатом.
• REST API:

curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifier": "+12345678900" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+12345678900",
    "registered": true,
    "avatar": true,
    "avatar_url": "<image url>"
  }
}

Как читать результат

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

Почему у некоторых зарегистрированных номеров нет аватара

Пользователи WhatsApp сами выбирают, кто может видеть их аватар. Если пользователь открыл его только для своих контактов, скрыл его или вовсе не установил, возвращать нечего, и результат будет avatar: false, даже если аккаунт зарегистрирован. Именно поэтому avatar: false никогда не означает «нет в WhatsApp» — регистрация всегда сообщается отдельно в поле registered.

Возможности, доступные при каждой проверке

Регистрация и аватар в одном запросе

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

Без сохранения контактов и без входа в WhatsApp

Проверки выполняются на собственной инфраструктуре WA Lookup. Вам не нужно сохранять номер в телефон, входить в WhatsApp, сканировать QR-код или устанавливать расширение. Ваш собственный аккаунт WhatsApp не задействуется, поэтому проверка аватаров не создаёт для него рисков.

Владелец номера не получает уведомлений

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

Одинаковый ответ в личном кабинете и в API

Личный кабинет, API и синхронный эндпоинт множественной проверки (POST /api/v1/batch-check) выполняют одну и ту же проверку с единым балансом, поэтому то, что вы видите при тестировании, ваша интеграция получит и в работе.

100 бесплатных проверок при регистрации

Новые аккаунты автоматически получают 100 бесплатных проверок — ничего запрашивать не нужно. Поскольку проверка аватара стоит дороже проверки регистрации в расчёте на один номер, того же бесплатного баланса хватит на меньшее число проверок аватара; актуальные цены указаны на странице цен. Проверка, результат которой определить не удалось, баланс не расходует.

Когда проверка аватара полезна

• Подтверждение нового лида. Аватар, соответствующий компании или человеку из заявки, придаёт отделу продаж больше уверенности перед первым контактом.
• Поддержка и восстановление доступа. Сотрудник поддержки может сравнить аватар клиента в WhatsApp с карточкой клиента, прежде чем обсуждать вопросы по аккаунту.
• Обогащение CRM. Сохранение отметки о наличии публичного аватара — и самого изображения, если это допускает ваша политика, — помогает командам узнавать контакты в своих инструментах.

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

Соблюдайте соразмерность

Во многих юрисдикциях аватар считается персональными данными. Согласно статье 5 GDPR, собирайте только то, что необходимо для вашей цели: используйте проверку регистрации (ws), когда достаточно статуса, храните аватары только в пределах, допустимых вашей политикой хранения, и никогда не используйте проверку аватаров для слежки за частными лицами. Перед любой рассылкой получите явное согласие (opt-in), как того требует Политика обмена сообщениями WhatsApp Business.

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

Нужно ли сохранять номер в контакты, чтобы увидеть аватар?

Нет. Проверке аватара достаточно одного номера телефона.

Почему у номера, зарегистрированного в WhatsApp, нет аватара?

Возможно, у пользователя нет аватара или он открыт только для контактов. В этом случае результат показывает registered: true и avatar: false.

Узнает ли владелец номера, что его аватар проверяли?

Нет. Проверка ничего не отправляет на номер.

Можно ли проверить аватары сразу нескольких номеров?

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

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

Попробуйте проверку аватара без входа в аккаунт или зарегистрируйтесь, чтобы получить 100 бесплатных проверок.

• Открыть страницу «Проверка аватара WhatsApp» →
• Создать бесплатный аккаунт →