---
title: "ActiveCampaign konektor"
description: "Kompletný sprievodca integráciou ActiveCampaign na synchronizáciu kontaktov, obchodov, automatizácií a udalostí zapojenia s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/sk/docs/connectors/marketing/activecampaign.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# ActiveCampaign konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj svoj účet ActiveCampaign s Brevo cez Tajo pre komplexnú migráciu kontaktov, synchronizáciu pipeline obchodov, mapovanie automatizácií a zjednotené marketingové dáta naprieč oboma platformami.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | ActiveCampaign |
| **Kategória** | Marketing |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Kontakty, Obchody, Automatizácie, Udalosti |
| **API Base URL** | `https://{account}.api-us1.com/api/3` |

## Funkcie

- **Migrácia kontaktov** - Migruj kontakty s vlastnými poľami, tagmi a členstvami v zozname
- **Synchronizácia pipeline obchodov** - Synchronizuj fázy obchodov, hodnoty a majiteľov pre sledovanie príjmov
- **Mapovanie automatizácií** - Mapuj automatizácie ActiveCampaign na triggery workflowov Brevo
- **Sledovanie udalostí** - Synchronizuj sledovanie stránok a vlastné udalosti pre behaviorálnu segmentáciu
- **Synchronizácia zoznamov a tagov** - Replikuj štruktúry zoznamov a segmenty na základe tagov v Brevo
- **E-commerce integrácia** - Synchronizuj Deep Data (objednávky, zákazníci, košíky) do Brevo
- **Synchronizácia vlastných objektov** - Mapuj vlastné objekty ActiveCampaign na atribúty Brevo
- **Synchronizácia skóre** - Prenášaj skóre leadov a kontaktov do atribútov Brevo

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Účet ActiveCampaign (Lite, Plus, Professional alebo Enterprise)
2. API URL a API kľúč z Settings > Developer
3. Brevo účet s API prístupom
4. Tajo účet

## Autentifikácia

### Autentifikácia API kľúčom

ActiveCampaign používa API kľúč prenášaný ako hlavička alebo parameter dopytu.

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

Nájdi svoju API URL a kľúč v ActiveCampaign Settings > Developer.

API URL

Tvoja API URL je unikátna pre tvoj účet (napr. `https://yourcompany.api-us1.com`). Vždy použi túto URL, nie URL dashboardu.

## Konfigurácia

### Základné nastavenie

```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
```

### Mapovanie polí

Namapuj polia ActiveCampaign na atribúty kontaktov Brevo:

#### Predvolené mapovania

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | E-mail kontaktu (unikátny identifikátor) |
| `firstName` optional | string | Mapuje sa na atribút FIRSTNAME |
| `lastName` optional | string | Mapuje sa na atribút LASTNAME |
| `phone` optional | string | Mapuje sa na atribút SMS |
| `tags` optional | array | Tagy kontaktu pre segmentáciu |
| `score` optional | integer | Skóre zapojenia kontaktu |
| `deals` optional | array | Priradené záznamy obchodov |
| `fieldValues` optional | array | Hodnoty vlastných polí |

#### Mapovanie vlastných polí

```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 endpointy

### Kontakty

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Zoznam všetkých kontaktov |
| `POST` | `/api/3/contacts` | Vytvorenie kontaktu |
| `PUT` | `/api/3/contacts/{id}` | Aktualizácia kontaktu |
| `GET` | `/api/3/contacts/{id}` | Načítanie kontaktu |
| `POST` | `/api/3/contact/sync` | Synchronizácia kontaktu (vytvoriť alebo aktualizovať) |
| `POST` | `/api/3/import/bulk_import` | Hromadný import kontaktov |

### Obchody

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Zoznam všetkých obchodov |
| `POST` | `/api/3/deals` | Vytvorenie obchodu |
| `PUT` | `/api/3/deals/{id}` | Aktualizácia obchodu |
| `GET` | `/api/3/dealStages` | Zoznam všetkých fáz obchodov |
| `GET` | `/api/3/dealPipelines` | Zoznam všetkých pipeline |

### Automatizácie

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Zoznam automatizácií |
| `GET` | `/api/3/automations/{id}` | Načítanie automatizácie |
| `POST` | `/api/3/contactAutomations` | Pridanie kontaktu do automatizácie |

### E-commerce (Deep Data)

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Vytvorenie objednávky |
| `GET` | `/api/3/ecomOrders` | Zoznam objednávok |
| `POST` | `/api/3/ecomCustomers` | Vytvorenie zákazníka |
| `GET` | `/api/3/ecomCustomers` | Zoznam zákazníkov |

### Sledovanie udalostí

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Sledovanie vlastnej udalosti |
| `GET` | `/api/3/eventTrackingEvents` | Zoznam všetkých názvov udalostí |
| `POST` | `/api/3/eventTrackingEvents` | Vytvorenie názvu udalosti |

## Udalosti

### Udalosti kontaktov

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `contact_add` | Vytvorený nový kontakt | Uvítací tok |
| `contact_update` | Zmenené dáta kontaktu | Synchronizácia atribútov |
| `contact_tag_added` | Priradený tag | Aktualizácia segmentu |
| `contact_tag_removed` | Odstránený tag | Čistenie segmentu |

### Udalosti obchodov

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `deal_add` | Vytvorený nový obchod | Notifikácia predaja |
| `deal_update` | Zmenená fáza obchodu | Automatizácia pipeline |
| `deal_tasktype_add` | Pridaná úloha k obchodu | Sledovanie aktivity |

### Udalosti automatizácií

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `automation_contact_add` | Kontakt vstúpil do automatizácie | Sledovanie toku |
| `automation_contact_complete` | Kontakt dokončil automatizáciu | Trigger nasledujúceho kroku |

## Ukážky kódu

### Inicializácia konektora

```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
});
```

### Migrácia kontaktov do 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
// }
```

