HubSpot Bağlayıcısı

HubSpot CRM’inizi Tajo üzerinden Brevo’ya bağlayarak çift yönlü kişi senkronizasyonu, fırsat takibi, etkileşim verileri ve her iki platformda birleşik pazarlama otomasyonu elde edin.

Genel Bakış

Özellikler

• Çift yönlü kişi senkronizasyonu - HubSpot ve Brevo arasında kişileri gerçek zamanlı olarak senkronize tutun
• Fırsat hattı takibi - Gelire dayalı segmentasyon için fırsat aşamalarını ve değerlerini senkronize edin
• Şirket verisi senkronizasyonu - Kişileri şirket kayıtları ve firmografik verilerle ilişkilendirin
• Destek talebi entegrasyonu - Müşteri sağlığı puanlaması için destek taleplerini takip edin
• Etkileşim takibi - E-posta açılmaları, tıklamalar, toplantılar, aramalar ve notları senkronize edin
• Özel nesne desteği - HubSpot özel nesnelerini Brevo özelliklerine eşleyin
• İş akışı tetikleyicileri - Brevo otomasyonlarını tetiklemek için HubSpot yaşam döngüsü aşama değişikliklerini kullanın
• Webhook olayları - CRM veri değişiklikleri için gerçek zamanlı bildirimler

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir HubSpot hesabı (Free, Starter, Professional veya Enterprise)
2. Gerekli kapsamlara sahip bir HubSpot özel uygulaması veya OAuth uygulaması
3. API erişimi olan bir Brevo hesabı
4. Bir Tajo hesabı

Kimlik Doğrulama

Özel Uygulama Erişim Belirteci (Önerilen)

Ayrıntılı kapsam kontrolü ile doğrudan API erişimi için HubSpot’ta bir özel uygulama oluşturun.

1. HubSpot Ayarlar > Entegrasyonlar > Özel Uygulamalar bölümüne gidin
2. Yeni bir özel uygulama oluşturun
3. Gerekli kapsamları yapılandırın
4. Erişim belirtecini kopyalayın

curl -X GET "https://api.hubapi.com/crm/v3/objects/contacts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

OAuth 2.0

Kullanıcı yetkilendirmesi gerektiren çoklu hesap entegrasyonları için OAuth 2.0 kullanın.

# Authorization URL
https://app.hubspot.com/oauth/authorize?client_id={client_id}&scope=crm.objects.contacts.read&redirect_uri={redirect_uri}

Gerekli Kapsamlar

crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.companies.read
crm.objects.deals.read
crm.objects.deals.write
crm.objects.custom.read
crm.schemas.custom.read

Yapılandırma

Temel Kurulum

connectors:
  hubspot:
    enabled: true
    access_token: "${HUBSPOT_ACCESS_TOKEN}"

    # Data sync options
    sync:
      contacts: true
      companies: true
      deals: true
      tickets: true
      engagements: true

    # Sync direction
    direction: bidirectional  # or 'hubspot_to_brevo' | 'brevo_to_hubspot'

    # List assignment in Brevo
    lists:
      all_contacts: 10
      qualified_leads: 11
      customers: 12

Alan Eşleme

HubSpot özelliklerini Brevo kişi özniteliklerine eşleyin:

Özel Özellik Eşlemesi

field_mapping:
  # Standard fields
  email: email
  firstname: FIRSTNAME
  lastname: LASTNAME
  phone: SMS

  # CRM fields
  lifecyclestage: LIFECYCLE_STAGE
  hs_lead_status: LEAD_STATUS
  company: COMPANY_NAME

  # Deal metrics
  hs_total_deal_value: DEAL_VALUE
  num_associated_deals: DEAL_COUNT

  # Custom properties
  preferred_channel: PREFERRED_CHANNEL
  customer_segment: SEGMENT

API Uç Noktaları

CRM Nesneleri

İlişkilendirmeler

Etkileşimler

Olaylar

Kişi Olayları

Fırsat Olayları

Şirket Olayları

Kod Örnekleri

Bağlayıcıyı Başlat

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect HubSpot
await tajo.connectors.connect('hubspot', {
  accessToken: process.env.HUBSPOT_ACCESS_TOKEN
});

Kişi Senkronizasyonu Çalıştır

// Full bidirectional sync
await tajo.connectors.sync('hubspot', {
  type: 'full',
  resources: ['contacts', 'companies', 'deals'],
  direction: 'bidirectional',
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('hubspot');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 34200,
//   companiesSynced: 5100,
//   dealsSynced: 2340
// }

Webhook Olaylarını İşle

// Handle HubSpot webhook notifications
app.post('/webhooks/hubspot', async (req, res) => {
  const signature = req.get('X-HubSpot-Signature-v3');

  // Verify webhook signature
  if (!verifyHubSpotSignature(req.body, signature)) {
    return res.status(401).send('Unauthorized');
  }

  for (const event of req.body) {
    await tajo.connectors.handleWebhook('hubspot', {
      eventType: event.subscriptionType,
      objectId: event.objectId,
      propertyName: event.propertyName,
      propertyValue: event.propertyValue
    });
  }

  res.status(200).send('OK');
});

Hız Limitleri

HubSpot, özel uygulama veya OAuth uygulaması başına hız limitleri uygular:

Ek limitler:

• Arama API’si: uygulama başına saniyede 5 istek
• Toplu işlemler: toplu istek başına 100 kayıt
• Günlük limit: 500.000 istek/gün (OAuth uygulamaları)

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

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

connectors:
  hubspot:
    debug: true
    log_level: verbose
    log_webhooks: true

Bağlantıyı Test Et

tajo connectors test hubspot
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Companies readable
# ✓ Deals readable
# ✓ Webhooks registered

En İyi Uygulamalar

1. Özel uygulamaları API anahtarları yerine kullanın - API anahtarları kullanımdan kaldırılmıştır; daha iyi güvenlik için özel uygulamaları kullanın
2. Çift yönlü senkronizasyonu dikkatli uygulayın - Senkronizasyon kaynağını izleyerek sonsuz döngülerden kaçının
3. Yaşam döngüsü aşamalarını eşleyin - Brevo’da kişileri segmentlere ayırmak için HubSpot yaşam döngüsü aşamalarını kullanın
4. API isteklerini gruplandırın - Hız limitleri içinde kalmak için toplu işlemler için toplu uç noktaları kullanın
5. Webhook teslimatını izleyin - Yeniden deneme mantığı ve dead letter yönetimi kurun
6. Artımlı senkronizasyon kullanın - Yalnızca değişen kayıtları lastmodifieddate özelliğini kullanarak senkronize edin

Güvenlik

• Özel Uygulama Belirteçleri - Ayrıntılı izinlerle kapsamlandırılmış erişim belirteçleri
• OAuth 2.0 - Yenileme belirteci rotasyonu ile endüstri standardı yetkilendirme
• Webhook imzaları - HMAC tabanlı imza doğrulaması (v3)
• TLS şifrelemesi - Tüm API iletişimi aktarımda şifrelenmiştir
• Kapsamlandırılmış izinler - Entegrasyon başına minimum gerekli kapsam erişimi

İlgili Kaynaklar

• HubSpot API Dokümantasyonu
• HubSpot Kimlik Doğrulama Rehberi
• Salesforce Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Brevo Kişiler API’si