HubSpot CRM

Bu rehberde: OrqLabs'taki müşteri adaylarını HubSpot'a aktarırsınız. HubSpot'ta bir "private app" oluşturur, anahtarını OrqLabs'a girer ve alan eşlemesini yaparsınız.

⏱ 15 dakika

Kimlik kartı#

Ne işe yarar?#

• Lead Researcher ve Lead Qualifier adayı bulur, puanlar ve "Nitelikli" yapar.
• CRM'e yaz kutusu aday alanlarını HubSpot Contacts özelliklerine eşler; e-posta eşleşen kişi varsa günceller, yoksa oluşturur.
• Satış ekibiniz HubSpot'ta çalışmaya devam eder; OrqLabs puanı, kaynağı ve durumu özel özellikler olarak taşır.

Ön koşullar#

• HubSpot hesabı; ücretsiz CRM yeterlidir.
• HubSpot'ta Super admin rolü.
• OrqLabs'ta Sahip veya Yönetici rolü.
• Özel özelliklere (örneğin agentflow_score) yazacaksanız bu özelliklerin HubSpot'ta önceden oluşturulmuş olması.

Adım adım kurulum#

A) HubSpot private app#

1. HubSpot → Settings (dişli) → Integrations → Private Apps → Create a private app.
2. Basic Info: ad OrqLabs.
3. Scopes → Add new scope → crm.objects ile arayın ve ① işaretleyin: crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.companies.read, crm.objects.companies.write. İsteğe bağlı: crm.objects.deals.read/write, crm.schemas.contacts.read.
4. ② Create app → Continue creating.

5. ① Auth → Show token → kopyalayın. Anahtar pat-eu1-… (AB) veya pat-na1-… (ABD) ile başlar.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → HubSpot CRM → Bağla. ② Organizasyon geneli.
2. ① Private app access token alanına yapıştırın.
3. ③ Bağla. OrqLabs kişi nesnesine erişimi doğrular. Bağlantıyı test et kapsamları kontrol eder.

Alan eşlemesi (CRM'e yaz)#

CRM'e yaz kutusunda Bağlı hesap olarak HubSpot'u seçin.

Örnek:

{
  "firstname": "{{ $json.name.split(' ')[0] }}",
  "lastname": "{{ $json.name.split(' ').slice(1).join(' ') }}",
  "email": "{{ $json.email }}",
  "phone": "{{ $json.phone }}",
  "company": "{{ $json.company }}",
  "website": "{{ $json.website }}",
  "hs_lead_status": "OPEN",
  "agentflow_score": "{{ $json.score }}"
}

• Standart özellikler: firstname, lastname, email, phone, company, website, jobtitle, lifecyclestage, hs_lead_status. Görünen ad değil internal name kullanılır (Settings → Properties → özellik → Internal name).
• Özel özellikleri önce oluşturun: Settings → Properties → Create property → Contact → tür. Yoksa INVALID hatası.
• Açılır liste özelliklerinde seçeneğin internal value'sunu yazın (OPEN, IN_PROGRESS).

Tekilleştirme: e-postası dolu her öğe için önce arama yapılır; bulunursa güncellenir. E-postası olmayanlar her seferinde yeni kişi oluşturur; önüne Eğer koyup ayırın.

İzinler ve kapsamlar#

Kapsam eklemek anahtarı değiştirmez; yeniden bağlamanız gerekmez.

Limitler#

Yüzlerce aday için kutu Bekleme (ms) değerini 2.000+ yapın.

Bağlantıyı test etme#

② Bağlantıyı test et tek kişi okur; portal kimliğini döndürür. Ardından iş akışını tek adayla test edip HubSpot Contacts listesinde kaydı görün.

Kimlik bilgilerini yenileme#

• Anahtar süresizdir.
• HubSpot → Private Apps → Auth → Rotate: eski anahtarı 7 gün geçerli tutma seçeneğiyle yeni anahtarı Kimlik bilgileri → Güncelle ile girin.
• Uygulama silinirse kart "Yeniden yetkilendirme gerekli" olur.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

HubSpot'taki değişiklikler OrqLabs'a geri gelir mi? Hayır. Aktarım tek yönlüdür (OrqLabs → HubSpot).

Birden fazla HubSpot portalım var. Her portal için ayrı private app ve ayrı entegrasyon kaydı açın.

Sonraki adım#

• CRM senkronizasyonu ve dışa aktarma
• Lead node'ları
• Google Sheets, Notion