---
title: "Konektor ActiveCampaign"
description: "Kompletní průvodce integrací ActiveCampaign pro synchronizaci kontaktů, obchodů, automatizací a událostí zapojení s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/cz/docs/connectors/marketing/activecampaign.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor ActiveCampaign

Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte svůj účet ActiveCampaign s Brevo přes Tajo pro komplexní migraci kontaktů, synchronizaci obchodního pipeline, mapování automatizací a sjednocená marketingová data napříč oběma platformami.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | ActiveCampaign |
| **Kategorie** | Marketing |
| **Složitost nastavení** | Střední |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Kontakty, Obchody, Automatizace, Události |
| **Základní URL API** | `https://{account}.api-us1.com/api/3` |

## Funkce

- **Migrace kontaktů** – Migrujte kontakty s vlastními poli, štítky a členstvím v seznamech
- **Synchronizace obchodního pipeline** – Synchronizujte fáze, hodnoty a vlastníky obchodů pro sledování příjmů
- **Mapování automatizací** – Mapujte automatizace ActiveCampaign na spouštěče pracovních toků Brevo
- **Sledování událostí** – Synchronizujte sledování webu a vlastní události pro behaviorální segmentaci
- **Synchronizace seznamů a štítků** – Replikujte struktury seznamů a segmenty na základě štítků v Brevo
- **Integrace e-commerce** – Synchronizujte Deep Data (objednávky, zákazníci, košíky) do Brevo
- **Synchronizace vlastních objektů** – Mapujte vlastní objekty ActiveCampaign na atributy Brevo
- **Synchronizace skóre** – Přeneste skóre potenciálních zákazníků a kontaktů na atributy Brevo

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet ActiveCampaign (Lite, Plus, Professional nebo Enterprise)
2. URL API a API klíč z Nastavení > Developer
3. Účet Brevo s přístupem k API
4. Účet Tajo

## Ověření

### Ověření API klíčem

ActiveCampaign používá API klíč předávaný jako hlavičku nebo parametr dotazu.

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

URL API a klíč naleznete v ActiveCampaign Nastavení > Developer.

URL API

Vaše URL API je jedinečná pro váš účet (např. `https://yourcompany.api-us1.com`). Vždy používejte tuto URL, nikoli URL řídicího panelu.

## Konfigurace

### Základní nastavení

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

    # Možnosti synchronizace dat
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Mapování seznamů na Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52
```

### Mapování polí

Mapujte pole ActiveCampaign na atributy kontaktů Brevo:

#### Výchozí mapování

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | E-mail kontaktu (jedinečný identifikátor) |
| `firstName` optional | string | Mapuje se na atribut FIRSTNAME |
| `lastName` optional | string | Mapuje se na atribut LASTNAME |
| `phone` optional | string | Mapuje se na atribut SMS |
| `tags` optional | array | Štítky kontaktu pro segmentaci |
| `score` optional | integer | Skóre zapojení kontaktu |
| `deals` optional | array | Přidružené záznamy obchodů |
| `fieldValues` optional | array | Hodnoty vlastních polí |

#### Mapování vlastních polí

```yaml
field_mapping:
  # Standardní pole
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Pole zapojení
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Pole obchodů
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Vlastní pole
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER
```

## Koncové body API

### Kontakty

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Výpis všech kontaktů |
| `POST` | `/api/3/contacts` | Vytvoření kontaktu |
| `PUT` | `/api/3/contacts/{id}` | Aktualizace kontaktu |
| `GET` | `/api/3/contacts/{id}` | Načtení kontaktu |
| `POST` | `/api/3/contact/sync` | Synchronizace kontaktu (vytvoření nebo aktualizace) |
| `POST` | `/api/3/import/bulk_import` | Hromadný import kontaktů |

### Obchody

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Výpis všech obchodů |
| `POST` | `/api/3/deals` | Vytvoření obchodu |
| `PUT` | `/api/3/deals/{id}` | Aktualizace obchodu |
| `GET` | `/api/3/dealStages` | Výpis všech fází obchodů |
| `GET` | `/api/3/dealPipelines` | Výpis všech pipeline |

### Automatizace

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Výpis automatizací |
| `GET` | `/api/3/automations/{id}` | Načtení automatizace |
| `POST` | `/api/3/contactAutomations` | Přidání kontaktu do automatizace |

### E-commerce (Deep Data)

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Vytvoření objednávky |
| `GET` | `/api/3/ecomOrders` | Výpis objednávek |
| `POST` | `/api/3/ecomCustomers` | Vytvoření zákazníka |
| `GET` | `/api/3/ecomCustomers` | Výpis zákazníků |

### Sledování událostí

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Sledování vlastní události |
| `GET` | `/api/3/eventTrackingEvents` | Výpis všech názvů událostí |
| `POST` | `/api/3/eventTrackingEvents` | Vytvoření názvu události |

## Události

### Kontaktní události

| Událost | Spouštěč | Případ použití |
| --- | --- | --- |
| `contact_add` | Vytvořen nový kontakt | Uvítací tok |
| `contact_update` | Kontaktní data změněna | Synchronizace atributů |
| `contact_tag_added` | Přiřazen štítek | Aktualizace segmentu |
| `contact_tag_removed` | Štítek odebrán | Úklid segmentu |

### Události obchodů

| Událost | Spouštěč | Případ použití |
| --- | --- | --- |
| `deal_add` | Vytvořen nový obchod | Prodejní notifikace |
| `deal_update` | Změna fáze obchodu | Automatizace pipeline |
| `deal_tasktype_add` | Přidán úkol k obchodu | Sledování aktivity |

### Události automatizací

| Událost | Spouštěč | Případ použití |
| --- | --- | --- |
| `automation_contact_add` | Kontakt vstoupil do automatizace | Sledování toku |
| `automation_contact_complete` | Kontakt dokončil automatizaci | Spouštěč dalšího kroku |

## Příklady kódu

### Inicializace konektoru

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

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

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

### Migrace kontaktů do Brevo

```javascript
// Úplná migrace kontaktů s vlastními poli a štítky
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

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

