---
title: "Σύνδεσμος ActiveCampaign"
description: "Πλήρης οδηγός ενσωμάτωσης ActiveCampaign για συγχρονισμό επαφών, deals, αυτοματισμών και εκδηλώσεων αφοσίωσης με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/gr/docs/connectors/marketing/activecampaign.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος ActiveCampaign

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Συνδέστε τον λογαριασμό ActiveCampaign με το Brevo μέσω Tajo για ολοκληρωμένη μετεγκατάσταση επαφών, συγχρονισμό pipeline deal, αντιστοίχηση αυτοματισμού και ενοποιημένα δεδομένα marketing και στις δύο πλατφόρμες.

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | ActiveCampaign |
| **Κατηγορία** | Marketing |
| **Πολυπλοκότητα Ρύθμισης** | Μεσαία |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Επαφές, Deals, Αυτοματισμοί, Εκδηλώσεις |
| **Βασικό URL API** | `https://{account}.api-us1.com/api/3` |

## Χαρακτηριστικά

- **Μετεγκατάσταση επαφών** - Μετεγκατάσταση επαφών με προσαρμοσμένα πεδία, tags και συμμετοχές λίστας
- **Συγχρονισμός pipeline deal** - Συγχρονισμός σταδίων deal, αξιών και ιδιοκτητών για παρακολούθηση εσόδων
- **Αντιστοίχηση αυτοματισμού** - Αντιστοίχηση αυτοματισμών ActiveCampaign σε ενεργοποιητές ροής εργασίας Brevo
- **Παρακολούθηση εκδηλώσεων** - Συγχρονισμός παρακολούθησης τοποθεσίας και προσαρμοσμένων εκδηλώσεων για συμπεριφορική τμηματοποίηση
- **Συγχρονισμός λίστας και tag** - Αναπαραγωγή δομών λίστας και τμημάτων βάσει tag στο Brevo
- **Ενσωμάτωση ηλεκτρονικού εμπορίου** - Συγχρονισμός Deep Data (παραγγελίες, πελάτες, καλάθια) στο Brevo
- **Συγχρονισμός προσαρμοσμένων αντικειμένων** - Αντιστοίχηση προσαρμοσμένων αντικειμένων ActiveCampaign σε χαρακτηριστικά Brevo
- **Συγχρονισμός βαθμολογίας** - Μεταφορά βαθμολογιών lead και επαφής σε χαρακτηριστικά Brevo

## Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό ActiveCampaign (Lite, Plus, Professional ή Enterprise)
2. URL API και κλειδί API από Ρυθμίσεις > Developer
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo

## Πιστοποίηση

### Πιστοποίηση με API Key

Το ActiveCampaign χρησιμοποιεί κλειδί API που μεταβιβάζεται ως header ή παράμετρος ερωτήματος.

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

Βρείτε το URL API και το κλειδί σας στο ActiveCampaign Ρυθμίσεις > Developer.

URL API

Το URL API σας είναι μοναδικό για τον λογαριασμό σας (π.χ. `https://yourcompany.api-us1.com`). Χρησιμοποιείτε πάντα αυτό το URL, όχι το URL του dashboard.

## Διαμόρφωση

### Βασική Ρύθμιση

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

### Αντιστοίχιση Πεδίων

Αντιστοίχηση πεδίων ActiveCampaign σε χαρακτηριστικά επαφών Brevo:

#### Προεπιλεγμένες Αντιστοιχίσεις

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Email επαφής (μοναδικό αναγνωριστικό) |
| `firstName` optional | string | Αντιστοιχεί στο χαρακτηριστικό FIRSTNAME |
| `lastName` optional | string | Αντιστοιχεί στο χαρακτηριστικό LASTNAME |
| `phone` optional | string | Αντιστοιχεί στο χαρακτηριστικό SMS |
| `tags` optional | array | Tags επαφής για τμηματοποίηση |
| `score` optional | integer | Βαθμολογία αφοσίωσης επαφής |
| `deals` optional | array | Συνδεδεμένες εγγραφές deal |
| `fieldValues` optional | array | Τιμές προσαρμοσμένων πεδίων |

#### Αντιστοίχιση Προσαρμοσμένων Πεδίων

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

