---
title: "ActiveCampaign конектор"
description: "Пълно ръководство за интеграция с ActiveCampaign за синхронизация на контакти, сделки, автоматизации и събития за ангажиране с Brevo чрез Tajo."
url: https://tajo.io/bg/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/bg/docs/connectors/marketing/activecampaign.md
lang: bg-BG
robots: noindex
---

Заявете ранен достъп

Въведете собственото си име и служебен имейл адрес. Ще ви изпратим връзка за потвърждение на заявката за достъп до Tajo.

# ActiveCampaign конектор

Статус на конектора: Планиран Все още не е изграден. Tajo не изпълнява този конектор днес.

| Поле източник | Целево поле | Примерна стойност |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Свържи своя акаунт в ActiveCampaign с Brevo чрез Tajo за цялостна миграция на контакти, синхронизация на deal pipeline, мапване на автоматизации и унифицирани маркетингови данни в двете платформи.

## Преглед

| Свойство | Стойност |
| --- | --- |
| **Платформа** | ActiveCampaign |
| **Категория** | Маркетинг |
| **Сложност на настройка** | Средна |
| **Официална интеграция** | Не |
| **Синхронизирани данни** | Контакти, сделки, автоматизации, събития |
| **Base URL на API** | `https://{account}.api-us1.com/api/3` |

## Функции

- **Миграция на контакти** – Мигрирай контакти с персонализирани полета, тагове и членства в списъци
- **Синхронизация на deal pipeline** – Синхронизирай deal етапи, стойности и собственици за проследяване на приходи
- **Мапване на автоматизации** – Мапвай автоматизации на ActiveCampaign към workflow тригери в Brevo
- **Проследяване на събития** – Синхронизирай site tracking и персонализирани събития за поведенческа сегментация
- **Синхронизация на списъци и тагове** – Репликирай структури на списъци и сегменти на базата на тагове в Brevo
- **E-commerce интеграция** – Синхронизирай Deep Data (поръчки, клиенти, кошници) към Brevo
- **Синхронизация на персонализирани обекти** – Мапвай персонализирани обекти на ActiveCampaign към атрибути в Brevo
- **Синхронизация на скорове** – Прехвърляй lead и contact скорове към атрибути в Brevo

## Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Акаунт в ActiveCampaign (Lite, Plus, Professional или Enterprise)
2. API URL и API ключ от Settings > Developer
3. Акаунт в Brevo с API достъп
4. Акаунт в Tajo

## Автентикация

### Автентикация с API ключ

ActiveCampaign използва API ключ, подаден като хедър или query параметър.

```bash
curl "https://{account}.api-us1.com/api/3/contacts" \
  -H "Api-Token: YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

Намери своя API URL и ключ в ActiveCampaign Settings > Developer.

API URL

Твоят API URL е уникален за акаунта (напр. `https://yourcompany.api-us1.com`). Винаги използвай този URL, а не URL-а на dashboard-а.

## Конфигурация

### Основна настройка

```yaml
connectors:
  activecampaign:
    enabled: true
    api_url: "https://yourcompany.api-us1.com"
    api_key: "${AC_API_KEY}"

    # Data sync options
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # List mapping to Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52
```

### Мапване на полета

Мапвай полета на ActiveCampaign към атрибути на контактите в Brevo:

#### Мапвания по подразбиране

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Имейл на контакта (уникален идентификатор) |
| `firstName` optional | string | Мапва към атрибут FIRSTNAME |
| `lastName` optional | string | Мапва към атрибут LASTNAME |
| `phone` optional | string | Мапва към атрибут SMS |
| `tags` optional | array | Тагове на контакта за сегментация |
| `score` optional | integer | Скор за ангажираност на контакта |
| `deals` optional | array | Свързани deal записи |
| `fieldValues` optional | array | Стойности на персонализирани полета |

#### Мапване на персонализирани полета

```yaml
field_mapping:
  # Standard fields
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Engagement fields
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Deal fields
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Custom fields
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER
```

## API крайни точки

### Контакти

| Метод | Крайна точка | Описание |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Списък с всички контакти |
| `POST` | `/api/3/contacts` | Създаване на контакт |
| `PUT` | `/api/3/contacts/{id}` | Обновяване на контакт |
| `GET` | `/api/3/contacts/{id}` | Получаване на контакт |
| `POST` | `/api/3/contact/sync` | Синхронизация на контакт (създаване или обновяване) |
| `POST` | `/api/3/import/bulk_import` | Масов импорт на контакти |

### Сделки

| Метод | Крайна точка | Описание |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Списък с всички сделки |
| `POST` | `/api/3/deals` | Създаване на сделка |
| `PUT` | `/api/3/deals/{id}` | Обновяване на сделка |
| `GET` | `/api/3/dealStages` | Списък с всички етапи на сделки |
| `GET` | `/api/3/dealPipelines` | Списък с всички pipeline-и |

### Автоматизации

| Метод | Крайна точка | Описание |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Списък с автоматизации |
| `GET` | `/api/3/automations/{id}` | Получаване на автоматизация |
| `POST` | `/api/3/contactAutomations` | Добавяне на контакт към автоматизация |

### E-commerce (Deep Data)

