---
title: "ActiveCampaign konektor"
description: "Kompletan vodič za ActiveCampaign integraciju za sinhronizaciju kontakata, poslova, automatizacija i događaja angažovanja sa Brevo putem Tajo."
url: https://tajo.io/sr/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/sr/docs/connectors/marketing/activecampaign.md
lang: sr-Latn-RS
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslaćemo vam vezu za potvrdu zahteva za pristup Taju.

# ActiveCampaign konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primer vrednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži svoj ActiveCampaign nalog sa Brevo putem Tajo za sveobuhvatnu migraciju kontakata, sinhronizaciju pipeline-a poslova, mapiranje automatizacija i unifikovane marketing podatke na obe platforme.

## Pregled

| Svojstvo | Vrednost |
| --- | --- |
| **Platforma** | ActiveCampaign |
| **Kategorija** | Marketing |
| **Složenost podešavanja** | Srednje |
| **Zvanična integracija** | Ne |
| **Sinhronizovani podaci** | Kontakti, Poslovi, Automatizacije, Događaji |
| **Osnovni URL API-ja** | `https://{account}.api-us1.com/api/3` |

## Karakteristike

- **Migracija kontakata** - Migracija kontakata sa prilagođenim poljima, tagovima i članstvima na listama
- **Sinhronizacija pipeline-a poslova** - Sinhronizacija faza poslova, vrednosti i vlasnika za praćenje prihoda
- **Mapiranje automatizacija** - Mapiranje ActiveCampaign automatizacija na Brevo okidače tokova rada
- **Praćenje događaja** - Sinhronizacija praćenja sajta i prilagođenih događaja za bihevioralnu segmentaciju
- **Sinhronizacija lista i tagova** - Replikacija struktura lista i segmenata zasnovanih na tagovima u Brevo
- **E-commerce integracija** - Sinhronizacija Deep Data (porudžbine, kupci, korpe) u Brevo
- **Sinhronizacija prilagođenih objekata** - Mapiranje ActiveCampaign prilagođenih objekata na Brevo atribute
- **Sinhronizacija rezultata** - Prenos rezultata potencijalnih i kontakata na Brevo atribute

## Preduslovi

Pre nego što započneš, proveri da imaš:

1. ActiveCampaign nalog (Lite, Plus, Professional ili Enterprise)
2. API URL i API ključ iz Settings > Developer
3. Brevo nalog sa API pristupom
4. Tajo nalog

## Autentifikacija

### Autentifikacija API ključem

ActiveCampaign koristi API ključ prosleđen kao header ili query parametar.

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

Pronađi API URL i ključ u ActiveCampaign Settings > Developer.

API URL

Tvoj API URL je jedinstven za tvoj nalog (npr. `https://yourcompany.api-us1.com`). Uvek koristi ovaj URL, a ne URL dashboard-a.

## Konfiguracija

### Osnovno podešavanje

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

### Mapiranje polja

Mapiranje ActiveCampaign polja na Brevo atribute kontakta:

#### Default Mappings

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Email kontakta (jedinstveni identifikator) |
| `firstName` optional | string | Mapira se na atribut FIRSTNAME |
| `lastName` optional | string | Mapira se na atribut LASTNAME |
| `phone` optional | string | Mapira se na SMS atribut |
| `tags` optional | array | Tagovi kontakta za segmentaciju |
| `score` optional | integer | Rezultat angažovanja kontakta |
| `deals` optional | array | Povezani zapisi poslova |
| `fieldValues` optional | array | Vrednosti prilagođenih polja |

#### Mapiranje prilagođenih polja

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

### Kontakti

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Listanje svih kontakata |
| `POST` | `/api/3/contacts` | Kreiranje kontakta |
| `PUT` | `/api/3/contacts/{id}` | Ažuriranje kontakta |
| `GET` | `/api/3/contacts/{id}` | Dohvatanje kontakta |
| `POST` | `/api/3/contact/sync` | Sinhronizacija kontakta (kreiranje ili ažuriranje) |
| `POST` | `/api/3/import/bulk_import` | Bulk uvoz kontakata |

### Poslovi

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Listanje svih poslova |
| `POST` | `/api/3/deals` | Kreiranje posla |
| `PUT` | `/api/3/deals/{id}` | Ažuriranje posla |
| `GET` | `/api/3/dealStages` | Listanje svih faza poslova |
| `GET` | `/api/3/dealPipelines` | Listanje svih pipeline-ova |

### Automatizacije

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Listanje automatizacija |
| `GET` | `/api/3/automations/{id}` | Dohvatanje automatizacije |
| `POST` | `/api/3/contactAutomations` | Dodavanje kontakta u automatizaciju |

### E-commerce (Deep Data)

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Kreiranje porudžbine |
| `GET` | `/api/3/ecomOrders` | Listanje porudžbina |
| `POST` | `/api/3/ecomCustomers` | Kreiranje kupca |
| `GET` | `/api/3/ecomCustomers` | Listanje kupaca |

