---
title: "ActiveCampaign Konektor"
description: "Kompletan vodič za integraciju ActiveCampaign-a za sinkronizaciju kontakata, poslova, automatizacija i angažmanskih događaja s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/hr/docs/connectors/marketing/activecampaign.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# ActiveCampaign Konektor

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

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

Povežite svoj ActiveCampaign račun s Brevom putem Taja za sveobuhvatnu migraciju kontakata, sinkronizaciju prodajnog cjevovoda, mapiranje automatizacija i unificiranje marketinških podataka na obje platforme.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | ActiveCampaign |
| **Kategorija** | Marketing |
| **Složenost postavljanja** | Srednje |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Kontakti, Poslovi, Automatizacije, Događaji |
| **Osnovni URL API-ja** | `https://{account}.api-us1.com/api/3` |

## Značajke

- **Migracija kontakata** - Migrirajte kontakte s prilagođenim poljima, oznakama i članstvima na popisu
- **Sinkronizacija prodajnog cjevovoda** - Sinkronizirajte faze, vrijednosti i vlasnike poslova za praćenje prihoda
- **Mapiranje automatizacija** - Mapirajte ActiveCampaign automatizacije na okidače Brevo tijekova rada
- **Praćenje događaja** - Sinkronizirajte praćenje stranica i prilagođene događaje za bihevioralnu segmentaciju
- **Sinkronizacija popisa i oznaka** - Replicirajte strukture popisa i segmente temeljene na oznakama u Brevu
- **E-commerce integracija** - Sinkronizirajte Deep Data (narudžbe, klijente, košarice) s Brevom
- **Sinkronizacija prilagođenih objekata** - Mapirajte ActiveCampaign prilagođene objekte na Brevo atribute
- **Sinkronizacija bodova** - Prenesite bodove leadova i kontakata na Brevo atribute

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. ActiveCampaign račun (Lite, Plus, Professional ili Enterprise)
2. API URL i API ključ iz Postavke > Developer
3. Brevo račun s API pristupom
4. Tajo račun

## Autentifikacija

### Autentifikacija API ključem

ActiveCampaign koristi API ključ proslijeđen kao zaglavlje ili parametar upita.

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

Pronađite svoj API URL i ključ u ActiveCampaign Postavke > Developer.

API URL

Vaš API URL je jedinstven za vaš račun (npr. `https://yourcompany.api-us1.com`). Uvijek koristite ovaj URL, a ne URL nadzorne ploče.

## Konfiguracija

### Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Mapiranje popisa na Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52
```

### Mapiranje polja

Mapirajte ActiveCampaign polja na atribute kontakata u Brevu:

#### Zadana mapiranja

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | E-mail 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 atribut SMS |
| `tags` optional | array | Oznake kontakta za segmentaciju |
| `score` optional | integer | Ocjena angažmana kontakta |
| `deals` optional | array | Povezani zapisi poslova |
| `fieldValues` optional | array | Vrijednosti prilagođenih polja |

#### Mapiranje prilagođenih polja

```yaml
field_mapping:
  # Standardna polja
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Polja angažmana
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Polja poslova
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Prilagođena polja
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER
```

## API krajnje točke

### Kontakti

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Popis svih kontakata |
| `POST` | `/api/3/contacts` | Stvaranje kontakta |
| `PUT` | `/api/3/contacts/{id}` | Ažuriranje kontakta |
| `GET` | `/api/3/contacts/{id}` | Dohvaćanje kontakta |
| `POST` | `/api/3/contact/sync` | Sinkronizacija kontakta (stvaranje ili ažuriranje) |
| `POST` | `/api/3/import/bulk_import` | Skupni uvoz kontakata |

### Poslovi

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Popis svih poslova |
| `POST` | `/api/3/deals` | Stvaranje posla |
| `PUT` | `/api/3/deals/{id}` | Ažuriranje posla |
| `GET` | `/api/3/dealStages` | Popis svih faza poslova |
| `GET` | `/api/3/dealPipelines` | Popis svih cjevovoda |

### Automatizacije

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Popis automatizacija |
| `GET` | `/api/3/automations/{id}` | Dohvaćanje automatizacije |
| `POST` | `/api/3/contactAutomations` | Dodavanje kontakta u automatizaciju |

### E-commerce (Deep Data)

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Stvaranje narudžbe |
| `GET` | `/api/3/ecomOrders` | Popis narudžbi |
| `POST` | `/api/3/ecomCustomers` | Stvaranje klijenta |
| `GET` | `/api/3/ecomCustomers` | Popis klijenata |

### Praćenje događaja

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Praćenje prilagođenog događaja |
| `GET` | `/api/3/eventTrackingEvents` | Popis svih naziva događaja |
| `POST` | `/api/3/eventTrackingEvents` | Stvaranje naziva događaja |

## Događaji

### Događaji kontakata

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `contact_add` | Stvoren novi kontakt | Tok dobrodošlice |
| `contact_update` | Promijenjeni podaci kontakta | Sinkronizacija atributa |
| `contact_tag_added` | Dodijeljena oznaka | Ažuriranje segmenta |
| `contact_tag_removed` | Uklonjena oznaka | Čišćenje segmenta |

### Događaji poslova

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `deal_add` | Stvoren novi posao | Obavijest prodaji |
| `deal_update` | Promijenjena faza posla | Automatizacija cjevovoda |
| `deal_tasktype_add` | Zadatak dodan 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č sljedećeg koraka |

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

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

### Migracija kontakata u Brevo

```javascript
// Potpuna migracija kontakata s prilagođenim poljima i oznakama
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Provjera statusa sinkronizacije
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
// Prosljeđivanje ActiveCampaign događaja u Brevo
await tajo.activecampaign.trackEvent({
  email: 'customer@example.com',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});
