---
title: "Conector ActiveCampaign"
description: "Ghid complet de integrare ActiveCampaign pentru sincronizarea contactelor, ofertelor, automatizărilor și evenimentelor de implicare cu Brevo prin Tajo."
url: https://tajo.io/ro/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/ro/docs/connectors/marketing/activecampaign.md
lang: ro-RO
robots: noindex
---

Solicită acces anticipat

Introduceți prenumele și adresa de e-mail profesională. Vă vom trimite un link pentru a confirma cererea de acces la Tajo.

# Conector ActiveCampaign

Starea conectorului: Planificat Încă neconstruit. Tajo nu rulează astăzi acest conector.

| Câmp sursă | Câmp destinație | Valoare exemplu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conectați contul ActiveCampaign la Brevo prin Tajo pentru migrarea completă a contactelor, sincronizarea pipeline-ului de oferte, maparea automatizărilor și date de marketing unificate pe ambele platforme.

## Prezentare generală

| Proprietate | Valoare |
| --- | --- |
| **Platformă** | ActiveCampaign |
| **Categorie** | Marketing |
| **Complexitate configurare** | Medie |
| **Integrare oficială** | Nu |
| **Date sincronizate** | Contacte, Oferte, Automatizări, Evenimente |
| **URL de bază API** | `https://{account}.api-us1.com/api/3` |

## Funcționalități

- **Migrare contacte** - Migrați contacte cu câmpuri personalizate, etichete și apartenența la liste
- **Sincronizare pipeline oferte** - Sincronizați etapele ofertelor, valorile și proprietarii pentru urmărirea veniturilor
- **Mapare automatizări** - Mapați automatizările ActiveCampaign la declanșatoarele de flux de lucru Brevo
- **Urmărire evenimente** - Sincronizați urmărirea site-ului și evenimentele personalizate pentru segmentare comportamentală
- **Sincronizare liste și etichete** - Replicați structurile listelor și segmentele bazate pe etichete în Brevo
- **Integrare e-commerce** - Sincronizați Deep Data (comenzi, clienți, coșuri) la Brevo
- **Sincronizare obiecte personalizate** - Mapați obiectele personalizate ActiveCampaign la atributele Brevo
- **Sincronizare scoruri** - Transferați scorurile de lead și contact la atributele Brevo

## Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont ActiveCampaign (Lite, Plus, Professional sau Enterprise)
2. URL API și cheie API din Settings > Developer
3. Un cont Brevo cu acces API
4. Un cont Tajo

## Autentificare

### Autentificare cu cheie API

ActiveCampaign utilizează o cheie API transmisă ca antet sau parametru de interogare.

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

Găsiți URL-ul API și cheia în ActiveCampaign Settings > Developer.

URL API

URL-ul dvs. API este unic pentru contul dvs. (ex: `https://yourcompany.api-us1.com`). Utilizați întotdeauna acest URL, nu URL-ul tabloului de bord.

## Configurare

### Configurare de bază

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

### Mapare câmpuri

Mapați câmpurile ActiveCampaign la atributele de contact Brevo:

#### Mapări implicite

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | E-mailul contactului (identificator unic) |
| `firstName` optional | string | Mapează la atributul FIRSTNAME |
| `lastName` optional | string | Mapează la atributul LASTNAME |
| `phone` optional | string | Mapează la atributul SMS |
| `tags` optional | array | Etichetele contactului pentru segmentare |
| `score` optional | integer | Scorul de implicare al contactului |
| `deals` optional | array | Înregistrările de oferte asociate |
| `fieldValues` optional | array | Valorile câmpurilor personalizate |

#### Mapare câmpuri personalizate

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

## Puncte finale API

### Contacte

| Metodă | Punct final | Descriere |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Listează toate contactele |
| `POST` | `/api/3/contacts` | Creează un contact |
| `PUT` | `/api/3/contacts/{id}` | Actualizează un contact |
| `GET` | `/api/3/contacts/{id}` | Recuperează un contact |
| `POST` | `/api/3/contact/sync` | Sincronizează un contact (creare sau actualizare) |
| `POST` | `/api/3/import/bulk_import` | Import în bloc de contacte |

### Oferte

| Metodă | Punct final | Descriere |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Listează toate ofertele |
| `POST` | `/api/3/deals` | Creează o ofertă |
| `PUT` | `/api/3/deals/{id}` | Actualizează o ofertă |
| `GET` | `/api/3/dealStages` | Listează toate etapele ofertelor |
| `GET` | `/api/3/dealPipelines` | Listează toate pipeline-urile |

### Automatizări

| Metodă | Punct final | Descriere |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Listează automatizările |
| `GET` | `/api/3/automations/{id}` | Recuperează o automatizare |
| `POST` | `/api/3/contactAutomations` | Adaugă contact la automatizare |

### E-commerce (Deep Data)

| Metodă | Punct final | Descriere |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Creează o comandă |
| `GET` | `/api/3/ecomOrders` | Listează comenzile |
| `POST` | `/api/3/ecomCustomers` | Creează un client |
| `GET` | `/api/3/ecomCustomers` | Listează clienții |

