Як налаштовувати кампанії та керувати ними через Snov.io API

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

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

• Підготуйте налаштування акаунту
• Підготуйте список контактів

Методи API кампаній

• Отримати налаштування акаунту
• Керувати email-акаунтами відправників
• Створювати кампанії та керувати ними
• Додавати та оновлювати вміст імейлів
• Керувати отримувачами

API доступний на всіх планах сейлз-пакету. Щоб використовувати методи API з діями LinkedIn, увімкніть автоматизацію LinkedIn у вашому акаунті.

Що можна робити за допомогою API кампаній:

1) Запускати кампанії автоматично. Створюйте, редагуйте та запускайте кампанії через API-запити.

2) Отримувати вебхуки в реальному часі. Відстежуйте відповіді, прийняті запити на контакт, відповіді на InMail, автовідповіді та інші дії контактів у момент їх виникнення.

3) Синхронізувати дані активності з вашими інструментами. Надсилайте дані активності кампаній і отримувачів безпосередньо до вашої CRM, дашбордів або аналітичних платформ.

Перш ніж розпочати роботу з API кампаній

• Підключіть щонайменше один email-акаунт відправника. Прогрійте акаунти відправників за допомогою Прогріву email в застосунку або API прогріву email перед запуском кампаній.
• Створіть щонайменше один розклад відправлення в розкладах кампаній.
• Створіть або імпортуйте щонайменше один список контактів-винятків у списках контактів-винятків або додайте його через метод API.

Підготуйте список контактів

Формуйте список контактів через API: знаходьте контакти, верифікуйте email-адреси та організовуйте їх у список отримувачів. Вказуйте recipient_list_id під час створення кампанії. Продовжуйте додавати нових лідів до того самого списку через API після запуску кампанії — вони автоматично потраплять до послідовності.

Знайдіть нові контакти

Якщо потрібно знайти ліди — скористайтесь API Email Finder для пошуку контактів і корпоративних email-адрес.

Верифікуйте наявні адреси

Верифікуйте email-адреси з вашої CRM, реєстрацій на заходи або сторонніх баз за допомогою API Email Verifier перед аутрічем. Знижуйте показник відмов і покращуйте доставлюваність.

Зберіть контакти в список

Створіть список для ваших контактів і додайте їх за допомогою методів API списку контактів. Використовуйте list_id під час створення кампаній.

• Створити новий список контактів
• Додати контакти до списку

Методи API кампаній

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

Оптимальний порядок роботи з API кампаній: підготуйте акаунти відправників і списки отримувачів, створіть кампанію, додайте вміст послідовності, запустіть аутріч, відстежуйте результати через вебхуки та API аналітики.

Отримати налаштування акаунту

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

Отримати email-акаунти відправників

Отримайте ID акаунту відправника та підтвердіть денні ліміти перед призначенням акаунту до кампанії.

Повертає всі підключені email-акаунти з іменами відправників, email-адресами, денними лімітами та інформацією про провайдера.

Перевірити статус SMTP/IMAP акаунту відправника

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

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

email — email-адреса акаунту відправника для перевірки

Отримати списки контактів-винятків

Отримайте списки контактів-винятків, створені у вашому акаунті.

Отримайте ID списку контактів-винятків, який призначатиметесь до кампанії для автоматичного виключення конкретних контактів із послідовності.

Отримати розклади кампаній

Отримайте ID розкладу, який використовуватиметесь у кампанії.

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

Керувати email-акаунтами відправників

За допомогою цих методів можна підключати, налаштовувати та прогрівати email-акаунти.

Додати новий email-акаунт

Підключає email-акаунт за допомогою налаштувань SMTP та IMAP, щоб призначити його відправником у кампаніях.

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

SMTP-облікові дані та налаштування сервера акаунту.

sender_name, email_from, password, smtp.host, smtp.port, smtp.encryption

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

• Налаштування IMAP: відстеження відповідей на імейли, надіслані з цього акаунту відправника
• Інтервал між імейлами: якщо не вказано — акаунт використовує затримку за замовчуванням 600 секунд
• Денний ліміт надсилання: якщо не вказано — акаунт використовує ліміт SMTP за замовчуванням — 50 імейлів/день

Примітка: підключення через Gmail і Microsoft OAuth доступне лише в застосунку, у розділі Email-акаунти — цей метод API його не підтримує.

Оновити email-акаунт

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

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

account_id — ID email-акаунта відправника, який потрібно оновити

