---
title: "ActiveCampaign Bağlayıcısı"
description: "Tajo aracılığıyla kişileri, fırsatları, otomasyonları ve etkileşim olaylarını Brevo ile senkronize etmek için eksiksiz ActiveCampaign entegrasyon rehberi."
url: https://tajo.io/tr/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/tr/docs/connectors/marketing/activecampaign.md
lang: tr-TR
robots: noindex
---

Erken erişim talep edin

Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz.

# ActiveCampaign Bağlayıcısı

Bağlayıcı durumu: Planlandı Henüz oluşturulmadı. Tajo bu bağlayıcıyı bugün çalıştırmıyor.

| Kaynak alanı | Hedef alanı | Örnek değer |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Kapsamlı kişi taşıma, fırsat hattı senkronizasyonu, otomasyon eşleme ve her iki platformda birleşik pazarlama verileri için ActiveCampaign hesabınızı Tajo aracılığıyla Brevo’ya bağlayın.

## Genel Bakış

| Özellik | Değer |
| --- | --- |
| **Platform** | ActiveCampaign |
| **Kategori** | Pazarlama |
| **Kurulum Karmaşıklığı** | Orta |
| **Resmi Entegrasyon** | Hayır |
| **Senkronize Edilen Veri** | Kişiler, Fırsatlar, Otomasyonlar, Olaylar |
| **API Temel URL’si** | `https://{account}.api-us1.com/api/3` |

## Özellikler

- **Kişi taşıma** - Özel alanlar, etiketler ve liste üyelikleri ile kişileri taşıyın
- **Fırsat hattı senkronizasyonu** - Gelir takibi için fırsat aşamalarını, değerlerini ve sahiplerini senkronize edin
- **Otomasyon eşleme** - ActiveCampaign otomasyonlarını Brevo iş akışı tetikleyicilerine eşleyin
- **Olay takibi** - Davranışsal segmentasyon için site takibi ve özel olayları senkronize edin
- **Liste ve etiket senkronizasyonu** - Liste yapılarını ve etiket tabanlı segmentleri Brevo’da kopyalayın
- **E-ticaret entegrasyonu** - Deep Data’yı (siparişler, müşteriler, sepetler) Brevo’ya senkronize edin
- **Özel nesne senkronizasyonu** - ActiveCampaign özel nesnelerini Brevo özniteliklerine eşleyin
- **Skor senkronizasyonu** - Aday ve kişi puanlarını Brevo özniteliklerine aktarın

## Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir ActiveCampaign hesabı (Lite, Plus, Professional veya Enterprise)
2. Settings > Developer bölümünden API URL ve API anahtarı
3. API erişimi olan bir Brevo hesabı
4. Bir Tajo hesabı

## Kimlik Doğrulama

### API Anahtar Kimlik Doğrulaması

ActiveCampaign, başlık veya sorgu parametresi olarak iletilen bir API anahtarı kullanır.

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

API URL’nizi ve anahtarınızı ActiveCampaign Settings > Developer bölümünde bulun.

API URL'si

API URL’niz hesabınıza özeldir (örn. `https://yourcompany.api-us1.com`). Her zaman bu URL’yi kullanın, dashboard URL’sini değil.

## Yapılandırma

### Temel Kurulum

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

### Alan Eşleme

ActiveCampaign alanlarını Brevo kişi özniteliklerine eşleyin:

#### Varsayılan Eşlemeler

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Kişi e-postası (benzersiz tanımlayıcı) |
| `firstName` optional | string | FIRSTNAME özniteliğine eşlenir |
| `lastName` optional | string | LASTNAME özniteliğine eşlenir |
| `phone` optional | string | SMS özniteliğine eşlenir |
| `tags` optional | array | Segmentasyon için kişi etiketleri |
| `score` optional | integer | Kişi etkileşim puanı |
| `deals` optional | array | İlişkili fırsat kayıtları |
| `fieldValues` optional | array | Özel alan değerleri |

#### Özel Alan Eşleme

