---
title: "ActiveCampaign-kobling"
description: "Fullstendig ActiveCampaign-integrasjonsveiledning for synkronisering av kontakter, avtaler, automatiseringer og engasjementshendelser med Brevo via Tajo."
url: https://tajo.io/no/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/no/docs/connectors/marketing/activecampaign.md
lang: no-NO
robots: noindex
---

Be om tidlig tilgang

Skriv inn fornavn og e-postadresse på jobb. Vi sender deg en lenke for å bekrefte forespørselen om tilgang til Tajo.

# ActiveCampaign-kobling

Koblingsstatus: Planlagt Ikke bygget ennå. Tajo kjører ikke denne koblingen i dag.

| Kildefelt | Målfelt | Eksempelverdi |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Koble ActiveCampaign-kontoen din til Brevo via Tajo for omfattende kontaktmigrering, synkronisering av avtalepipeline, automatiseringsmapping og enhetlige markedsføringsdata på tvers av begge plattformene.

## Oversikt

| Egenskap | Verdi |
| --- | --- |
| **Plattform** | ActiveCampaign |
| **Kategori** | Markedsføring |
| **Oppsettskompleksitet** | Moderat |
| **Offisiell integrasjon** | Nei |
| **Synkroniserte data** | Kontakter, avtaler, automatiseringer, hendelser |
| **API Base URL** | `https://{account}.api-us1.com/api/3` |

## Funksjoner

- **Kontaktmigrering** - Migrer kontakter med egendefinerte felt, tagger og listemedlemskap
- **Synkronisering av avtalepipeline** - Synkroniser avtalesteg, verdier og eiere for inntektssporing
- **Automatiseringsmapping** - Mapp ActiveCampaign-automatiseringer til Brevo-arbeidsflytutløsere
- **Hendelsessporing** - Synkroniser nettstedssporing og egendefinerte hendelser for atferdssegmentering
- **Liste- og tag-synkronisering** - Replikér listestrukturer og tag-baserte segmenter i Brevo
- **E-handelsintegrasjon** - Synkroniser Deep Data (ordrer, kunder, handlekurver) til Brevo
- **Synkronisering av egendefinerte objekter** - Mapp ActiveCampaign egendefinerte objekter til Brevo-attributter
- **Score-synkronisering** - Overfør lead- og kontaktscoringer til Brevo-attributter

## Forutsetninger

Før du begynner, sørg for at du har:

1. En ActiveCampaign-konto (Lite, Plus, Professional eller Enterprise)
2. API-URL og API-nøkkel fra Settings > Developer
3. En Brevo-konto med API-tilgang
4. En Tajo-konto

## Autentisering

### API-nøkkelautentisering

ActiveCampaign bruker en API-nøkkel som sendes som en header eller en query-parameter.

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

Finn API-URL-en og -nøkkelen din i ActiveCampaign Settings > Developer.

API-URL

API-URL-en din er unik for kontoen din (f.eks. `https://yourcompany.api-us1.com`). Bruk alltid denne URL-en, ikke dashbord-URL-en.

## Konfigurasjon

### Grunnleggende oppsett

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

    # Synkroniseringsalternativer
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Listemapping til Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52
```

### Feltmapping

Mapp ActiveCampaign-felt til Brevo-kontaktattributter:

#### Standardmappinger

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Kontaktens e-post (unik identifikator) |
| `firstName` optional | string | Mappes til FIRSTNAME-attributt |
| `lastName` optional | string | Mappes til LASTNAME-attributt |
| `phone` optional | string | Mappes til SMS-attributt |
| `tags` optional | array | Kontakttagger for segmentering |
| `score` optional | integer | Kontaktens engasjementsscore |
| `deals` optional | array | Tilknyttede avtaleposter |
| `fieldValues` optional | array | Verdier for egendefinerte felt |

#### Mapping av egendefinerte felt

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

  # Engasjementsfelt
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Avtalefelt
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Egendefinerte felt
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER
```

## API-endepunkter

### Kontakter

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | List alle kontakter |
| `POST` | `/api/3/contacts` | Opprett en kontakt |
| `PUT` | `/api/3/contacts/{id}` | Oppdater en kontakt |
| `GET` | `/api/3/contacts/{id}` | Hent en kontakt |
| `POST` | `/api/3/contact/sync` | Synkroniser en kontakt (opprett eller oppdater) |
| `POST` | `/api/3/import/bulk_import` | Bulkimport av kontakter |

### Avtaler

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `GET` | `/api/3/deals` | List alle avtaler |
| `POST` | `/api/3/deals` | Opprett en avtale |
| `PUT` | `/api/3/deals/{id}` | Oppdater en avtale |
| `GET` | `/api/3/dealStages` | List alle avtalesteg |
| `GET` | `/api/3/dealPipelines` | List alle pipeliner |

### Automatiseringer

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `GET` | `/api/3/automations` | List automatiseringer |
| `GET` | `/api/3/automations/{id}` | Hent en automatisering |
| `POST` | `/api/3/contactAutomations` | Legg kontakt til automatisering |

### E-handel (Deep Data)

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Opprett en ordre |
| `GET` | `/api/3/ecomOrders` | List ordrer |
| `POST` | `/api/3/ecomCustomers` | Opprett en kunde |
| `GET` | `/api/3/ecomCustomers` | List kunder |