| Метод | Крайна точка | Описание |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Създаване на поръчка |
| `GET` | `/api/3/ecomOrders` | Списък с поръчки |
| `POST` | `/api/3/ecomCustomers` | Създаване на клиент |
| `GET` | `/api/3/ecomCustomers` | Списък с клиенти |

### Проследяване на събития

| Метод | Крайна точка | Описание |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Проследи персонализирано събитие |
| `GET` | `/api/3/eventTrackingEvents` | Списък с всички имена на събития |
| `POST` | `/api/3/eventTrackingEvents` | Създаване на име на събитие |

## Събития

### Събития от контакти

| Събитие | Тригер | Случай на употреба |
| --- | --- | --- |
| `contact_add` | Създаден нов контакт | Welcome поток |
| `contact_update` | Променени данни на контакт | Синхронизация на атрибути |
| `contact_tag_added` | Присвоен таг | Обновяване на сегмент |
| `contact_tag_removed` | Премахнат таг | Почистване на сегмент |

### Събития от сделки

| Събитие | Тригер | Случай на употреба |
| --- | --- | --- |
| `deal_add` | Създадена нова сделка | Известие за sales |
| `deal_update` | Променен етап на сделка | Автоматизация на pipeline |
| `deal_tasktype_add` | Добавена задача към сделка | Проследяване на активност |

### Събития от автоматизации

| Събитие | Тригер | Случай на употреба |
| --- | --- | --- |
| `automation_contact_add` | Контактът влезе в автоматизация | Проследяване на поток |
| `automation_contact_complete` | Контактът завърши автоматизация | Тригер за следваща стъпка |

## Примери с код

### Инициализация на конектора

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect ActiveCampaign
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});
```

### Миграция на контакти към Brevo

```javascript
// Full contact migration with custom fields and tags
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Check sync status
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }
```

### Проследяване на персонализирани събития

```javascript
// Forward ActiveCampaign events to Brevo
await tajo.activecampaign.trackEvent({
  email: 'customer@example.com',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});
```

## Ограничения на заявките

API rate limits на ActiveCampaign:

| План | Rate Limit | Детайли |
| --- | --- | --- |
| Lite | 5 заявки/секунда | На акаунт |
| Plus | 10 заявки/секунда | На акаунт |
| Professional | 10 заявки/секунда | На акаунт |
| Enterprise | 20 заявки/секунда | На акаунт |

Допълнителни лимити:

- **Масов импорт**: 250 контакта на пакет
- **Честота на масов импорт**: 1 импорт едновременно
- **Проследяване на събития**: 2 заявки/секунда
- **Дневен лимит**: Без изричен дневен лимит (само на базата на rate)

Обработка на rate limit

ActiveCampaign връща `429 Too Many Requests`, когато лимитите са надвишени. Внедри retry логика със стойността на хедъра `Retry-After`.

## Отстраняване на проблеми

### Чести проблеми

| Проблем | Причина | Решение |
| --- | --- | --- |
| 403 Forbidden | Невалиден API ключ или URL | Провери API URL и ключа в AC Settings > Developer |
| Контактът не е синхронизиран | Обработка на дублиран имейл | Използвай крайната точка `/contact/sync` за upsert поведение |
| Персонализираното поле е празно | Несъответствие на field ID | Мапвай полета по ID, не по label (label-ите могат да се променят) |
| Уебхук не се получава | Уебхукът не е конфигуриран | Настрой уебхуци в AC Settings > Developer > Webhooks |
| Сделката не е създадена | Липсващи задължителни полета | Увери се, че pipeline, stage и contact са предоставени |

### Режим за дебъг

Активирай подробно логване:

```yaml
connectors:
  activecampaign:
    debug: true
    log_level: verbose
    log_webhooks: true
```

### Тест на връзката

```bash
tajo connectors test activecampaign
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Deals readable
# ✓ Automations accessible
# ✓ Event tracking enabled
```

## Добри практики

1. **Използвай sync крайна точка за контакти** – Използвай `/contact/sync` за upsert операции вместо отделни create/update
2. **Мапвай полета по ID** – ID-тата на персонализираните полета са стабилни; label-ите могат да се променят
3. **Запазвай членството в списъци** – Мигрирай list assignments заедно с данните на контакта
4. **Синхронизирай deal pipeline-и** – Мапвай етапите на pipeline за консистентно CRM отчитане
5. **Внедри проследяване на събития** – Използвай site tracking за поведенчески данни в Brevo
6. **Пакетни импорти** – Използвай масов импорт за данни с повече от 1 000 контакта

## Сигурност

- **Автентикация с API ключ** – Token-базиран достъп чрез хедъра `Api-Token`
- **Верификация на уебхуци** – Валидирай IP диапазоните на източника на уебхук
- **TLS криптиране** – Цялата API комуникация е криптирана чрез HTTPS
- **Достъп на ниво акаунт** – API ключът предоставя пълен достъп до акаунта; използвай с внимание
- **IP ограничения** – Достъпни на Enterprise планове

## Свързани ресурси

- [ActiveCampaign API документация](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign ръководство за уебхуци](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp конектор](https://tajo.io/bg/docs/connectors/marketing/mailchimp)
- [Brevo конектор](https://tajo.io/bg/docs/connectors/marketing/brevo)
- [Customer Sync скил](https://tajo.io/bg/docs/skills/data-sync/customer-sync)