Bu rehberde: ActiveCampaign hesabınızı API URL'si ve API anahtarıyla bağlarsınız. Müşteri adayları CRM'e eşitle kutusuyla kişi (contact), etiket ve isteğe bağlı fırsat (deal) olarak aktarılır; bülten aboneleriniz bir ActiveCampaign listesine aktarılır ve kampanya kendi hesabınızdan gönderilir. Bir kişi listeye abone olduğunda iş akışı başlatabilirsiniz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | ACTIVECAMPAIGN |
| Kategori | CRM + e-posta pazarlama |
| Kimlik doğrulama | API URL (https://hesabiniz.api-us1.com) + API anahtarı (Api-Token başlığı) |
| Kapsam | Organizasyon bazlı |
| Webhook | Evet – bağlanınca otomatik oluşturulur (adrese eklenen gizli belirteçle doğrulanır) |
| Yetenekler | CRM eşitleme, bülten, uygulama işlemleri, uygulama tetikleyicileri |
Ne işe yarar?
- CRM eşitleme (
leads.crmSync): aday e-postaya görecontact/syncile oluşturulur veya güncellenir (ad, soyad, telefon, özel alanlar). Adaydakitagsve entegrasyon ayarındakitagsActiveCampaign etiketlerine dönüşür (yoksa oluşturulur). AyardalistIdvarsa kişi o listeye abone yapılır – daha önce o listeden çıkmış bir kişi yeniden abone yapılmaz. Hedefdealsise ayrıca bir fırsat açılır. - Bülten gönderimi: onaylı aboneler toplu içe aktarma (250'şerli) ile listeye eklenir; ActiveCampaign listeden çıkmış kişilerin aboneliğini atlar. OrqLabs kampanyayı içe aktarmadan yaklaşık 3 dakika sonra ActiveCampaign v1 API'siyle (
message_add+campaign_create) oluşturup gönderir. Abonelikten çıkma bağlantısı%UNSUBSCRIBELINK%ile eklenir. - İstatistikler: gönderilen, açılma, tekil açılma, tıklama, abonelikten çıkma ve geri dönme sayıları kampanyadan okunur.
- ActiveCampaign kutusu (iş akışı): kişi ekle/güncelle, etiket ekle, etiket kaldır, fırsat oluştur, listeleri listele.
- Tetikleyici: Kişi abone oldu (
subscribewebhook'u, tüm listeler ve kaynaklar).
Ön koşullar
- Bir ActiveCampaign hesabı ve en az bir liste (Contacts → Lists).
- Bülten için: hesapta doğrulanmış gönderen alan adı (Settings → Advanced → Domains) önerilir.
- Fırsatlar için: bir pipeline ve aşama (Deals).
Adım adım kurulum
- ActiveCampaign'de Settings → Developer sayfasında URL (
https://hesabiniz.api-us1.com) ve Key değerlerini kopyalayın. - OrqLabs'ta Entegrasyonlar → ActiveCampaign → Bağla → API URL ve API key alanlarını doldurun → Bağla. OrqLabs yalnızca
…api-us1.com/…activehosted.comadreslerini kabul eder; başka bir adres reddedilir (anahtarınız başka bir sunucuya gitmesin diye). - Bağlantı sırasında subscribe olayı için bir webhook oluşturulur.
- Bülten için ayrıntı panelindeki Bülten varsayılanları bölümünde Kişi listesi, Gönderen e-posta, Gönderen adı ve isteğe bağlı Yanıt adresi'ni girin. Hesap saat dilimi (ör.
Europe/Istanbul) yalnızca ActiveCampaign tarafında planlama gerektiğinde kullanılır → Kaydet.
CRM eşitleme ayarları
CRM'e eşitle kutusunda bu bağlantıyı seçin. Target alanı:
| Target | Sonuç |
|---|---|
boş / contacts | Kişi + etiketler (+ ayardaki listId) |
list:3 | Kişi + etiketler + 3 numaralı listeye abonelik |
deals | Kişi + etiketler + fırsat (ayarda dealPipelineId ve dealStageId gerekli, dealOwnerId isteğe bağlı) |
Entegrasyon ayarındaki fieldMap (aday alanı → özel alan ID'si, ör. {"companySize": 5}) özel alanları doldurur. Fırsat tutarı adayın dealValue / value alanından alınır ve ActiveCampaign'e kuruş cinsinden (×100) yazılır.
İş akışı kutusu: ActiveCampaign
| İşlem | Ne yapar | Çıktı |
|---|---|---|
| Kişi ekle / güncelle | E-postaya göre kişi; isteğe bağlı liste ve etiketler | contactId, created, listStatus (subscribed / unsubscribed) |
| Etiket ekle | Var olan kişiye etiket (yoksa oluşturulur) – otomasyonları tetikler | tagId |
| Etiket kaldır | Etiketi kişiden kaldırır | removed |
| Fırsat oluştur | Kişi için pipeline + aşamada fırsat | dealId |
| Listeleri listele | Hesaptaki listeler | listId, name |
Tetikleyici: Entegrasyon olayı
Entegrasyon olayı tetikleyicisinde ActiveCampaign bağlantınızı ve ACTIVECAMPAIGN · Contact subscribed olayını seçin. İlk öğe contactId, email, firstName, lastName, phone, listId, formId, tags, initiatedBy, dateTime alanlarını taşır. ActiveCampaign webhook'ları imzalamadığı için OrqLabs adrese eklenen gizli belirteci doğrular.
Limitler
| Konu | Sınır |
|---|---|
| API hız sınırı | Hesap başına saniyede 5 istek; aşılırsa RATE_LIMIT ve yeniden deneme |
| Toplu içe aktarma | İstek başına 250 kişi, arka planda işlenir |
| Planlama | v1 sdate hesap saatindedir; OrqLabs planlı bültenleri kendi tarafında zamanında gönderir |
| Gönderim | Başarısız kampanya otomatik yeniden denenmez; reddedilen kampanyanın mesajı silinir |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
CONFIG – "API URL must look like https://youraccount.api-us1.com" | URL yanlış kopyalandı | Settings → Developer'daki URL'yi girin |
AUTH – 401/403 | Anahtar yanlış veya kullanıcı yetkisiz | Yeni anahtarı Kimlik bilgileri → Güncelle ile girin |
CONFIG – "from name is required" | Gönderen adı girilmedi | Ayrıntı panelinde gönderen adını kaydedin |
CONFIG – "deals need dealPipelineId and dealStageId" | deals hedefi için ayar eksik | Entegrasyon ayarına pipeline ve aşama ID'lerini ekleyin |
listStatus: unsubscribed | Kişi bu listeden daha önce çıkmış | Doğru davranış; kişi yeniden abone yapılmaz |