### Praćenje događaja

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Praćenje prilagođenog događaja |
| `GET` | `/api/3/eventTrackingEvents` | Listanje svih naziva događaja |
| `POST` | `/api/3/eventTrackingEvents` | Kreiranje naziva događaja |

## Događaji

### Događaji kontakata

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `contact_add` | Kreiran novi kontakt | Tok dobrodošlice |
| `contact_update` | Podaci kontakta promenjeni | Sinhronizacija atributa |
| `contact_tag_added` | Tag dodeljen | Ažuriranje segmenta |
| `contact_tag_removed` | Tag uklonjen | Čišćenje segmenta |

### Događaji poslova

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `deal_add` | Kreiran novi posao | Obaveštenje prodaje |
| `deal_update` | Faza posla promenjena | Automatizacija pipeline-a |
| `deal_tasktype_add` | Zadatak dodat poslu | Praćenje aktivnosti |

### Događaji automatizacija

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `automation_contact_add` | Kontakt ušao u automatizaciju | Praćenje toka |
| `automation_contact_complete` | Kontakt završio automatizaciju | Okidač sledećeg koraka |

## Primeri koda

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

### Migracija kontakata u 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
// }
```

### Praćenje prilagođenih događaja

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

## Ograničenja brzine

Ograničenja brzine ActiveCampaign API-ja:

| Plan | Ograničenje brzine | Detalji |
| --- | --- | --- |
| Lite | 5 zahteva/sekundi | Po nalogu |
| Plus | 10 zahteva/sekundi | Po nalogu |
| Professional | 10 zahteva/sekundi | Po nalogu |
| Enterprise | 20 zahteva/sekundi | Po nalogu |

Dodatna ograničenja:

- **Bulk uvoz**: 250 kontakata po batch-u
- **Učestalost bulk uvoza**: 1 uvoz istovremeno
- **Praćenje događaja**: 2 zahteva/sekundi
- **Dnevni limit**: Nema eksplicitnog dnevnog limita (samo na osnovu brzine)

Obrada ograničenja brzine

ActiveCampaign vraća `429 Too Many Requests` kada se prekorače limiti. Implementiraj logiku ponovnog pokušaja sa vrednošću headera `Retry-After`.

## Rešavanje problema

### Česti problemi

| Problem | Uzrok | Rešenje |
| --- | --- | --- |
| 403 Forbidden | Nevažeći API ključ ili URL | Verifikuj API URL i ključ u AC Settings > Developer |
| Kontakt nije sinhronizovan | Obrada duplikatnih emailova | Koristi `/contact/sync` endpoint za upsert ponašanje |
| Prilagođeno polje prazno | Nepodudaranje ID-a polja | Mapiraj polja po ID-u, ne po oznaci (oznake se mogu menjati) |
| Webhook nije primljen | Webhook nije konfigurisan | Postavi webhook-ove u AC Settings > Developer > Webhooks |
| Posao nije kreiran | Nedostaju obavezna polja | Osiguraj da su pipeline, faza i kontakt navedeni |

### Debug režim

Uključi detaljno logovanje:

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

### Testiraj vezu

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

## Najbolje prakse

1. **Koristi endpoint za sinhronizaciju kontakta** - Koristi `/contact/sync` za upsert operacije umesto odvojenog kreiranja/ažuriranja
2. **Mapiraj polja po ID-u** - ID-ovi prilagođenih polja su stabilni; oznake se mogu menjati
3. **Sačuvaj članstva na listama** - Migriraj dodele lista zajedno sa podacima o kontaktima
4. **Sinhronizuj pipeline-ove poslova** - Mapiraj faze pipeline-a za konzistentno CRM izveštavanje
5. **Implementiraj praćenje događaja** - Koristi praćenje sajta za bihevioralne podatke u Brevo
6. **Batch uvoz** - Koristi bulk uvoz za skupove podataka veće od 1.000 kontakata

## Bezbednost

- **Autentifikacija API ključem** - Pristup zasnovan na tokenima putem `Api-Token` headera
- **Verifikacija webhook-ova** - Validiraj IP opsege izvora webhook-ova
- **TLS enkripcija** - Sva API komunikacija enkriptovana putem HTTPS
- **Pristup na nivou naloga** - API ključ pruža pun pristup nalogu; koristiti pažljivo
- **IP ograničenja** - Dostupno na Enterprise planovima

## Povezani resursi

- [ActiveCampaign API dokumentacija](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign Webhook vodič](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp konektor](https://tajo.io/sr/docs/connectors/marketing/mailchimp)
- [Brevo konektor](https://tajo.io/sr/docs/connectors/marketing/brevo)
- [Customer Sync veština](https://tajo.io/sr/docs/skills/data-sync/customer-sync)