HubSpot'u Elido'ya bağlayın

HubSpot entegrasyonu, Elido dönüşüm olaylarını kişi özellikleri ve fırsat güncellemeleri olarak HubSpot'a iletir. Biri izlenen bir bağlantıya tıklayıp bir dönüşüm hedefini tamamladığında Elido, atıf verilerini (UTM kaynağı, kampanya, tıklama ID'si) hiçbir kod yazmadan HubSpot'a gönderir.

OAuth ile bağlanın

1. Panel → Conversions → HubSpot → Connect HubSpot'a gidin.
2. HubSpot OAuth ekranı açılır. "CRM → Objects" erişimi olan bir hesapla oturum açın.
3. HubSpot istenen kapsamları gösterir: crm.objects.contacts.write ve crm.objects.deals.write. Bunlar Elido'nun kişi özelliklerine yazmasına ve fırsatları aşamalar arasında taşımasına izin verir.
4. Connect app'e tıklayın. HubSpot sizi Elido'ya geri yönlendirir.

Yenileme belirteçleri otomatik olarak döner. HubSpot tarafında erişimi iptal ederseniz (Settings → Connected Apps), Elido olay göndermeyi hemen durdurur ve teslimat günlüğünde bir "token revoked" hatası gösterir.

Alanları eşleyin

Bağlandıktan sonra Panel → Conversions → HubSpot → Configure'a gidin:

1. Contact properties — Elido'nun yazacağı HubSpot kişi özelliklerini seçin. Kullanılabilir Elido alanları: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Deal stage — bir dönüşümün bir fırsatı hangi pipeline ve aşamaya taşıyacağını seçin. HubSpot fırsatlarını kullanmıyorsanız boş bırakın.
3. Match contact by — e-posta (açılış sayfanız üzerinden e-posta yakalıyorsanız) veya HubSpot kişi ID'si (URL'de hs_contact_id geçirdiğiniz sunucu tarafı atıf için).

Elido'nun HubSpot'a yazdıkları

Her dönüşüm bir HubSpot zaman çizelgesi olayı oluşturur ve (eşlenmişse) kişinin özelliklerini günceller. Elido'nun gönderdiği ham yük:

{
  "event": "conversion.recorded",
  "click_id": "clk_abc123",
  "value": 99.0,
  "currency": "EUR",
  "utm": {
    "source": "newsletter",
    "medium": "email",
    "campaign": "spring-2026"
  }
}

HubSpot bunu kişi kaydında özel bir zaman çizelgesi olayı olarak gösterir. Fırsat aşaması güncellemesi (yapılandırılmışsa) aynı istekte tetiklenir.

Neler senkronize olmaz

• Dönüşümsüz tıklama olayları — ham tıklamalar HubSpot kaydı oluşturmaz. Yalnızca dönüşümler oluşturur.
• Geçmiş veriler — entegrasyon, bağlandığınız andan itibaren yalnızca ileriye dönük çalışır.
• HubSpot → Elido — entegrasyon yalnızca çıkış yönlüdür. HubSpot fırsat değişiklikleri Elido'ya geri akmaz.

Sorun giderme

"Insufficient permissions" hatası — Yetkilendirmeyi yapan HubSpot kullanıcısının CRM yazma erişimi yoktu. Bir HubSpot süper yöneticisinden Panel → Conversions → HubSpot → Reconnect üzerinden yeniden yetkilendirmesini isteyin.

Kişi bulunamadı — olaylar düşürüldü — Elido, e-posta veya ID ile eşleşen bir kişi bulamazsa olay günlüğe kaydedilir ama iletilmez. "no matching contact" girişleri için Panel → Conversions → Delivery log'u kontrol edin.

Dönüşümler yanlış kampanya atfıyla geliyor — Hedef URL'de UTM parametrelerinin bulunduğunu doğrulayın. Elido bunları tıklamadan yakalar; bağlantıda UTM yoksa HubSpot alanları boş kalır.

OAuth sürekli sona eriyor — HubSpot, 6+ ay boyunca yenileme uç noktasını çağırmayan uygulamaların belirteçlerini iptal eder. Elido entegrasyonu her olayda yeniler. Aylardır dönüşüm almadıysanız manuel olarak yeniden bağlanın.