WhatsApp DP Checker для нескольких номеров: выбор между Multi и Bulk

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

WhatsApp DP checker для нескольких номеров анализирует публичное изображение профиля для каждого номера из списка и возвращает результаты единым пакетом. В AvatarLookup предусмотрено два способа. Синхронная проверка (multi check) принимает от 1 до 100 номеров WhatsApp за один API-запрос и возвращает результаты в том же порядке, в то время как панель управления (dashboard) позволяет загрузить до 500 номеров, обрабатывая их последовательно. Для более длинных списков предназначен асинхронный продукт WhatsApp bulk, который принимает файлы TXT или CSV и возвращает один CSV-файл по завершении задачи. В обоих случаях полученный результат означает, что анализ был проведен, а не то, что аккаунт существует.

Что должен делать WhatsApp DP checker для нескольких номеров

Если искать инструменты по этой теме, большинство из них окажутся простыми валидаторами номеров: они лишь сообщают, зарегистрирован ли номер в WhatsApp. Другие представляют собой расширения для браузера, которые управляют WhatsApp Web через ваш личный аккаунт, что вызывает вопросы о безопасности и правах доступа. Лишь немногие объясняют, что делать с самим изображением.

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

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

Выбор способа в зависимости от размера списка

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

Переходите на bulk-продукт, если список настолько велик, что разбиение его на множество синхронных вызовов становится неудобным для планирования и повторных попыток. Массовые задачи имеют свои лимиты на продукт, указанные в документации API; проверяйте текущие значения перед запуском.

Номера из материкового Китая (+86), Гонконга (+852) и Макао (+853) следует проверять через одиночные запросы в реальном времени, а не через bulk-файлы.

Подготовка списка номеров

Чистые входные данные — самый простой способ улучшить результат любой проверки. Перед отправкой:

1. Нормализуйте каждый номер до международного формата с кодом страны, удалив пробелы, скобки, тире и добавочные номера.
2. Удалите дубликаты после нормализации, так как один и тот же номер часто встречается в разных форматах.
3. Сохраните свой ключ записи рядом с каждым номером, чтобы упорядоченные результаты можно было сопоставить без догадок.
4. Разделите по способам: до 100 номеров на один API-запрос multi или один файл для массовой задачи.

К bulk-файлам предъявляются более строгие требования. Используйте TXT или CSV с одним номером в строке, записанным цифрами с кодом страны без знака «плюс» или пробелов. Выберите одну страну для задачи; список должен состоять преимущественно из номеров этой страны. В multipart-запросе поле страны должно идти перед полем файла. Форматы электронных таблиц, такие как XLSX, не принимаются, поэтому сначала сохраните их в CSV.

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

Чтение упорядоченных результатов

API multi check возвращает результаты в том же порядке, что и входные данные, что упрощает сопоставление: первая позиция в ответе соответствует первой позиции в запросе. Сопоставляйте по позиции, а не путем повторного парсинга номеров из ответа.

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

Разделяйте три исхода в своей модели данных:

• Аватар проанализирован: публичное изображение найдено и описано.
• Нет публичного аватара: проверка завершена, публичное изображение недоступно. Это завершенный результат, который подлежит оплате.
• Нет результата: неверный ввод, не определено или сбой. Проверьте входные данные и решите, стоит ли пробовать позже.

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

Пошаговое выполнение массовой проверки (bulk)

Продукт WhatsApp bulk является асинхронным, поэтому рабочий процесс состоит из четырех этапов:

1. Отправка: передайте подготовленный файл и код страны в POST /api/v1/bulk-tasks. В ответе вы получите задачу, которую можно опрашивать.
2. Опрос: используйте GET /api/v1/bulk-tasks/{id} не чаще, чем раз в 30 секунд. Для больших файлов допустим более редкий интервал; фиксированное время завершения не гарантируется.
3. Загрузка: скачайте CSV-файл, когда задача будет выполнена. Ссылки на скачивание действуют 12 часов; если срок истек, запросите ту же задачу снова для получения новой ссылки.
4. Загрузка и сверка: сопоставьте CSV со своим исходным списком, записывая дату анализа в каждой строке.

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

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

Как командам обработать список из 5 000 номеров с помощью multi check?

Разделите список на запросы до 100 номеров, отправляйте их последовательно или с умеренной параллельностью и сопоставляйте каждый упорядоченный ответ по позиции. Сохраняйте ссылку на запрос и временную метку для каждого фрагмента, чтобы неудачные фрагменты можно было отправить повторно. Если объем работы растет или становится регулярным, перейдите на продукт WhatsApp bulk, который обрабатывает один файл и возвращает один CSV.

Как часто нужно повторно проверять аватар WhatsApp?

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

Можно ли включать адреса электронной почты в один multi-запрос?

Нет. Каждый API-запрос multi поддерживает только один тип сервиса. Поддерживаемые адреса Gmail, Yandex и Mail.ru используют маршрут анализа аватаров email, поэтому сначала разделите смешанные списки по типу идентификатора и отправляйте номера WhatsApp и адреса электронной почты отдельными запросами. То же разделение применяется к bulk-файлам, где каждая задача относится к одному конкретному bulk-продукту.

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

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

• Посетить сайт продукта →