### Sledování vlastních událostí

```javascript
// Přeposílání událostí ActiveCampaign do Brevo
await tajo.activecampaign.trackEvent({
  email: 'customer@example.com',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});
```

## Omezení rychlosti

Limity rychlosti ActiveCampaign API:

| Plán | Limit rychlosti | Podrobnosti |
| --- | --- | --- |
| Lite | 5 požadavků/sekundu | Na účet |
| Plus | 10 požadavků/sekundu | Na účet |
| Professional | 10 požadavků/sekundu | Na účet |
| Enterprise | 20 požadavků/sekundu | Na účet |

Další limity:

- **Hromadný import**: 250 kontaktů na dávku
- **Frekvence hromadného importu**: 1 import najednou
- **Sledování událostí**: 2 požadavky/sekundu
- **Denní limit**: Žádný explicitní denní limit (pouze na základě rychlosti)

Zpracování limitu rychlosti

ActiveCampaign vrací `429 Too Many Requests`, když jsou limity překročeny. Implementujte logiku opakování s hodnotou hlavičky `Retry-After`.

## Řešení problémů

### Časté problémy

| Problém | Příčina | Řešení |
| --- | --- | --- |
| 403 Forbidden | Neplatný API klíč nebo URL | Ověřte URL API a klíč v AC Nastavení > Developer |
| Kontakt nesynchronizován | Zpracování duplicitního e-mailu | Používejte koncový bod `/contact/sync` pro chování upsert |
| Prázdné vlastní pole | Neshoda ID pole | Mapujte pole podle ID, nikoli podle popisku (popisky se mohou změnit) |
| Webhook nebyl přijat | Webhook není nakonfigurován | Nastavte webhooky v AC Nastavení > Developer > Webhooks |
| Obchod nebyl vytvořen | Chybějící povinná pole | Ujistěte se, že jsou poskytnuty pipeline, fáze a kontakt |

### Režim ladění

Povolte podrobné protokolování:

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

### Test připojení

```bash
tajo connectors test activecampaign
# ✓ Připojení API úspěšné
# ✓ Kontakty čitelné
# ✓ Obchody čitelné
# ✓ Automatizace přístupné
# ✓ Sledování událostí povoleno
```

## Osvědčené postupy

1. **Používejte koncový bod synchronizace kontaktů** – Používejte `/contact/sync` pro operace upsert místo oddělených vytváření/aktualizací
2. **Mapujte pole podle ID** – ID vlastních polí jsou stabilní; popisky se mohou měnit
3. **Zachovejte členství v seznamech** – Migrujte přiřazení seznamů společně s daty kontaktů
4. **Synchronizujte obchodní pipeline** – Mapujte fáze pipeline pro konzistentní CRM reporting
5. **Implementujte sledování událostí** – Používejte sledování webu pro behaviorální data v Brevo
6. **Dávkové importy** – Používejte hromadný import pro datové sady větší než 1 000 kontaktů

## Zabezpečení

- **Ověřování API klíčem** – Přístup na základě tokenu přes hlavičku `Api-Token`
- **Ověření webhooků** – Ověřujte rozsahy zdrojových IP adres webhooků
- **Šifrování TLS** – Veškerá API komunikace šifrovaná přes HTTPS
- **Přístup na úrovni účtu** – API klíč poskytuje plný přístup k účtu; používejte opatrně
- **IP omezení** – Dostupná na plánech Enterprise

## Související zdroje

- [Dokumentace ActiveCampaign API](https://developers.activecampaign.com/reference/overview)
- [Průvodce webhooky ActiveCampaign](https://developers.activecampaign.com/page/webhooks)
- [Konektor Mailchimp](https://tajo.io/cz/docs/connectors/marketing/mailchimp)
- [Konektor Brevo](https://tajo.io/cz/docs/connectors/marketing/brevo)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)