### Hendelsessporing

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Spor en egendefinert hendelse |
| `GET` | `/api/3/eventTrackingEvents` | List alle hendelsesnavn |
| `POST` | `/api/3/eventTrackingEvents` | Opprett et hendelsesnavn |

## Hendelser

### Kontakthendelser

| Hendelse | Utløser | Bruksområde |
| --- | --- | --- |
| `contact_add` | Ny kontakt opprettet | Velkomstflyt |
| `contact_update` | Kontaktdata endret | Attributtsynkronisering |
| `contact_tag_added` | Tagg tildelt | Segmentoppdatering |
| `contact_tag_removed` | Tagg fjernet | Segmentopprydning |

### Avtalehendelser

| Hendelse | Utløser | Bruksområde |
| --- | --- | --- |
| `deal_add` | Ny avtale opprettet | Salgsvarsling |
| `deal_update` | Avtalesteg endret | Pipeline-automatisering |
| `deal_tasktype_add` | Oppgave lagt til avtale | Aktivitetssporing |

### Automatiseringshendelser

| Hendelse | Utløser | Bruksområde |
| --- | --- | --- |
| `automation_contact_add` | Kontakt startet i automatisering | Flytsporing |
| `automation_contact_complete` | Kontakt fullførte automatisering | Utløser for neste steg |

## Kodeeksempler

### Initialiser kobling

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

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

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

### Migrer kontakter til Brevo

```javascript
// Fullstendig kontaktmigrering med egendefinerte felt og tagger
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

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

### Spor egendefinerte hendelser

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

## Ratebegrensninger

ActiveCampaign API-ratebegrensninger:

| Plan | Ratebegrensning | Detaljer |
| --- | --- | --- |
| Lite | 5 forespørsler/sekund | Per konto |
| Plus | 10 forespørsler/sekund | Per konto |
| Professional | 10 forespørsler/sekund | Per konto |
| Enterprise | 20 forespørsler/sekund | Per konto |

Ytterligere grenser:

- **Bulkimport**: 250 kontakter per batch
- **Bulkimportfrekvens**: 1 import om gangen
- **Hendelsessporing**: 2 forespørsler/sekund
- **Daglig grense**: Ingen eksplisitt daglig grense (kun rate-basert)

Håndtering av ratebegrensninger

ActiveCampaign returnerer `429 Too Many Requests` når grensene overskrides. Implementer retry-logikk med verdien fra `Retry-After`-headeren.

## Feilsøking

### Vanlige problemer

| Problem | Årsak | Løsning |
| --- | --- | --- |
| 403 Forbidden | Ugyldig API-nøkkel eller URL | Verifiser API-URL og -nøkkel i AC Settings > Developer |
| Kontakt ikke synkronisert | Håndtering av duplikat e-post | Bruk `/contact/sync`-endepunktet for upsert-atferd |
| Egendefinert felt tomt | Felt-ID-ulikhet | Mapp felt etter ID, ikke etikett (etiketter kan endres) |
| Webhook ikke mottatt | Webhook ikke konfigurert | Sett opp webhooks i AC Settings > Developer > Webhooks |
| Avtale ikke opprettet | Manglende obligatoriske felt | Sørg for at pipeline, steg og kontakt er oppgitt |

### Feilsøkingsmodus

Aktiver utvidet logging:

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

### Test tilkobling

```bash
tajo connectors test activecampaign
# ✓ API-tilkobling vellykket
# ✓ Kontakter lesbare
# ✓ Avtaler lesbare
# ✓ Automatiseringer tilgjengelig
# ✓ Hendelsessporing aktivert
```

## Beste praksis

1. **Bruk kontaktsynkroniseringsendepunktet** - Bruk `/contact/sync` for upsert-operasjoner i stedet for separate opprett/oppdater
2. **Mapp felt etter ID** - Egendefinerte felt-ID-er er stabile; etiketter kan endres
3. **Bevar listemedlemskap** - Migrer listetilordninger sammen med kontaktdata
4. **Synkroniser avtalepipeliner** - Mapp pipelinesteg for konsistent CRM-rapportering
5. **Implementer hendelsessporing** - Bruk nettstedssporing for atferdsdata i Brevo
6. **Batch-imports** - Bruk bulkimport for datasett større enn 1 000 kontakter

## Sikkerhet

- **API-nøkkelautentisering** - Token-basert tilgang via `Api-Token`-header
- **Webhook-verifisering** - Valider webhook-kildens IP-områder
- **TLS-kryptering** - All API-kommunikasjon kryptert via HTTPS
- **Tilgang på kontonivå** - API-nøkkelen gir full kontotilgang; bruk med forsiktighet
- **IP-restriksjoner** - Tilgjengelig på Enterprise-planer

## Relaterte ressurser

- [ActiveCampaign API-dokumentasjon](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign Webhook-veiledning](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp-kobling](https://tajo.io/no/docs/connectors/marketing/mailchimp)
- [Brevo-kobling](https://tajo.io/no/docs/connectors/marketing/brevo)
- [Customer Sync-ferdighet](https://tajo.io/no/docs/skills/data-sync/customer-sync)