---
title: "ActiveCampaign Connector"
description: "Popoln vodnik za integracijo ActiveCampaign za sinhronizacijo stikov, poslov, avtomatizacij in angažirnih dogodkov z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/sl/docs/connectors/marketing/activecampaign.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# ActiveCampaign Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži račun ActiveCampaign z Brevo prek Tajo za celovito migracijo stikov, sinhronizacijo prodajnega cevovoda, preslikavo avtomatizacij in poenotenje marketinških podatkov na obeh platformah.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | ActiveCampaign |
| **Kategorija** | Marketing |
| **Zahtevnost nastavitve** | Srednja |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Stiki, posli, avtomatizacije, dogodki |
| **Osnovni URL API** | `https://{account}.api-us1.com/api/3` |

## Funkcionalnosti

- **Migracija stikov** – prenesi stike s polji po meri, oznakami in članstvami v seznamih
- **Sinhronizacija prodajnega cevovoda** – sinhroniziraj faze poslov, vrednosti in lastnike za sledenje prihodkov
- **Preslikava avtomatizacij** – preslikaj avtomatizacije ActiveCampaign v sprožilce delovnih tokov Brevo
- **Sledenje dogodkom** – sinhroniziraj sledenje spletnim mestom in dogodke po meri za vedenjsko segmentacijo
- **Sinhronizacija seznamov in oznak** – replicira strukture seznamov in segmente na osnovi oznak v Brevo
- **Integracija e-trgovine** – sinhroniziraj podatke Deep Data (naročila, stranke, košarice) v Brevo
- **Sinhronizacija predmetov po meri** – preslikaj predmete po meri ActiveCampaign v atribute Brevo
- **Sinhronizacija točk** – prenesi točke potencialnih strank in stikov v atribute Brevo

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun ActiveCampaign (Lite, Plus, Professional ali Enterprise)
2. URL API in ključ API iz Settings > Developer
3. Brevo račun z dostopom do API
4. Tajo račun

## Avtentikacija

### Avtentikacija z API ključem

ActiveCampaign uporablja ključ API, ki se posreduje kot glava ali parameter poizvedbe.

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

Najdi URL API in ključ v ActiveCampaign Settings > Developer.

URL API

Tvoj URL API je enoličen za tvoj račun (npr. `https://yourcompany.api-us1.com`). Vedno uporabi ta URL, ne URL-ja nadzorne plošče.

## Konfiguracija

### Osnovna nastavitev

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

### Preslikava polj

Preslikaj polja ActiveCampaign v atribute stikov Brevo:

#### Privzete preslikave

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | E-mail stika (enolični identifikator) |
| `firstName` optional | string | Preslika se v atribut FIRSTNAME |
| `lastName` optional | string | Preslika se v atribut LASTNAME |
| `phone` optional | string | Preslika se v atribut SMS |
| `tags` optional | array | Oznake stika za segmentacijo |
| `score` optional | integer | Ocena angažiranosti stika |
| `deals` optional | array | Povezani zapisi poslov |
| `fieldValues` optional | array | Vrednosti polj po meri |

#### Preslikava polj po meri

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

## Končne točke API

### Stiki

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Seznam vseh stikov |
| `POST` | `/api/3/contacts` | Ustvarjanje stika |
| `PUT` | `/api/3/contacts/{id}` | Posodabljanje stika |
| `GET` | `/api/3/contacts/{id}` | Pridobi stik |
| `POST` | `/api/3/contact/sync` | Sinhronizacija stika (ustvari ali posodobi) |
| `POST` | `/api/3/import/bulk_import` | Množičen uvoz stikov |

### Posli

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Seznam vseh poslov |
| `POST` | `/api/3/deals` | Ustvarjanje posla |
| `PUT` | `/api/3/deals/{id}` | Posodabljanje posla |
| `GET` | `/api/3/dealStages` | Seznam vseh faz poslov |
| `GET` | `/api/3/dealPipelines` | Seznam vseh cevovodov |

### Avtomatizacije

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Seznam avtomatizacij |
| `GET` | `/api/3/automations/{id}` | Pridobi avtomatizacijo |
| `POST` | `/api/3/contactAutomations` | Dodaj stik v avtomatizacijo |

### E-trgovina (Deep Data)

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Ustvarjanje naročila |
| `GET` | `/api/3/ecomOrders` | Seznam naročil |
| `POST` | `/api/3/ecomCustomers` | Ustvarjanje stranke |
| `GET` | `/api/3/ecomCustomers` | Seznam strank |

### Sledenje dogodkom

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Sledenje dogodku po meri |
| `GET` | `/api/3/eventTrackingEvents` | Seznam vseh imen dogodkov |
| `POST` | `/api/3/eventTrackingEvents` | Ustvarjanje imena dogodka |

