Як прогрівати акаунти через Snov.io API

У цьому гайді ви дізнаєтеся, як прогрівати акаунти відправників у Snov.io за допомогою API прогріву email.

Використовуйте API прогріву email для автоматизації мастабного прогріву відправників. Створюйте кампанії прогріву та керуйте ними, відстежуйте прогрес доставлюваності та підтримуйте постійний прогрів акаунтів відправників як частину вашого процесу аутрічу через API-запити.

API Snov.io доступний на всіх планах сейлз-пакету.

Методи API прогріву email

Створити кампанію прогріву
Отримати список кампаній прогріву
Отримати інформацію про кампанію прогріву
Оновити кампанію прогріву
Отримати статистику прогріву
Видалити кампанію прогріву

Що можна робити за допомогою API прогріву email:

1) Підключати акаунти та запускати прогрів масово через API-запити

2) Вибирати стратегію відправлення залежно від етапу аутрічу — прогресивну для підготовки акаунтів або стабільну для підтримки репутації

3) Прогрівати акаунти Gmail, Microsoft або інших SMTP-провайдерів

4) Контролювати ліміти відправлення та налаштування на кожному етапі прогріву

5) Отримувати статистику для відстеження прогресу акаунтів

Перш ніж розпочати

Для використання API прогріву email потрібні дві речі: підключений email-акаунт і облікові дані API для автентифікації.

Email-акаунт

До вашого робочого простору має бути підключений щонайменше один акаунт відправника — через застосунок або через API-метод «Додати email-акаунт».

Автентифікація

Усі API-запити Snov.io потребують токена доступу. Щоб отримати його:

Знайдіть обидва облікові дані в налаштуваннях акаунту на вкладці API
Використайте метод автентифікації з вашим ID користувача API та Ключ API
Включайте токен у заголовок автентифікцаії кожного запиту

Токен доступу дійсний 1 годину (3600 секунд).

Методи API за етапами робочого процесу:

Створити кампанію прогріву

Прогрійте акаунт відправника перед використанням в аутрічі. Цей метод запускає нову кампанію прогріву з вказаними вами налаштуваннями.

POST https://api.snov.io/v2/warmup

Обов'язкові параметри:

Обов'язкові параметри налаштовують основи прогріву — який акаунт прогрівати і скільки імейлів надсилати на день.

email_account_id — email-акаунт, який потрібно прогріти
per_day — кількість імейлів прогріву на день. Можна встановити від 1 до 1000 на день залежно від вашого плану. Перегляньте ліміти прогріву тут.

Додаткові параметри:

Додаткові параметри дозволяють точніше налаштувати стратегію прогріву, контент листів та вибрати конкретних провайдерів

Також можна покращити результати за допомогою розширених опцій: преміум-пул відправників (лише бізнес-домени), кастомні трекінгові домени та динамічний проксі.

strategy — швидкість нарощування відправлення: progressive (за замовчуванням) поступово збільшує денний обсяг, steady тримає його фіксованим впродовж усього прогріву
from — початковий денний обсяг при progressive стратегії. Виберіть від 1 до 5; значення не має перевищувати per_day ціль
increase — щоденне збільшення обсягу при progressive стратегії. Виберіть від 1 до 5
email_content — контент для відправлення під час прогріву: autogenerated (за замовчуванням) — Snov.io генерує його за допомогою ШІ, specific — ви надаєте власний шаблон
subject — кастомна тема імейлу (1–200 символів). Потрібна якщо email_content встановлено як specific
body — кастомна основна частину імейлу (1–10 000 символів). Потрібне якщо email_content встановлено як specific
reply_rate — відсоток вхідних імейлів прогріву, на які надходить відповідь. Виберіть від 10 до 45. За замовчуванням 30
campaign_deadline — дата завершення прогріву (YYYY-MM-DD). Пропустіть, якщо дедлайн не потрібен
providers — провайдери, проти яких прогріваєтесь. Варіанти: gmail, microsoft або other
send_to_paid_domain — чи надсилати імейли прогріву також на платні домени. За замовчуванням false
enable_ctd — увімкнути кастомний трекінговий домен для цього прогріву. За замовчуванням false
enable_proxy — увімкнути динамічний проксі для цього прогріву. За замовчуванням false
schedule_id — розклад відправлення для цього прогріву
template_name — назва збереженого шаблону імейлу для використання