## Endpoints API

### Επαφές

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Λίστα όλων των επαφών |
| `POST` | `/api/3/contacts` | Δημιουργία επαφής |
| `PUT` | `/api/3/contacts/{id}` | Ενημέρωση επαφής |
| `GET` | `/api/3/contacts/{id}` | Ανάκτηση επαφής |
| `POST` | `/api/3/contact/sync` | Συγχρονισμός επαφής (δημιουργία ή ενημέρωση) |
| `POST` | `/api/3/import/bulk_import` | Μαζική εισαγωγή επαφών |

### Deals

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Λίστα όλων των deals |
| `POST` | `/api/3/deals` | Δημιουργία deal |
| `PUT` | `/api/3/deals/{id}` | Ενημέρωση deal |
| `GET` | `/api/3/dealStages` | Λίστα όλων των σταδίων deal |
| `GET` | `/api/3/dealPipelines` | Λίστα όλων των pipelines |

### Αυτοματισμοί

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Λίστα αυτοματισμών |
| `GET` | `/api/3/automations/{id}` | Ανάκτηση αυτοματισμού |
| `POST` | `/api/3/contactAutomations` | Προσθήκη επαφής σε αυτοματισμό |

### Ηλεκτρονικό Εμπόριο (Deep Data)

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Δημιουργία παραγγελίας |
| `GET` | `/api/3/ecomOrders` | Λίστα παραγγελιών |
| `POST` | `/api/3/ecomCustomers` | Δημιουργία πελάτη |
| `GET` | `/api/3/ecomCustomers` | Λίστα πελατών |

### Παρακολούθηση Εκδηλώσεων

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Παρακολούθηση προσαρμοσμένης εκδήλωσης |
| `GET` | `/api/3/eventTrackingEvents` | Λίστα όλων των ονομάτων εκδηλώσεων |
| `POST` | `/api/3/eventTrackingEvents` | Δημιουργία ονόματος εκδήλωσης |

## Εκδηλώσεις

### Εκδηλώσεις Επαφής

| Εκδήλωση | Ενεργοποιητής | Περίπτωση Χρήσης |
| --- | --- | --- |
| `contact_add` | Δημιουργία νέας επαφής | Ροή καλωσορίσματος |
| `contact_update` | Αλλαγή δεδομένων επαφής | Συγχρονισμός χαρακτηριστικών |
| `contact_tag_added` | Ανάθεση tag | Ενημέρωση τμήματος |
| `contact_tag_removed` | Αφαίρεση tag | Καθαρισμός τμήματος |

### Εκδηλώσεις Deal

| Εκδήλωση | Ενεργοποιητής | Περίπτωση Χρήσης |
| --- | --- | --- |
| `deal_add` | Δημιουργία νέου deal | Ειδοποίηση πωλήσεων |
| `deal_update` | Αλλαγή σταδίου deal | Αυτοματισμός pipeline |
| `deal_tasktype_add` | Προσθήκη εργασίας σε deal | Παρακολούθηση δραστηριότητας |

### Εκδηλώσεις Αυτοματισμού

| Εκδήλωση | Ενεργοποιητής | Περίπτωση Χρήσης |
| --- | --- | --- |
| `automation_contact_add` | Επαφή εισήλθε σε αυτοματισμό | Παρακολούθηση ροής |
| `automation_contact_complete` | Επαφή ολοκλήρωσε αυτοματισμό | Ενεργοποίηση επόμενου βήματος |

## Παραδείγματα Κώδικα

### Αρχικοποίηση Συνδέσμου

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

