Как выполнить массовую проверку доставляемости email для подготовленного списка

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

Массовая проверка email с помощью EmailCheckPro — это асинхронная задача. Подготовьте простой файл TXT или CSV, указав по одному полному адресу в каждой строке, отправьте его как массовую задачу, опрашивайте статус задачи до её завершения и загрузите один CSV-файл с результатами. Каждый адрес помечается как Доставляемый (мог получать почту на момент проверки) или Недоставляемый. Адреса, по которым не удалось получить результат, например, домены с настройкой Catch-All, остаются в статусе Не определено и обрабатываются отдельно. Проверка не отправляет никаких сообщений на адреса из списка.

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

Большинство неудачных или неэффективных запусков связаны с файлом, а не с самой проверкой. Перед отправкой выполните следующие действия:

• Используйте только TXT или CSV. По одному полному адресу в строке, включая локальную часть, символ @ и домен. Форматы электронных таблиц, такие как XLSX, не поддерживаются, поэтому сначала сохраните файл в формате CSV.
• Удалите лишние пробелы и исправьте очевидные опечатки. Лишний пробел или отсутствие домена делают строку непригодной для проверки.
• Удалите дубликаты, где это возможно. Некорректные и повторяющиеся строки удаляются в процессе подготовки, но самостоятельная очистка поможет вам получить ожидаемое количество записей.
• Один продукт на один файл. Файл для проверки доставляемости и файл для проверки аватара — это разные задачи. Проверка аватара email поддерживает только адреса Gmail, Yandex и Mail.ru, поэтому смешанный список следует использовать в задаче по проверке доставляемости.
• Соблюдайте ограничения для каждого продукта. Размер файла и количество адресов различаются в зависимости от продукта; актуальные ограничения указаны в документации API.

Сохраните исходный файл без изменений. Позже вы сможете объединить результаты с ним.

Запуск задачи и отслеживание статуса

Массовые задачи отправляются с помощью POST /api/v1/bulk-tasks с загрузкой подготовленного файла. Этот вызов не возвращает результаты сразу; он создает задачу, которая выполняется в фоновом режиме. В этом заключается ключевое отличие от проверки в реальном времени: одиночная проверка и синхронная проверка нескольких адресов возвращают ответ в том же запросе, тогда как массовая задача требует последующего обращения к системе.

Проверяйте прогресс с помощью GET /api/v1/bulk-tasks/{id}. Опрашивайте статус не чаще, чем раз в 30 секунд; более частые запросы не ускорят выполнение задачи. Когда статус сообщает об успехе, ответ будет содержать ссылку для скачивания одного CSV-файла. Эта ссылка остается действительной в течение 12 часов, и повторный запрос к той же задаче обновляет её, поэтому пропущенное время не означает потерю результата.

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

Чтение CSV-файла с результатами

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

Распределите строки на три группы:

Отсутствующая или неопределенная строка не является вердиктом Недоставляемый. Оплачиваются только завершенные результаты, поэтому строки со статусом Не определено не тарифицируются.

Использование результатов

Объедините CSV-файл с результатами с вашим исходным списком по столбцу с адресом, а затем запишите вердикт в поле вашей CRM или инструмента для рассылки, вместо того чтобы удалять строки. Это сохранит историю проверок и позволит повторно проверять только те записи, которые изменились.

Две привычки помогут вам в работе. Во-первых, проводите проверку непосредственно перед отправкой или импортом, так как результат описывает состояние адреса на момент проверки и ничего не говорит о его будущем статусе. Это лишь один из элементов гигиены списка наряду с вашими собственными записями об исключении и согласии.

Для небольших объемов, например, при появлении нескольких сотен новых регистраций, синхронный вызов для проверки от 1 до 100 адресов будет проще, чем создание новой массовой задачи.

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

Как команды могут узнать, что массовая задача завершена?

Опрашивайте конечную точку статуса задачи с интервалом 30 секунд или более. Когда статус сообщает об успехе, ответ включает ссылку на CSV-файл с результатами. Ссылка действует 12 часов и может быть обновлена путем повторного запроса к той же задаче, поэтому нет необходимости скачивать файл немедленно.

Что происходит со строками, которые не являются корректными адресами?

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

Можно ли запустить массовую задачу из AI-клиента через MCP?

Инструмент для массовых файловых задач не задокументирован для конечной точки MCP. MCP поддерживает одиночные проверки, до 100 адресов за вызов, перечисление продуктов и запросы баланса. Для массовых файловых задач используйте веб-интерфейс или REST API.

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

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

• Просмотреть документацию по продукту →
• Связаться с командой →