```

## Ograničenja brzine

Ograničenja ActiveCampaign API-ja:

| Plan | Ograničenje brzine | Detalji |
| --- | --- | --- |
| Lite | 5 zahtjeva/sekundi | Po računu |
| Plus | 10 zahtjeva/sekundi | Po računu |
| Professional | 10 zahtjeva/sekundi | Po računu |
| Enterprise | 20 zahtjeva/sekundi | Po računu |

Dodatna ograničenja:

- **Skupni uvoz**: 250 kontakata po seriji
- **Učestalost skupnog uvoza**: 1 uvoz istovremeno
- **Praćenje događaja**: 2 zahtjeva/sekundi
- **Dnevno ograničenje**: Nema eksplicitnog dnevnog ograničenja (samo ograničenje brzine)

Rukovanje ograničenjima brzine

ActiveCampaign vraća `429 Too Many Requests` kada su prekoračena ograničenja. Implementirajte logiku ponovnog pokušaja s vrijednošću zaglavlja `Retry-After`.

## Rješavanje problema

### Uobičajeni problemi

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| 403 Forbidden | Nevažeći API ključ ili URL | Provjerite API URL i ključ u AC Postavke > Developer |
| Kontakt nije sinkroniziran | Rukovanje duplikatima e-pošte | Koristite krajnju točku `/contact/sync` za upsert ponašanje |
| Prilagođeno polje je prazno | Nepodudaranje ID-a polja | Mapirajte polja po ID-u, ne po oznaci (oznake se mogu promijeniti) |
| Webhook nije primljen | Webhook nije konfiguriran | Postavite webhooks u AC Postavke > Developer > Webhooks |
| Posao nije stvoren | Nedostaju obavezna polja | Osigurajte da su navedeni cjevovod, faza i kontakt |

### Način otklanjanja grešaka

Omogućite opširno zapisivanje:

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

### Testiranje veze

```bash
tajo connectors test activecampaign
# ✓ API veza uspješna
# ✓ Kontakti čitljivi
# ✓ Poslovi čitljivi
# ✓ Automatizacije dostupne
# ✓ Praćenje događaja omogućeno
```

## Preporučene prakse

1. **Koristite krajnju točku za sinkronizaciju kontakata** - Koristite `/contact/sync` za upsert operacije umjesto zasebnog stvaranja/ažuriranja
2. **Mapirajte polja po ID-u** - ID-ovi prilagođenih polja su stabilni; oznake se mogu promijeniti
3. **Sačuvajte članstva na popisima** - Migrirajte dodjele popisa zajedno s podacima kontakata
4. **Sinkronizirajte prodajne cjevovode** - Mapirajte faze cjevovoda za dosljedno CRM izvješćivanje
5. **Implementirajte praćenje događaja** - Koristite praćenje stranica za bihevioralne podatke u Brevu
6. **Skupni uvozi** - Koristite skupni uvoz za skupove podataka veće od 1.000 kontakata

## Sigurnost

- **Autentifikacija API ključem** - Pristup temeljen na tokenima putem zaglavlja `Api-Token`
- **Verifikacija webhookova** - Provjerite IP raspone izvora webhookova
- **TLS enkripcija** - Sva API komunikacija šifrirana putem HTTPS-a
- **Pristup na razini računa** - API ključ pruža potpuni pristup računu; koristite s oprezom
- **IP ograničenja** - Dostupno na Enterprise planovima

## Povezani resursi

- [ActiveCampaign API dokumentacija](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign vodič za Webhooks](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp Konektor](https://tajo.io/hr/docs/connectors/marketing/mailchimp)
- [Brevo Konektor](https://tajo.io/hr/docs/connectors/marketing/brevo)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)