### Sledovanie vlastných udalostí

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

## Obmedzenia rýchlosti

Limity rýchlosti ActiveCampaign API:

| Plán | Limit rýchlosti | Detaily |
| --- | --- | --- |
| Lite | 5 požiadaviek/sekundu | Na účet |
| Plus | 10 požiadaviek/sekundu | Na účet |
| Professional | 10 požiadaviek/sekundu | Na účet |
| Enterprise | 20 požiadaviek/sekundu | Na účet |

Ďalšie limity:

- **Hromadný import**: 250 kontaktov na dávku
- **Frekvencia hromadného importu**: 1 import naraz
- **Sledovanie udalostí**: 2 požiadavky/sekundu
- **Denný limit**: Žiadny explicitný denný limit (iba na základe rýchlosti)

Spracovanie limitov rýchlosti

ActiveCampaign vracia `429 Too Many Requests` pri prekročení limitov. Implementuj logiku opakovania s hodnotou hlavičky `Retry-After`.

## Riešenie problémov

### Bežné problémy

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| 403 Forbidden | Neplatný API kľúč alebo URL | Overte API URL a kľúč v AC Settings > Developer |
| Kontakt nie je synchronizovaný | Spracovanie duplicitných e-mailov | Použi endpoint `/contact/sync` pre upsert správanie |
| Vlastné pole prázdne | Nezhoda ID poľa | Mapuj polia podľa ID, nie podľa labelu (labely sa môžu meniť) |
| Webhook nie je prijatý | Webhook nie je nakonfigurovaný | Nastav webhooky v AC Settings > Developer > Webhooks |
| Obchod nie je vytvorený | Chýbajúce povinné polia | Uisti sa, že pipeline, fáza a kontakt sú poskytnuté |

### Debug režim

Zapni verbose logovanie:

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

### Test pripojenia

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

## Odporúčané postupy

1. **Použi endpoint synchronizácie kontaktov** - Použi `/contact/sync` pre upsert operácie namiesto samostatného vytvárania/aktualizácie
2. **Mapuj polia podľa ID** - ID vlastných polí sú stabilné; labely sa môžu meniť
3. **Zachovaj členstvá v zoznamoch** - Migruj priradenia zoznamov spolu s dátami kontaktov
4. **Synchronizuj pipeline obchodov** - Mapuj fázy pipeline pre konzistentné CRM reportovanie
5. **Implementuj sledovanie udalostí** - Použi sledovanie stránok pre behaviorálne dáta v Brevo
6. **Dávkové importy** - Použi hromadný import pre datasety väčšie ako 1 000 kontaktov

## Bezpečnosť

- **Autentifikácia API kľúčom** - Prístup na základe tokenov cez hlavičku `Api-Token`
- **Overenie webhookov** - Validuj rozsahy IP zdrojov webhookov
- **TLS šifrovanie** - Všetka API komunikácia šifrovaná cez HTTPS
- **Prístup na úrovni účtu** - API kľúč poskytuje plný prístup k účtu; použi opatrne
- **IP obmedzenia** - Dostupné v plánoch Enterprise

## Súvisiace zdroje

- [ActiveCampaign API dokumentácia](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign Webhook sprievodca](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp konektor](https://tajo.io/sk/docs/connectors/marketing/mailchimp)
- [Brevo konektor](https://tajo.io/sk/docs/connectors/marketing/brevo)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)