### Urmărire evenimente

| Metodă | Punct final | Descriere |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Urmărește un eveniment personalizat |
| `GET` | `/api/3/eventTrackingEvents` | Listează toate numele evenimentelor |
| `POST` | `/api/3/eventTrackingEvents` | Creează un nume de eveniment |

## Evenimente

### Evenimente contacte

| Eveniment | Declanșator | Caz de utilizare |
| --- | --- | --- |
| `contact_add` | Contact nou creat | Flux de bun venit |
| `contact_update` | Date contact modificate | Sincronizare atribute |
| `contact_tag_added` | Etichetă atribuită | Actualizare segment |
| `contact_tag_removed` | Etichetă eliminată | Curățare segment |

### Evenimente oferte

| Eveniment | Declanșator | Caz de utilizare |
| --- | --- | --- |
| `deal_add` | Ofertă nouă creată | Notificare vânzări |
| `deal_update` | Etapă ofertă modificată | Automatizare pipeline |
| `deal_tasktype_add` | Sarcină adăugată la ofertă | Urmărire activitate |

### Evenimente automatizări

| Eveniment | Declanșator | Caz de utilizare |
| --- | --- | --- |
| `automation_contact_add` | Contact a intrat în automatizare | Urmărire flux |
| `automation_contact_complete` | Contact a finalizat automatizarea | Declanșator pas următor |

## Exemple de cod

### Inițializare conector

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

### Migrare contacte la 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
// }
```

### Urmărire evenimente personalizate

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

## Limite de rată

Limite de rată API ActiveCampaign:

| Plan | Limită de rată | Detalii |
| --- | --- | --- |
| Lite | 5 cereri/secundă | Per cont |
| Plus | 10 cereri/secundă | Per cont |
| Professional | 10 cereri/secundă | Per cont |
| Enterprise | 20 cereri/secundă | Per cont |

Limite suplimentare:

- **Import în bloc**: 250 contacte per lot
- **Frecvență import în bloc**: 1 import la un moment dat
- **Urmărire evenimente**: 2 cereri/secundă
- **Limită zilnică**: Fără limită zilnică explicită (bazată pe rată)

Gestionare limite de rată

ActiveCampaign returnează `429 Too Many Requests` când limitele sunt depășite. Implementați logică de reîncercare cu valoarea antetului `Retry-After`.

## Depanare

### Probleme frecvente

| Problemă | Cauză | Soluție |
| --- | --- | --- |
| 403 Interzis | Cheie API sau URL invalid | Verificați URL-ul API și cheia în AC Settings > Developer |
| Contact nesincronizat | Gestionare e-mail duplicat | Utilizați punctul final `/contact/sync` pentru comportament upsert |
| Câmp personalizat gol | Nepotrivire ID câmp | Mapați câmpurile după ID, nu după etichetă (etichetele se pot schimba) |
| Webhook nereceționat | Webhook neconfigurat | Configurați webhook-uri în AC Settings > Developer > Webhooks |
| Ofertă necreată | Câmpuri obligatorii lipsă | Asigurați că pipeline-ul, etapa și contactul sunt furnizate |

### Modul de depanare

Activați jurnalizarea verbosă:

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

### Testare conexiune

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

## Bune practici

1. **Utilizați punctul final de sincronizare contacte** - Utilizați `/contact/sync` pentru operații upsert în loc de creare/actualizare separate
2. **Mapați câmpurile după ID** - ID-urile câmpurilor personalizate sunt stabile; etichetele se pot schimba
3. **Păstrați apartenența la liste** - Migrați atribuirile listelor împreună cu datele contactelor
4. **Sincronizați pipeline-urile de oferte** - Mapați etapele pipeline-ului pentru raportare CRM consistentă
5. **Implementați urmărirea evenimentelor** - Utilizați urmărirea site-ului pentru date comportamentale în Brevo
6. **Importuri în lot** - Utilizați import în bloc pentru seturi de date mai mari de 1.000 de contacte

## Securitate

- **Autentificare cu cheie API** - Acces bazat pe token prin antetul `Api-Token`
- **Verificare webhook** - Validați intervalele IP sursă ale webhook-urilor
- **Criptare TLS** - Toate comunicațiile API criptate prin HTTPS
- **Acces la nivel de cont** - Cheia API oferă acces complet la cont; utilizați cu grijă
- **Restricții IP** - Disponibile pe planurile Enterprise

## Resurse conexe

- [Documentație API ActiveCampaign](https://developers.activecampaign.com/reference/overview)
- [Ghid Webhook ActiveCampaign](https://developers.activecampaign.com/page/webhooks)
- [Conector Mailchimp](https://tajo.io/ro/docs/connectors/marketing/mailchimp)
- [Conector Brevo](https://tajo.io/ro/docs/connectors/marketing/brevo)
- [Skill Sincronizare clienți](https://tajo.io/ro/docs/skills/data-sync/customer-sync)