Отримати список кампаній прогріву

Отримайте огляд усіх кампаній прогріву по всіх акаунтах відправників із можливістю фільтрації за статусом або пагінації.

GET https://api.snov.io/v2/warm-up

Обов'язкові параметри:

Відсутні — без додаткових параметрів повертаються всі ваші кампанії прогріву.

Додаткові параметри:

Додаткові параметри дозволяють фільтрувати за статусом кампанії та контролювати пагінацію — звужувати результати до активних, призупинених, завершених або помилкових кампаній і вибирати кількість результатів на сторінці.

page — яку сторінку результатів показати. Починається з 1 (за замовчуванням)
per_page — кількість результатів на сторінці. Виберіть 20, 50 або 100. За замовчуванням 20
status — звузити результати до конкретного статусу: active, paused, completed або error. Пропустіть, щоб отримати всі кампанії прогріву

Отримати інформацію про кампанію прогріву

Перегляньте поточну конфігурацію та статус кампанії прогріву.

Цей метод повертає повні деталі кампанії — включно з налаштуваннями стратегії, денними лімітами, поточною статистикою доставлюваності та підключеним email-акаунтом — щоб ви могли відстежувати прогрес і перевіряти налаштування перед внесенням змін.

GET https://api.snov.io/v2/warm-up/{id}

Обов'язкові параметри:

id — кампанія прогріву, яку потрібно переглянути. Отримайте значення з відповіді методу «Отримати список кампаній прогріву».

Оновити кампанію прогріву

Змінюйте стратегію прогріву, денні ліміти, статус або налаштування контенту без перезапуску кампанії.

Цей метод частково оновлює наявну кампанію прогріву — змінюються лише передані поля; всі інші налаштування залишаються без змін.

PATCH https://api.snov.io/v2/warm-up/{id}

Обов'язкові параметри:

id — кампанія прогріву, яку потрібно переглянути. Отримайте значення з відповіді методу «Отримати список кампаній прогріву»

Додаткові параметри:

make_endless: true — прибрати дедлайн кампанії, щоб прогрів тривав безстроково. Це перевизначає будь-який раніше встановлений дедлайн.

Усі інші додаткові параметри працюють так само, як у методі «Створити кампанію прогріву», — ви можете змінити будь-яку частину конфігурації прогріву.

Повний список параметрів — у розділі «Створити кампанію прогріву».

Отримати статистику прогріву

Відстежуйте прогрес показника розміщення у вхідних і визначайте провайдерів, у яких прогрів відстає.

Цей метод повертає денну статистику та статистику доставлюваності за провайдерами для кампанії прогріву.

Можна переглядати статистику за стандартними часовими проміжками або вказати кастомний діапазон дат — корисно для відстеження прогресу на різних етапах або порівняння результатів за різні проміжки часу.

GET https://api.snov.io/v2/warm-up/statistics/{id}

Обов'язкові параметри:

period — стандартний часовий проміжок: two_weeks або month. Обов'язковий, якщо не вказано date_from / date_to
date_from — початкова дата кастомного діапазону (YYYY-MM-DD). Обов'язкова, якщо не вказано period
date_to — кінцева дата кастомного діапазону (YYYY-MM-DD). Має бути не раніше date_from і не раніше дати початку кампанії. Обов'язкова, якщо не вказано period

Видалити кампанію прогріву

Видаліть кампанію прогріву, яка більше не потрібна. Цю дію не можна скасувати.

Цей метод безповоротно видаляє кампанію прогріву та її статистику — вони більше не будуть доступні через інші методи API прогріву. Використовуйте, коли прогрів завершено або відстежувати кампанію більше не потрібно.

DELETE https://api.snov.io/v2/warm-up/{id}

Обов'язкові параметри: