---
title: "ActiveCampaign-koppling"
description: "Komplett integrationsguide för ActiveCampaign för att synka kontakter, affärer, automationer och engagemangshändelser med Brevo via Tajo."
url: https://tajo.io/se/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/se/docs/connectors/marketing/activecampaign.md
lang: sv-SE
robots: noindex
---

Ansök om tidig åtkomst

Ange ditt förnamn och din e-postadress på jobbet. Vi skickar en länk för att bekräfta din begäran om åtkomst till Tajo.

# ActiveCampaign-koppling

Kopplingens status: Planerad Inte byggd än. Tajo kör inte den här kopplingen i dag.

| Källfält | Målfält | Exempelvärde |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Anslut ditt ActiveCampaign-konto till Brevo via Tajo för omfattande migrering av kontakter, synkronisering av affärspipeline, mappning av automationer och enhetlig marknadsföringsdata över båda plattformarna.

## Översikt

| Egenskap | Värde |
| --- | --- |
| **Plattform** | ActiveCampaign |
| **Kategori** | Marknadsföring |
| **Installationskomplexitet** | Medel |
| **Officiell integration** | Nej |
| **Data som synkas** | Kontakter, affärer, automationer, händelser |
| **Bas-URL för API** | `https://{account}.api-us1.com/api/3` |

## Funktioner

- **Kontaktmigrering** - Migrera kontakter med anpassade fält, taggar och listmedlemskap
- **Synk av affärspipeline** - Synka affärsstadier, värden och ägare för intäktsspårning
- **Mappning av automationer** - Mappa ActiveCampaign-automationer till triggers i Brevo-flöden
- **Händelsespårning** - Synka webbplatsspårning och anpassade händelser för beteendebaserad segmentering
- **List- och taggsynk** - Replikera liststrukturer och taggbaserade segment i Brevo
- **E-handelsintegration** - Synka Deep Data (ordrar, kunder, kundvagnar) till Brevo
- **Synk av anpassade objekt** - Mappa ActiveCampaigns anpassade objekt till Brevo-attribut
- **Poängsynk** - Överför lead- och kontaktpoäng till Brevo-attribut

## Förutsättningar

Innan du börjar, se till att du har:

1. Ett ActiveCampaign-konto (Lite, Plus, Professional eller Enterprise)
2. API-URL och API-nyckel från Settings > Developer
3. Ett Brevo-konto med API-åtkomst
4. Ett Tajo-konto

## Autentisering

### API-nyckelautentisering

ActiveCampaign använder en API-nyckel som skickas som header eller query-parameter.

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

Hitta din API-URL och nyckel under ActiveCampaign Settings > Developer.

API-URL

Din API-URL är unik för ditt konto (t.ex. `https://yourcompany.api-us1.com`). Använd alltid denna URL, inte dashboard-URL:en.

## Konfiguration

### Grundläggande konfiguration

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

### Fältmappning

Mappa ActiveCampaign-fält till Brevo-kontaktattribut:

#### Standardmappningar

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Kontaktens e-post (unik identifierare) |
| `firstName` optional | string | Mappas till attributet FIRSTNAME |
| `lastName` optional | string | Mappas till attributet LASTNAME |
| `phone` optional | string | Mappas till SMS-attributet |
| `tags` optional | array | Kontakttaggar för segmentering |
| `score` optional | integer | Engagemangspoäng för kontakten |
| `deals` optional | array | Kopplade affärsposter |
| `fieldValues` optional | array | Värden för anpassade fält |

#### Anpassad fältmappning

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

### Kontakter

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Lista alla kontakter |
| `POST` | `/api/3/contacts` | Skapa en kontakt |
| `PUT` | `/api/3/contacts/{id}` | Uppdatera en kontakt |
| `GET` | `/api/3/contacts/{id}` | Hämta en kontakt |
| `POST` | `/api/3/contact/sync` | Synka en kontakt (skapa eller uppdatera) |
| `POST` | `/api/3/import/bulk_import` | Bulkimportera kontakter |

### Affärer

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Lista alla affärer |
| `POST` | `/api/3/deals` | Skapa en affär |
| `PUT` | `/api/3/deals/{id}` | Uppdatera en affär |
| `GET` | `/api/3/dealStages` | Lista alla affärsstadier |
| `GET` | `/api/3/dealPipelines` | Lista alla pipelines |

### Automationer

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Lista automationer |
| `GET` | `/api/3/automations/{id}` | Hämta en automation |
| `POST` | `/api/3/contactAutomations` | Lägg till kontakt i automation |

### E-handel (Deep Data)

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Skapa en order |
| `GET` | `/api/3/ecomOrders` | Lista ordrar |
| `POST` | `/api/3/ecomCustomers` | Skapa en kund |
| `GET` | `/api/3/ecomCustomers` | Lista kunder |

### Händelsespårning

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Spåra en anpassad händelse |
| `GET` | `/api/3/eventTrackingEvents` | Lista alla händelsenamn |
| `POST` | `/api/3/eventTrackingEvents` | Skapa ett händelsenamn |

## Händelser

### Kontakthändelser

| Händelse | Utlösare | Användningsfall |
| --- | --- | --- |
| `contact_add` | Ny kontakt skapad | Välkomstflöde |
| `contact_update` | Kontaktdata ändrad | Attributsynk |
| `contact_tag_added` | Tagg tilldelad | Segmentuppdatering |
| `contact_tag_removed` | Tagg borttagen | Segmentrensning |

### Affärshändelser

| Händelse | Utlösare | Användningsfall |
| --- | --- | --- |
| `deal_add` | Ny affär skapad | Säljnotifiering |
| `deal_update` | Affärsstadiet ändrat | Pipelineautomation |
| `deal_tasktype_add` | Uppgift tillagd i affär | Aktivitetsspårning |

### Automationshändelser

| Händelse | Utlösare | Användningsfall |
| --- | --- | --- |
| `automation_contact_add` | Kontakt gick in i automation | Flödesspårning |
| `automation_contact_complete` | Kontakt slutförde automation | Utlösare för nästa steg |

## Kodexempel

### Initiera kopplingen

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

### Migrera kontakter till 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
// }
```

### Spåra anpassade händelser

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

## API-gränser

Rate limits för ActiveCampaign API:

| Plan | Rate limit | Detaljer |
| --- | --- | --- |
| Lite | 5 förfrågningar/sekund | Per konto |
| Plus | 10 förfrågningar/sekund | Per konto |
| Professional | 10 förfrågningar/sekund | Per konto |
| Enterprise | 20 förfrågningar/sekund | Per konto |

Ytterligare gränser:

- **Bulkimport**: 250 kontakter per batch
- **Frekvens för bulkimport**: 1 import i taget
- **Händelsespårning**: 2 förfrågningar/sekund
- **Daglig gräns**: Ingen explicit daglig gräns (endast ratebaserad)

Hantering av rate limits

ActiveCampaign returnerar `429 Too Many Requests` när gränserna överskrids. Implementera retry-logik baserat på värdet i `Retry-After`-headern.

## Felsökning

### Vanliga problem

| Problem | Orsak | Lösning |
| --- | --- | --- |
| 403 Forbidden | Ogiltig API-nyckel eller URL | Verifiera API-URL och nyckel i AC Settings > Developer |
| Kontakten synkas inte | Hantering av duplicerade e-postadresser | Använd ändpunkten `/contact/sync` för upsert-beteende |
| Anpassat fält tomt | Fält-ID-missmatch | Mappa fält efter ID, inte etikett (etiketter kan ändras) |
| Webhook tas inte emot | Webhook inte konfigurerad | Ställ in webhooks i AC Settings > Developer > Webhooks |
| Affären skapas inte | Obligatoriska fält saknas | Se till att pipeline, stadium och kontakt anges |

### Debug-läge

Aktivera utförlig loggning:

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

### Testa anslutningen

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

## Bästa praxis

1. **Använd ändpunkten contact sync** - Använd `/contact/sync` för upsert-operationer istället för separat skapa/uppdatera
2. **Mappa fält efter ID** - ID:n för anpassade fält är stabila; etiketter kan ändras
3. **Bevara listmedlemskap** - Migrera listtilldelningar tillsammans med kontaktdatan
4. **Synka affärspipelines** - Mappa pipeline-stadier för konsekvent CRM-rapportering
5. **Implementera händelsespårning** - Använd webbplatsspårning för beteendedata i Brevo
6. **Batcha importer** - Använd bulkimport för datamängder större än 1 000 kontakter

## Säkerhet

- **API-nyckelautentisering** - Tokenbaserad åtkomst via `Api-Token`-headern
- **Webhook-verifiering** - Validera webhook-källans IP-intervall
- **TLS-kryptering** - All API-kommunikation krypteras via HTTPS
- **Åtkomst på kontonivå** - API-nyckeln ger fullständig kontoåtkomst; använd med försiktighet
- **IP-begränsningar** - Tillgängligt på Enterprise-planer

## Relaterade resurser

- [ActiveCampaign API-dokumentation](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign Webhook-guide](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp-koppling](https://tajo.io/se/docs/connectors/marketing/mailchimp)
- [Brevo-koppling](https://tajo.io/se/docs/connectors/marketing/brevo)
- [Skill för kundsynk](https://tajo.io/se/docs/skills/data-sync/customer-sync)