---
title: "ActiveCampaign konnektor"
description: "Teljes ActiveCampaign integrációs útmutató kapcsolatok, üzletek, automatizálások és elköteleződési események Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/hu/docs/connectors/marketing/activecampaign.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# ActiveCampaign konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd az ActiveCampaign fiókodat a Brevóhoz a Tajo segítségével átfogó kapcsolat-migrációhoz, üzleti csővezeték-szinkronizáláshoz, automatizálás-leképezéshez és egységesített marketingadatokhoz mindkét platformon.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | ActiveCampaign |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Kapcsolatok, Üzletek, Automatizálások, Események |
| **API alap URL** | `https://{account}.api-us1.com/api/3` |

## Funkciók

- **Kapcsolat-migráció** – Kapcsolatok migrálása egyéni mezőkkel, címkékkel és listatagságokkal
- **Üzleti csővezeték-szinkronizáció** – Üzleti szakaszok, értékek és tulajdonosok szinkronizálása bevételkövetéshez
- **Automatizálás-leképezés** – ActiveCampaign automatizálások leképezése Brevo munkafolyamat-kiváltókhoz
- **Esemény-követés** – Webhelykövető és egyéni események szinkronizálása viselkedési szegmentáláshoz
- **Lista és címke szinkronizáció** – Listastruktúrák és címke alapú szegmensek másolása a Brevóba
- **E-kereskedelmi integráció** – Deep Data (rendelések, ügyfelek, kosarak) szinkronizálása a Brevóba
- **Egyéni objektum szinkronizáció** – ActiveCampaign egyéni objektumok leképezése Brevo attribútumokhoz
- **Pontszám szinkronizáció** – Lead és kapcsolat pontszámok átadása Brevo attribútumokhoz

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy ActiveCampaign fiókkal (Lite, Plus, Professional vagy Enterprise)
2. API URL-lel és API kulccsal a Beállítások > Fejlesztő menüből
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal

## Hitelesítés

### API kulcs hitelesítés

Az ActiveCampaign API kulcsot fejlécként vagy lekérdezési paraméterként ad meg.

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

Az API URL-t és kulcsot az ActiveCampaign Beállítások > Fejlesztő menüben találod.

API URL

Az API URL egyedi a fiókodhoz (pl. `https://yourcompany.api-us1.com`). Mindig ezt az URL-t használd, ne a dashboard URL-t.

## Konfiguráció

### Alapbeállítás

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

### Mezőleképezés

Képezd le az ActiveCampaign mezőket Brevo kapcsolat-attribútumokhoz:

#### Default Mappings

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Contact email (unique identifier) |
| `firstName` optional | string | Maps to FIRSTNAME attribute |
| `lastName` optional | string | Maps to LASTNAME attribute |
| `phone` optional | string | Maps to SMS attribute |
| `tags` optional | array | Contact tags for segmentation |
| `score` optional | integer | Contact engagement score |
| `deals` optional | array | Associated deal records |
| `fieldValues` optional | array | Custom field values |

#### Egyéni mezőleképezés