### Μετεγκατάσταση Επαφών στο 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
// }
```

### Παρακολούθηση Προσαρμοσμένων Εκδηλώσεων

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

| Πλάνο | Όριο Ρυθμού | Λεπτομέρειες |
| --- | --- | --- |
| Lite | 5 αιτήματα/δευτ. | Ανά λογαριασμό |
| Plus | 10 αιτήματα/δευτ. | Ανά λογαριασμό |
| Professional | 10 αιτήματα/δευτ. | Ανά λογαριασμό |
| Enterprise | 20 αιτήματα/δευτ. | Ανά λογαριασμό |

Πρόσθετα όρια:

- **Μαζική εισαγωγή**: 250 επαφές ανά batch
- **Συχνότητα μαζικής εισαγωγής**: 1 εισαγωγή τη φορά
- **Παρακολούθηση εκδηλώσεων**: 2 αιτήματα/δευτερόλεπτο
- **Ημερήσιο όριο**: Χωρίς ρητό ημερήσιο όριο (μόνο βάσει ρυθμού)

Χειρισμός Ορίου Ρυθμού

Το ActiveCampaign επιστρέφει `429 Too Many Requests` όταν υπερβαίνονται τα όρια. Εφαρμόστε λογική επανάληψης με την τιμή header `Retry-After`.

## Αντιμετώπιση Προβλημάτων

### Συνήθη Προβλήματα

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 403 Forbidden | Μη έγκυρο κλειδί API ή URL | Επαληθεύστε URL API και κλειδί στο AC Ρυθμίσεις > Developer |
| Η επαφή δεν συγχρονίστηκε | Χειρισμός διπλοεγγραφής email | Χρησιμοποιήστε endpoint `/contact/sync` για συμπεριφορά upsert |
| Κενό προσαρμοσμένο πεδίο | Αναντιστοιχία ID πεδίου | Αντιστοιχίστε πεδία κατά ID, όχι κατά ετικέτα (οι ετικέτες μπορούν να αλλάξουν) |
| Το webhook δεν λαμβάνεται | Το webhook δεν έχει ρυθμιστεί | Ρυθμίστε webhooks στο AC Ρυθμίσεις > Developer > Webhooks |
| Το deal δεν δημιουργήθηκε | Λείπουν υποχρεωτικά πεδία | Βεβαιωθείτε ότι παρέχονται pipeline, στάδιο και επαφή |

### Λειτουργία Εντοπισμού Σφαλμάτων

Ενεργοποιήστε λεπτομερή καταγραφή:

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

### Δοκιμή Σύνδεσης

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

## Βέλτιστες Πρακτικές

1. **Χρησιμοποιήστε endpoint συγχρονισμού επαφής** - Χρησιμοποιήστε `/contact/sync` για λειτουργίες upsert αντί ξεχωριστής δημιουργίας/ενημέρωσης
2. **Αντιστοιχίστε πεδία κατά ID** - Τα IDs προσαρμοσμένων πεδίων είναι σταθερά· οι ετικέτες μπορούν να αλλάξουν
3. **Διατηρήστε συμμετοχές λίστας** - Μεταφέρετε αναθέσεις λίστας μαζί με δεδομένα επαφής
4. **Συγχρονίστε pipelines deal** - Αντιστοιχίστε στάδια pipeline για συνεπή αναφορά CRM
5. **Εφαρμόστε παρακολούθηση εκδηλώσεων** - Χρησιμοποιήστε παρακολούθηση τοποθεσίας για συμπεριφορικά δεδομένα στο Brevo
6. **Εισαγωγές batch** - Χρησιμοποιήστε μαζική εισαγωγή για σύνολα δεδομένων μεγαλύτερα από 1.000 επαφές

## Ασφάλεια

- **Πιστοποίηση API Key** - Πρόσβαση βάσει token μέσω header `Api-Token`
- **Επικύρωση webhook** - Επικύρωση εύρους IP πηγής webhook
- **Κρυπτογράφηση TLS** - Όλη η επικοινωνία API κρυπτογραφείται μέσω HTTPS
- **Πρόσβαση επιπέδου λογαριασμού** - Το κλειδί API παρέχει πλήρη πρόσβαση λογαριασμού· χρησιμοποιήστε με προσοχή
- **Περιορισμοί IP** - Διαθέσιμο σε Enterprise πλάνα

## Σχετικοί Πόροι

- [Τεκμηρίωση API ActiveCampaign](https://developers.activecampaign.com/reference/overview)
- [Οδηγός Webhook ActiveCampaign](https://developers.activecampaign.com/page/webhooks)
- [Σύνδεσμος Mailchimp](https://tajo.io/gr/docs/connectors/marketing/mailchimp)
- [Σύνδεσμος Brevo](https://tajo.io/gr/docs/connectors/marketing/brevo)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)