Запустити прогрів

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

sender_account_id — ID email-акаунта для прогріву

per_day — щоденна мета надсилання: кількість імейлів прогріву на день. Для початкового прогріву рекомендуємо встановити 40 імейлів на день. Залежно від вашого плану ліміт може бути до 1000 імейлів

strategy — виберіть стратегію прогріву: зростаюча поступово нарощує денний обсяг відправлення для нових або неактивних акаунтів (рекомендується від 2 до 40 імейлів); постійна підтримує репутацію відправника з фіксованим денним обсягом

email_content — прогрівайте власний шаблон імейлу для покращення його доставлюваність або використовуйте контент, згенерований ШІ

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

Ці методи дозволяють налаштовувати кампанії з повною конфігурацією: кроки послідовності (email + LinkedIn), розклад, відстеження, акаунти відправників, список отримувачів і налаштування відправлення.

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

Створіть кампанію та отримайте ID кампанії, який використовуватиметься у всіх наступних API-викликах.

Створює чернетку нової кампанії з основними налаштуваннями, необхідними для запуску

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

Назва кампанії, розклад відправлення та щонайменше один акаунт відправника

name, schedule_id, sender_account_ids

Додавання дублікатів контактів не створює дублікат отримувача в тій самій кампанії. Щоб уникнути дублікатів по всьому акаунту — використовуйте параметр sending_settings.skip_recipients у методі «Створити кампанію».

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

Перевірте поточні налаштування та статус кампанії перед внесенням змін або запуском.

Повертає повні деталі конкретної кампанії — статус, акаунти відправників, налаштування відправлення, отримувачів і кроки послідовності.

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

campaign_id — ID кампанії в URL запиту

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

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

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

campaign_id — ID кампанії в URL запиту, плюс будь-які поля для оновлення

Змінити статуси кампанії

Керуйте життєвим циклом кампанії — запускайте аутріч, призупиняйте або завершуйте кампанію. Цей метод оновлює статус кампанії: активна, призупинена, відновлена, завершена або архівована.

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

campaign_id — ID кампанії в URL запиту; action — цільовий статус для переходу

Підтримувані статуси: Launch, Pause, Resume, Complete, Archive

Видалити кампанію

Безповоротно видаляє кампанію з вашого акаунту.

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

campaign_id — ID кампанії в URL запиту

Видалити можна лише кампанії зі статусом New (чернетка), Completed або Archived.

Додавати та оновлювати вміст імейлів

Ці методи дозволяють керувати вмістом (темою та тілом) для кожного кроку«Імейл» в послідовності кампанії.

Створити вміст кроку«Імейл»

Додайте тему та тіло імейлу.

Додає блок вмісту до вказаного кроку«Імейл» в послідовності.

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

campaign_id, step_id — ID кампанії та ID кроку в URL

subject, body — тема та вміст імейлу

Отримати вміст кроку «Імейл»

Перегляньте поточний вміст імейлу перед внесенням змін.

Повертає конкретний блок вмісту для кроку«Імейл».

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

campaign_id, step_id, content_id — ID кампанії, ID кроку та блоку вмісту в URL

Оновити вміст кроку «Імейл»

Редагуйте тему або тіло кроку«Імейл» без заміни всього блоку вмісту.

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

campaign_id, step_id, content_id — ID кампанії, ID кроку та блоку вмісту в URL, плюс будь-які поля вмісту для оновлення

Видалити контент кроку«Імейл»

Видаляє блок вмісту з кроку«Імейл»

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

campaign_id, step_id, content_id — ID кампанії, ID кроку та блоку вмісту в URL в URL

Керувати отримувачами

Ці методи дозволяють контролювати статус ваших контактів у кампанії.

Змінити статус отримувача

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

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

campaign_id — ID кампанії в URL; email, status — email-адреса контакту та новий статус для застосування

Перевірити статус отримувача

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

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

campaign_id, recipient_id — ID кампанії та ID отримувача в URL

Наступні кроки в API

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

Налаштувати вебхуки

Підписуйтесь на події кампанії та отримуйте сповіщення в реальному часі на URL кінцевої точки (endpoint URL). Повний список підтримуваних подій, методів і деталей корисного навантаження — у гайді з вебхуків.

Отримати аналітику та звіти кампаній

Отримуйте дані про залученість окремих отримувачів і агреговані метрики кампаній. Повний список методів звітності, параметрів і прикладів відповідей — у гайді з API аналітики кампаній.