Как проверить номера телефонов из CSV в реальном времени

Узнайте, как подготовить CSV с номерами телефонов в формате E.164 и прогнать их через одиночный и множественный эндпоинты WA Lookup для проверки в реальном времени, чтобы сразу получить сигналы наличия аккаунта.

WA Lookup проверяет наличие аккаунта WhatsApp в реальном времени: отправьте один номер в формате E.164 на POST /api/v1/check или до 100 номеров на синхронный множественный эндпоинт POST /api/v1/batch-check, и готовый результат вернется в том же HTTP-ответе. CSV — это просто источник данных для таких запросов: стандартизируйте столбец, выберите тип сервиса и отправляйте идентификаторы через множественный эндпоинт по 100 за раз. Целый файл, намного превышающий один запрос в реальном времени, также можно загрузить как асинхронное задание массовой проверки.

Подготовка данных к проверке

Прежде чем отправлять запросы к API, файл CSV нужно правильно отформатировать. WA Lookup требует, чтобы все отправляемые номера телефонов были в формате E.164. Этот международный план нумерации телефонной связи обеспечивает уникальность и однозначность каждого номера: как правило, номер начинается со знака плюс, за которым следуют код страны и абонентский номер. Приведение столбца CSV к этому формату сокращает количество ошибок при вызове API и обеспечивает точную обработку входных данных процесса.

Выбор подходящего типа проверки WhatsApp

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

Параметр service_type определяет, какие поля возвращаются и какая стоимость списывается с баланса.

Выполнение процесса проверки

Для CSV используйте синхронный множественный эндпоинт POST /api/v1/batch-check — до 100 отформатированных идентификаторов за раз; для одного идентификатора используйте POST /api/v1/check. Оба возвращают результаты в ответе на исходный HTTP-запрос, без отправки заданий, опроса или этапа скачивания. Для завершенной проверки WhatsApp возвращаемый объект data содержит service_type, identifier и registered; ws_avatar дополнительно включает avatar и avatar_url, а ws_business — business. Внутренние поля записи, транзакции, статуса и биллинга не возвращаются.

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

В панели WA Lookup команды могут управлять ключами API, просматривать историю проверок и отслеживать баланс и использование на уровне продуктов. Сам множественный запрос выполняется синхронно через API, а панель дает обзор аккаунта и использования. Новые аккаунты также могут обратиться в поддержку за 100 бесплатными проверками, чтобы протестировать проверку регистрации, аватара и бизнес-аккаунта перед обработкой больших файлов CSV.

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

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

Тип сервиса ws возвращает стандартный статус регистрации на платформе. Тип ws_avatar добавляет наличие аватара и поле URL аватара, которое остается пустым, если URL недоступен. Тип ws_business проверяет регистрацию и определяет, связан ли номер с аккаунтом WhatsApp Business.

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

Да. Синхронный множественный эндпоинт POST /api/v1/batch-check принимает до 100 идентификаторов и возвращает готовые результаты в том же HTTP-ответе, без отправки заданий, опроса или этапа скачивания. Для целого списка, намного превышающего этот объем, также доступно асинхронное задание массовой проверки (при отправке вы выбираете страну, к которой относятся номера, и список должен по существу состоять из номеров этой одной страны), но синхронные эндпоинты остаются основным способом проверки.

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

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