```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 Uç Noktaları

### Kişiler

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | Tüm kişileri listele |
| `POST` | `/api/3/contacts` | Bir kişi oluştur |
| `PUT` | `/api/3/contacts/{id}` | Bir kişiyi güncelle |
| `GET` | `/api/3/contacts/{id}` | Bir kişiyi getir |
| `POST` | `/api/3/contact/sync` | Bir kişiyi senkronize et (oluştur veya güncelle) |
| `POST` | `/api/3/import/bulk_import` | Toplu kişi içe aktar |

### Fırsatlar

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `GET` | `/api/3/deals` | Tüm fırsatları listele |
| `POST` | `/api/3/deals` | Bir fırsat oluştur |
| `PUT` | `/api/3/deals/{id}` | Bir fırsatı güncelle |
| `GET` | `/api/3/dealStages` | Tüm fırsat aşamalarını listele |
| `GET` | `/api/3/dealPipelines` | Tüm hatları listele |

### Otomasyonlar

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `GET` | `/api/3/automations` | Otomasyonları listele |
| `GET` | `/api/3/automations/{id}` | Bir otomasyonu getir |
| `POST` | `/api/3/contactAutomations` | Otomasyona kişi ekle |

### E-ticaret (Deep Data)

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | Bir sipariş oluştur |
| `GET` | `/api/3/ecomOrders` | Siparişleri listele |
| `POST` | `/api/3/ecomCustomers` | Bir müşteri oluştur |
| `GET` | `/api/3/ecomCustomers` | Müşterileri listele |

### Olay Takibi

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | Özel bir olayı takip et |
| `GET` | `/api/3/eventTrackingEvents` | Tüm olay adlarını listele |
| `POST` | `/api/3/eventTrackingEvents` | Bir olay adı oluştur |

## Olaylar

### Kişi Olayları

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `contact_add` | Yeni kişi oluşturuldu | Karşılama akışı |
| `contact_update` | Kişi verisi değişti | Öznitelik senkronizasyonu |
| `contact_tag_added` | Etiket atandı | Segment güncellemesi |
| `contact_tag_removed` | Etiket kaldırıldı | Segment temizleme |

### Fırsat Olayları

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `deal_add` | Yeni fırsat oluşturuldu | Satış bildirimi |
| `deal_update` | Fırsat aşaması değişti | Hat otomasyonu |
| `deal_tasktype_add` | Fırsata görev eklendi | Aktivite takibi |

### Otomasyon Olayları

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `automation_contact_add` | Kişi otomasyona girdi | Akış takibi |
| `automation_contact_complete` | Kişi otomasyonu tamamladı | Sonraki adım tetikleyicisi |

## Kod Örnekleri

### Bağlayıcıyı Başlat

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

### Kişileri Brevo’ya Taşı

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

### Özel Olayları Takip Et

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

## Hız Limitleri

ActiveCampaign API hız limitleri:

| Plan | Hız Limiti | Detaylar |
| --- | --- | --- |
| Lite | 5 istek/saniye | Hesap başına |
| Plus | 10 istek/saniye | Hesap başına |
| Professional | 10 istek/saniye | Hesap başına |
| Enterprise | 20 istek/saniye | Hesap başına |

Ek limitler:

- **Toplu içe aktarma**: Toplu başına 250 kişi
- **Toplu içe aktarma sıklığı**: Aynı anda 1 içe aktarma
- **Olay takibi**: 2 istek/saniye
- **Günlük limit**: Açık günlük limit yok (yalnızca hız tabanlı)

Hız Limit Yönetimi

ActiveCampaign, limitler aşıldığında `429 Too Many Requests` döndürür. `Retry-After` başlığı değeriyle yeniden deneme mantığı uygulayın.

## Sorun Giderme

### Sık Karşılaşılan Sorunlar

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| 403 Forbidden | Geçersiz API anahtarı veya URL | AC Settings > Developer’da API URL ve anahtarını doğrulayın |
| Kişi senkronize edilmiyor | Yinelenen e-posta yönetimi | Upsert davranışı için `/contact/sync` uç noktasını kullanın |
| Özel alan boş | Alan kimliği eşleşmiyor | Alanları etikete göre değil kimliğe göre eşleyin (etiketler değişebilir) |
| Webhook alınmıyor | Webhook yapılandırılmamış | AC Settings > Developer > Webhooks’ta webhook’ları kurun |
| Fırsat oluşturulmuyor | Gerekli alanlar eksik | Hat, aşama ve kişinin sağlandığından emin olun |

### Hata Ayıklama Modu

Ayrıntılı günlüklemeyi etkinleştirin:

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

### Bağlantıyı Test Et

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

## En İyi Uygulamalar

1. **Kişi senkronizasyon uç noktasını kullanın** - Ayrı oluşturma/güncelleme yerine upsert işlemleri için `/contact/sync` kullanın
2. **Alanları kimliğe göre eşleyin** - Özel alan kimlikleri sabittir; etiketler değişebilir
3. **Liste üyeliklerini koruyun** - Kişi verileriyle birlikte liste atamalarını taşıyın
4. **Fırsat hatlarını senkronize edin** - Tutarlı CRM raporlaması için hat aşamalarını eşleyin
5. **Olay takibi uygulayın** - Brevo’da davranışsal veriler için site takibi kullanın
6. **Toplu içe aktarmalar** - 1.000’den fazla kişi içeren veri kümeleri için toplu içe aktarma kullanın

## Güvenlik

- **API Anahtar Kimlik Doğrulaması** - `Api-Token` başlığı üzerinden belirteç tabanlı erişim
- **Webhook doğrulama** - Webhook kaynak IP aralıklarını doğrulayın
- **TLS şifrelemesi** - Tüm API iletişimi HTTPS aracılığıyla şifrelenir
- **Hesap seviyesi erişim** - API anahtarı tam hesap erişimi sağlar; dikkatli kullanın
- **IP kısıtlamaları** - Enterprise planlarda mevcuttur

## İlgili Kaynaklar

- [ActiveCampaign API Dokümantasyonu](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign Webhook Rehberi](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/mailchimp)
- [Brevo Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/brevo)
- [Müşteri Senkronizasyon Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)