ActiveCampaign

ActiveCampaign

Интеграция с API ActiveCampaign через управляемую OAuth-аутентификацию. Позволяет работать с контактами, кампаниями, автоматизациями и другими сущностями платформы email-маркетинга.

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

Быстрый старт

Все запросы выполняются через проксированный API-шлюз с использованием ключа доступа. Базовый URL формируется на основе аккаунта ActiveCampaign.

https://{account}.api-us1.com/api/3/

Для авторизации требуется API-ключ, который передаётся в заголовках запроса.

Основные возможности

• Управление контактами (создание, обновление, удаление)
• Работа с тегами и сегментацией аудитории
• Создание и управление списками рассылок
• Управление сделками и воронками продаж
• Доступ к автоматизациям и кампаниям
• Получение данных пользователей и аккаунтов

Контакты

Получение списка контактов:

GET /contacts

Создание контакта:

POST /contacts
{
 "contact": {
 "email": "user@example.com",
 "firstName": "John",
 "lastName": "Doe"
 }
}

Обновление и удаление контактов осуществляется через соответствующие endpoints с указанием ID.

Теги

Система тегов позволяет сегментировать аудиторию и управлять связями между контактами и категориями.

GET /tags
POST /tags

Добавление тега к контакту:

POST /contactTags

Списки и сделки

Работа со списками рассылок:

GET /lists
POST /lists

Управление сделками:

GET /deals
POST /deals

Поддерживаются стадии сделок и пайплайны продаж.

Автоматизации и кампании

Навык предоставляет доступ к автоматизациям и маркетинговым кампаниям:

GET /automations
GET /campaigns

Дополнительные ресурсы

• Пользователи
• Аккаунты
• Пользовательские поля
• Заметки
• Вебхуки

Пагинация

Используется offset-пагинация:

GET /contacts?limit=20&offset=0

Параметры:

• limit — количество записей
• offset — смещение

Ответ содержит метаинформацию с общим количеством записей.

Примечания

• Все endpoint’ы используют префикс /api/3/
• Тело запроса использует единственное число ресурса
• ID возвращаются в виде строк
• Ограничение: до 5 запросов в секунду на аккаунт
• DELETE-запросы возвращают статус 200