```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 végpontok

### Kapcsolatok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Összes kapcsolat listázása |
| `POST` | `/api/3/contacts` | Kapcsolat létrehozása |
| `PUT` | `/api/3/contacts/{id}` | Kapcsolat frissítése |
| `GET` | `/api/3/contacts/{id}` | Kapcsolat lekérése |
| `POST` | `/api/3/contact/sync` | Kapcsolat szinkronizálása (létrehozás vagy frissítés) |
| `POST` | `/api/3/import/bulk_import` | Kapcsolatok tömeges importálása |

### Üzletek

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Összes üzlet listázása |
| `POST` | `/api/3/deals` | Üzlet létrehozása |
| `PUT` | `/api/3/deals/{id}` | Üzlet frissítése |
| `GET` | `/api/3/dealStages` | Összes üzleti szakasz listázása |
| `GET` | `/api/3/dealPipelines` | Összes csővezeték listázása |

### Automatizálások

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Automatizálások listázása |
| `GET` | `/api/3/automations/{id}` | Automatizálás lekérése |
| `POST` | `/api/3/contactAutomations` | Kapcsolat hozzáadása automatizáláshoz |

### E-kereskedelem (Deep Data)

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Rendelés létrehozása |
| `GET` | `/api/3/ecomOrders` | Rendelések listázása |
| `POST` | `/api/3/ecomCustomers` | Ügyfél létrehozása |
| `GET` | `/api/3/ecomCustomers` | Ügyfelek listázása |

### Esemény-követés

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Egyéni esemény követése |
| `GET` | `/api/3/eventTrackingEvents` | Összes eseménynév listázása |
| `POST` | `/api/3/eventTrackingEvents` | Eseménynév létrehozása |

## Események

### Kapcsolat-események

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `contact_add` | Új kapcsolat létrehozva | Üdvözlő munkafolyamat |
| `contact_update` | Kapcsolat adatai megváltoztak | Attribútum-szinkronizáció |
| `contact_tag_added` | Címke hozzárendelve | Szegmens frissítés |
| `contact_tag_removed` | Címke eltávolítva | Szegmens tisztítás |

### Üzleti események

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `deal_add` | Új üzlet létrehozva | Értékesítési értesítés |
| `deal_update` | Üzleti szakasz megváltozott | Csővezeték-automatizálás |
| `deal_tasktype_add` | Feladat hozzáadva az üzlethez | Aktivitás-követés |

### Automatizálási események

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `automation_contact_add` | Kapcsolat belépett automatizálásba | Munkafolyamat-követés |
| `automation_contact_complete` | Kapcsolat befejezte az automatizálást | Következő-lépés kiváltó |

## Kódpéldák

### A konnektor inicializálása

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

### Kapcsolatok migrálása a Brevóba

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

### Egyéni események követése

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

## Ráta-korlátok

Az ActiveCampaign API ráta-korlátjai:

| Csomag | Ráta-korlát | Részletek |
| --- | --- | --- |
| Lite | 5 kérés/másodperc | Fiókonként |
| Plus | 10 kérés/másodperc | Fiókonként |
| Professional | 10 kérés/másodperc | Fiókonként |
| Enterprise | 20 kérés/másodperc | Fiókonként |

További korlátok:

- **Tömeges importálás**: 250 kapcsolat kötegenkénr
- **Tömeges importálás gyakorisága**: Egyszerre 1 importálás
- **Esemény-követés**: 2 kérés/másodperc
- **Napi korlát**: Nincs explicit napi korlát (csak ráta alapú)

Ráta-korlát kezelés

Az ActiveCampaign `429 Too Many Requests` választ ad vissza, ha a korlátok túllépésre kerülnek. Implementálj újrapróbálkozási logikát a `Retry-After` fejléc értékével.

## Hibaelhárítás

### Gyakori problémák

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 403 Forbidden | Érvénytelen API kulcs vagy URL | Ellenőrizd az API URL-t és kulcsot az AC Beállítások > Fejlesztő menüben |
| Kapcsolat nincs szinkronizálva | Duplikált e-mail kezelés | Használd a `/contact/sync` végpontot upsert viselkedéshez |
| Egyéni mező üres | Mező azonosító eltérés | Mezők leképezése azonosítóval, nem felirattal (a feliratok változhatnak) |
| Webhook nem érkezett | Webhook nincs konfigurálva | Állíts be webhookokat az AC Beállítások > Fejlesztő > Webhookok menüben |
| Üzlet nem jött létre | Hiányzó kötelező mezők | Győződj meg róla, hogy csővezeték, szakasz és kapcsolat meg van adva |

### Hibakeresési mód

Engedélyezd a részletes naplózást:

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

### Kapcsolat tesztelése

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

## Legjobb gyakorlatok

1. **Használd a kapcsolat-szinkronizáló végpontot** – A `/contact/sync`-et használd upsert műveletekhez külön létrehozás/frissítés helyett
2. **Mezők leképezése azonosítóval** – Az egyéni mező azonosítók stabilak; a feliratok változhatnak
3. **Őrizd meg a listatagságokat** – A listahozzárendeléseket a kapcsolat-adatokkal együtt migráld
4. **Szinkronizálj üzleti csővezetékeket** – Képezd le a csővezeték-szakaszokat a konzisztens CRM riportoláshoz
5. **Implementálj esemény-követést** – Használj webhely-követést viselkedési adatokhoz a Brevóban
6. **Kötegelj importálásokat** – Használj tömeges importálást 1 000 kapcsolatnál nagyobb adatkészletekhez

## Biztonság

- **API kulcs hitelesítés** – Token alapú hozzáférés `Api-Token` fejléccen keresztül
- **Webhook-ellenőrzés** – Webhook forrás IP-tartományok validálása
- **TLS titkosítás** – Minden API kommunikáció HTTPS-en keresztül titkosítva
- **Fiók szintű hozzáférés** – Az API kulcs teljes fiók-hozzáférést biztosít; körültekintően használd
- **IP korlátozások** – Enterprise csomagokon elérhető

## Kapcsolódó források

- [ActiveCampaign API dokumentáció](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign Webhook útmutató](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp konnektor](https://tajo.io/hu/docs/connectors/marketing/mailchimp)
- [Brevo konnektor](https://tajo.io/hu/docs/connectors/marketing/brevo)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)