Запуск массовой проверки WhatsApp из файла
Узнайте, как выполнить массовую проверку WhatsApp из файла TXT или CSV: подготовьте список, выберите продукт, отследите задачу и скачайте результат.
Пошаговое руководство по асинхронным задачам массовой проверки WhatsApp и их отличиям от проверок в реальном времени.
Массовая проверка WhatsApp из файла — это асинхронная задача: вы загружаете список в формате TXT или CSV, получаете задачу, которую можно отслеживать, ожидаете завершения обработки и скачиваете файл с результатами. Используйте этот метод, если ваш список значительно превышает объем, допустимый для проверки в реальном времени. Для отдельных номеров или небольших групп, требующих мгновенного ответа, используйте проверку в реальном времени.
Когда массовая проверка из файла является подходящим инструментом
Проверки в реальном времени предоставляют ответ в рамках того же запроса, с которым был отправлен номер. Это подходит для форм регистрации, триггеров CRM или небольших списков. Массовая проверка из файла подходит для обратных ситуаций: экспортированных списков, приобретенных или унаследованных баз данных, а также периодической очистки всей таблицы контактов.
Практическое различие заключается в рабочем процессе, а не в сути запроса. При проверке в реальном времени вы получаете результаты немедленно. При массовой проверке вы отправляете задачу один раз, она обрабатывается отдельно, и вы возвращаетесь за результатом позже. Планируйте массовые проверки как фоновые задачи, а не как процесс, ожидаемый пользователем на экране.
Существует четыре продукта для массовой проверки, каждый из которых охватывает один сигнал:
| Продукт для массовой проверки | Сигнал, который он охватывает |
|---|---|
| Проверка регистрации в WhatsApp | Был ли у номера аккаунт WhatsApp на момент проверки |
| Проверка аватара WhatsApp | Доступен ли аватар для этого аккаунта |
| Проверка аккаунта WhatsApp Business | Является ли аккаунт бизнес-аккаунтом |
| Дни активности | Количество дней с момента последней активности |
У каждого продукта есть свои лимиты на файл, поэтому ознакомьтесь с актуальной документацией API перед запуском. Не предполагайте, что лимиты одного продукта применимы к другому.
Подготовка файла перед загрузкой
Большинство неудачных или неэффективных массовых проверок связаны с исходным файлом. Сначала выполните следующие действия:
- Формат. Используйте файл TXT или CSV с одним номером в каждой строке. Форматы электронных таблиц, такие как XLSX, не принимаются, поэтому сохраните их в формате CSV.
- Международный формат. Указывайте каждый номер с кодом страны, без пробелов, скобок или тире. Номера в локальном формате без кода страны не могут быть интерпретированы надежно.
- Одна страна на файл. Список должен соответствовать выбранной вами стране. Файл, содержащий значительную долю номеров из других стран, будет отклонен на этапе предварительной проверки, поэтому сначала разделите смешанные списки по странам.
- Удаление дубликатов. Повторяющиеся строки оплачиваются так же, как и любые другие, поэтому удалите их заранее.
- Проверка региональной поддержки. Задачи массовой проверки из файла не поддерживают номера материкового Китая, Гонконга или Макао. Для этих регионов доступна только ограниченная проверка отдельных номеров в реальном времени.
- Согласие. Убедитесь, что у вас есть законные основания для связи с этими людьми, прежде чем файл будет использован для рассылки.
Отклонение на этапе предварительной проверки — это полезное предупреждение. Оно стоит вам нескольких минут, а не завершенного запуска с плохим файлом.
Отправка задачи и отслеживание статуса
Вы можете отправить массовую задачу из панели управления или через API. Процесс API использует POST /api/v1/bulk-tasks для создания задачи и GET /api/v1/bulk-tasks/{id} для получения ее статуса. Панель управления также отображает ваши массовые задачи и их состояние, что удобно, когда работу выполняет человек, а не скрипт.
Рекомендуемый порядок действий:
- Выберите продукт для массовой проверки, соответствующий нужному вам сигналу.
- Загрузите подготовленный файл и отправьте задачу.
- Сохраните идентификатор задачи, полученный при отправке.
- Опрашивайте статус с умеренным интервалом или проверяйте панель управления, вместо того чтобы перегружать конечную точку запросами. Документация API описывает средства контроля параллелизма и тайм-аутов; ознакомьтесь с ними для соблюдения текущих правил использования.
- Скачайте файл с результатами, когда задача будет завершена.
Баланс резервируется при отправке задачи. После обработки неиспользованная часть резерва возвращается на ваш баланс, а в случае сбоя задачи весь резерв высвобождается. Это является сверкой биллинга, а не программой возврата средств за обычные проверки. Завершенные результаты оплачиваются независимо от того, зарегистрирован номер или нет.
Правильное чтение файла с результатами
Скачиваемый файл с результатами представляет собой CSV-файл с одной строкой на каждый обработанный номер. Рассматривайте каждую строку как сигнал на момент выполнения проверки:
- Результат Зарегистрирован означает, что аккаунт существовал на момент проверки.
- Значения аватара или бизнес-аккаунта дополняют регистрацию. Отсутствие аватара не означает, что номер не зарегистрирован, а флаг бизнес-аккаунта определяет тип аккаунта, а не подтвержденный статус компании.
- Номера, по которым не удалось получить решение, следует повторно проверить в будущем, а не считать их Не зарегистрирован.
Загрузите файл обратно в свою CRM или маркетинговый инструмент, объедините данные по номеру телефона и сохраните дату проверки рядом с результатом. Сегменты станут простыми фильтрами: зарегистрированные номера — в очередь WhatsApp, остальные — в другие каналы.
Сочетание массовой проверки и проверки в реальном времени
Большинство команд используют оба метода. Запустите массовую задачу для очистки существующей базы данных один раз, а затем используйте проверки в реальном времени для каждого нового контакта. Это позволяет поддерживать список в актуальном состоянии без повторения масштабных задач. Оба метода используют один и тот же баланс аккаунта, поэтому одно пополнение покрывает работу панели управления, API и массовых задач. Ознакомьтесь со страницей тарифов для получения информации о текущем плане и балансе.
Часто задаваемые вопросы
Как команды могут отправить массовую проверку WhatsApp?
Загрузите подготовленный файл TXT или CSV из панели управления или создайте задачу через API, затем отслеживайте статус задачи и скачайте файл с результатами после ее завершения.
Почему файл для массовой проверки может быть отклонен при предварительной проверке?
Файл может быть отклонен, если большая часть его номеров принадлежит к другой стране, отличной от выбранной, или если у номеров отсутствуют коды стран. Разделение списка по странам перед загрузкой позволяет избежать этой проблемы.
Что происходит с неиспользованным зарезервированным балансом после массовой задачи?
Баланс резервируется при отправке. Любая неиспользованная часть возвращается на баланс аккаунта после обработки, а в случае сбоя задачи весь резерв высвобождается.
Чем массовая проверка отличается от проверки в реальном времени?
Проверка в реальном времени возвращает ответ в рамках того же запроса. Массовая проверка сначала возвращает задачу, обрабатывает файл отдельно и предоставляет файл с результатами позже.
Узнать больше
Выберите информацию о продукте, которая соответствует следующему шагу в вашем рабочем процессе.