## Dogodki

### Dogodki stikov

| Dogodek | Sprožilec | Primer uporabe |
| --- | --- | --- |
| `contact_add` | Ustvarjen nov stik | Pozdravni tok |
| `contact_update` | Sprememba podatkov stika | Sinhronizacija atributov |
| `contact_tag_added` | Dodeljena oznaka | Posodobitev segmenta |
| `contact_tag_removed` | Odstranjena oznaka | Čiščenje segmenta |

### Dogodki poslov

| Dogodek | Sprožilec | Primer uporabe |
| --- | --- | --- |
| `deal_add` | Ustvarjen nov posel | Obvestilo o prodaji |
| `deal_update` | Sprememba faze posla | Avtomatizacija cevovoda |
| `deal_tasktype_add` | Naloga dodana poslu | Sledenje dejavnosti |

### Dogodki avtomatizacij

| Dogodek | Sprožilec | Primer uporabe |
| --- | --- | --- |
| `automation_contact_add` | Stik vstopil v avtomatizacijo | Sledenje toku |
| `automation_contact_complete` | Stik zaključil avtomatizacijo | Sprožilec naslednjega koraka |

## Primeri kode

### Inicializacija konektorja

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

### Sledenje dogodkom po meri

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

## Omejitve hitrosti

Omejitve hitrosti API za ActiveCampaign:

| Plan | Omejitev hitrosti | Podrobnosti |
| --- | --- | --- |
| Lite | 5 zahtevkov/sekundo | Na račun |
| Plus | 10 zahtevkov/sekundo | Na račun |
| Professional | 10 zahtevkov/sekundo | Na račun |
| Enterprise | 20 zahtevkov/sekundo | Na račun |

Dodatne omejitve:

- **Množičen uvoz**: 250 stikov na paket
- **Pogostost množičnega uvoza**: 1 uvoz naenkrat
- **Sledenje dogodkom**: 2 zahtevka/sekundo
- **Dnevna omejitev**: Ni izrecne dnevne omejitve (samo omejitev hitrosti)

Obravnava omejitev hitrosti

ActiveCampaign vrne `429 Too Many Requests`, ko so omejitve prekoračene. Implementiraj logiko ponovnih poskusov z vrednostjo glave `Retry-After`.

## Odpravljanje težav

### Pogoste težave

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| 403 Forbidden | Neveljaven API ključ ali URL | Preveri URL API in ključ v AC Settings > Developer |
| Stik ni sinhroniziran | Obravnava podvojenega e-maila | Za vedenje upsert uporabi končno točko `/contact/sync` |
| Polje po meri prazno | Neujemanje ID polja | Preslikaj polja po ID-ju, ne po oznaki (oznake se lahko spremenijo) |
| Webhook ni prejet | Webhook ni konfiguriran | Nastavi webhooks v AC Settings > Developer > Webhooks |
| Posel ni ustvarjen | Manjkajoča obvezna polja | Zagotovi, da so cevovod, faza in stik podani |

### Način odpravljanja napak

Omogoči podrobno beleženje:

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

### Preizkus povezave

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

## Najboljše prakse

1. **Uporabi končno točko sinhronizacije stikov** – za operacije upsert namesto ločenega ustvarjanja/posodabljanja uporabi `/contact/sync`
2. **Preslikuj polja po ID-ju** – ID-ji polj po meri so stabilni; oznake se lahko spremenijo
3. **Ohrani članstva v seznamih** – skupaj s podatki stikov prenesi dodelitve seznamov
4. **Sinhroniziraj prodajne cevovode** – za dosledno poročanje CRM preslikaj faze cevovoda
5. **Implementiraj sledenje dogodkov** – za vedenjske podatke v Brevo uporabi sledenje spletnim mestom
6. **Paketni uvozi** – za nabore podatkov večje od 1.000 stikov uporabi množičen uvoz

## Varnost

- **Avtentikacija z API ključem** – dostop na osnovi žetonov prek glave `Api-Token`
- **Preverjanje webhooks** – preverjanje izvornih IP obsegov webhooks
- **TLS šifriranje** – vsa komunikacija API šifrirana prek HTTPS
- **Dostop na ravni računa** – API ključ zagotavlja popoln dostop do računa; ravnaj previdno
- **Omejitve IP** – na voljo pri planih Enterprise

## Povezani viri

- [ActiveCampaign API dokumentacija](https://developers.activecampaign.com/reference/overview)
- [Vodnik za webhook ActiveCampaign](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp Connector](https://tajo.io/sl/docs/connectors/marketing/mailchimp)
- [Brevo Connector](https://tajo.io/sl/docs/connectors/marketing/brevo)
- [Customer Sync Skill](https://tajo.io/sl/docs/skills/data-sync/customer-sync)