HubSpot Node

HubSpot node'u, SkyStudio workflow'larında HubSpot CRM ile entegrasyon sağlar. Kişi, fırsat (deal) ve şirket kayıtlarını okuyabilir, filtreleyebilir ve AI destekli sorgular çalıştırabilirsiniz.

---

🎬 Videoyu izlemek için tıklayın →

Bağlantı Kurulumu ve Yönetimi

HubSpot node'unu kullanabilmek için HubSpot'ta bir Private App oluşturmanız ve erişim token'ını SkyStudio'ya eklemeniz gerekir.

Private App Token Alma

1. HubSpot hesabınıza giriş yapın.
2. Sağ üstteki profil simgesinden Ayarlar'a gidin.
3. Sol menüden Entegrasyonlar → Private Apps bölümünü açın.
4. Uygulama Oluştur butonuna tıklayın.
5. Uygulamaya bir ad verin ve gerekli izin kapsamlarını (scopes) seçin:
   • CRM → crm.objects.contacts.read, crm.objects.deals.read, crm.objects.companies.read
6. Uygulamayı Oluştur butonuna tıklayın.
7. Oluşturulan Access Token'ı kopyalayın (pat-eu1-… veya pat-na1-… ile başlar).

Not: Token yalnızca bir kez tam olarak görüntülenir. Kopyalamayı unutursanız token'ı yeniden oluşturmanız gerekir.

SkyStudio'ya Bağlantı Ekleme

1. SkyStudio'nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle butonuna tıklayın.
3. Sağlayıcı olarak HubSpot seçin.
4. Bağlantı Adı alanına tanımlayıcı bir isim girin (örn. Prod HubSpot).
5. Private App Erişim Token'ı alanına kopyaladığınız token'ı yapıştırın.
6. Kaydet butonuna tıklayın.

Bağlantıyı Node'a Atama

HubSpot node'unu canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

İpucu: Farklı HubSpot portalları için (örn. test ve canlı) ayrı bağlantılar tanımlayabilir ve workflow'da hangisini kullanacağınızı seçebilirsiniz.

---

Operasyonlar

HubSpot node'u 7 operasyon sunmaktadır:

Operasyon	Kategori	Açıklama
Kişileri Getir	Öne Çıkan	CRM'deki tüm kişi kayıtlarını listeler
Fırsatları Getir	Öne Çıkan	CRM'deki tüm fırsat (deal) kayıtlarını listeler
Nesne Ara	Öne Çıkan	Filtre ile herhangi bir CRM nesnesini arar
HubSpot AI Asistan	Öne Çıkan	Doğal dil sorgusuyla CRM verilerini sorgular
Kişi Getir (ID ile)	Standart	Belirli bir kişinin detaylarını ID ile getirir
Fırsat Getir (ID ile)	Standart	Belirli bir fırsatın detaylarını ID ile getirir
Şirketleri Getir	Standart	CRM'deki tüm şirket kayıtlarını listeler

---

Kişileri Getir

HubSpot CRM'deki tüm kişi (contact) kayıtlarını döndürür. Toplu kişi listesi çekme ve senkronizasyon senaryolarında kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak HubSpot bağlantısı
Properties	Hayır	Getirilecek kişi özellikleri (virgülle ayrılmış alan adları, örn. firstname,lastname,email,phone)
Get All (Auto Paginate)	Hayır	Açıksa tüm sayfalardaki kayıtları otomatik getirir; kapalıysa yalnızca ilk sayfayı döner
Limit	Hayır	Döndürülecek maksimum kişi sayısı (Get All kapalıyken geçerlidir)

Properties Örnekleri

firstname, lastname, email, phone, company, jobtitle, city, country, createdate, lastmodifieddate, hubspot_owner_id

Örnek Çıktı

{
  "results": [
    {
      "id": "12345",
      "properties": {
        "firstname": "Ahmet",
        "lastname": "Yılmaz",
        "email": "ahmet@sirket.com",
        "phone": "+905551234567",
        "company": "Örnek A.Ş."
      }
    }
  ]
}

---

Fırsatları Getir

HubSpot CRM'deki tüm fırsat (deal) kayıtlarını döndürür. Satış pipeline takibi ve raporlama workflow'larında kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak HubSpot bağlantısı
Properties	Hayır	Getirilecek fırsat özellikleri (virgülle ayrılmış alan adları)
Get All (Auto Paginate)	Hayır	Tüm sayfaları otomatik getirir
Limit	Hayır	Döndürülecek maksimum fırsat sayısı

Properties Örnekleri

dealname, amount, dealstage, closedate, pipeline, hubspot_owner_id, createdate, hs_lastmodifieddate

Örnek Çıktı

{
  "results": [
    {
      "id": "67890",
      "properties": {
        "dealname": "Kurumsal Lisans - Örnek A.Ş.",
        "amount": "15000",
        "dealstage": "presentationscheduled",
        "closedate": "2024-12-31T00:00:00.000Z"
      }
    }
  ]
}

---

Nesne Ara

HubSpot CRM'de herhangi bir nesne tipini (kişi, fırsat, şirket, bilet vb.) belirli bir filtreyle arar. Dinamik sorgular ve koşullu veri çekme senaryoları için kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak HubSpot bağlantısı
Object Type	Evet	Aranacak nesne tipi: contacts, deals, companies, tickets
Filter Property	Hayır	Filtreleme yapılacak özellik adı (örn. email, dealstage)
Filter Operator	Hayır	Filtre operatörü (örn. EQ, NEQ, CONTAINS_TOKEN, GT, LT)
Filter Value	Hayır	Filtre değeri (örn. ahmet@sirket.com, closedwon)
Properties	Hayır	Sonuçlarda döndürülecek alan adları (virgülle ayrılmış)
Limit	Hayır	Döndürülecek maksimum kayıt sayısı

Filter Operator Değerleri

Operatör	Açıklama
EQ	Eşittir
NEQ	Eşit değildir
GT	Büyüktür
LT	Küçüktür
GTE	Büyük veya eşittir
LTE	Küçük veya eşittir
CONTAINS_TOKEN	İçerir (metin araması)
NOT_CONTAINS_TOKEN	İçermez

Kullanım Örneği

Kapanmış (won) fırsatları bulmak için:

• Object Type: deals
• Filter Property: dealstage
• Filter Operator: EQ
• Filter Value: closedwon

---

HubSpot AI Asistan

Doğal dil sorgusuyla HubSpot CRM verilerini sorgular. Karmaşık filtreler yazmadan veri analizine ulaşmak için idealdir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak HubSpot bağlantısı
Query	Evet	Doğal dilde CRM sorgusu
System Prompt	Hayır	AI asistanının davranışını özelleştiren sistem talimatı

Kullanım Örneği

Query: "Bu ay kapanması beklenen fırsatların toplam değeri nedir?"

System Prompt: "Yalnızca aktif pipeline'daki fırsatları dikkate al. Sonuçları Türkçe ve Türk lirası cinsinden ver."

---

Kişi Getir (ID ile)

Belirli bir HubSpot Contact ID'si ile tek bir kişinin detaylı bilgilerini döndürür.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak HubSpot bağlantısı
Contact ID	Evet	HubSpot'taki kişi kaydının sayısal ID'si
Properties	Hayır	Getirilecek alan adları (virgülle ayrılmış)

Contact ID Nasıl Bulunur?

"Kişileri Getir" veya "Nesne Ara" operasyonlarının çıktısındaki id alanı doğrudan kullanılabilir. HubSpot web arayüzünde kişi kaydını açtığınızda URL'de de görünür: app.hubspot.com/contacts/{portal-id}/contact/{contact-id}.

---

Fırsat Getir (ID ile)

Belirli bir HubSpot Deal ID'si ile tek bir fırsatın detaylı bilgilerini döndürür.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak HubSpot bağlantısı
Deal ID	Evet	HubSpot'taki fırsat kaydının sayısal ID'si
Properties	Hayır	Getirilecek alan adları (virgülle ayrılmış)

Deal ID Nasıl Bulunur?

"Fırsatları Getir" veya "Nesne Ara" operasyonlarının çıktısındaki id alanı kullanılabilir. HubSpot URL'si: app.hubspot.com/contacts/{portal-id}/deal/{deal-id}.

---

Şirketleri Getir

HubSpot CRM'deki tüm şirket (company) kayıtlarını döndürür.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak HubSpot bağlantısı
Properties	Hayır	Getirilecek şirket özellikleri (virgülle ayrılmış alan adları)
Get All (Auto Paginate)	Hayır	Tüm sayfaları otomatik getirir
Limit	Hayır	Döndürülecek maksimum şirket sayısı

Properties Örnekleri

name, domain, industry, city, country, phone, numberofemployees, annualrevenue, createdate

---

Hızlı Başlangıç Örnekleri

Örnek 1: Günlük Satış Raporu

Her sabah kapanmak üzere olan fırsatları özetleyip Slack'e gönderen workflow:

Schedule (Her sabah 08:00) → Nesne Ara → LLM (özetle) → Slack Mesajı

Nesne Ara ayarları:

• Object Type: deals
• Filter Property: closedate
• Filter Operator: LTE
• Filter Value: {{bugun+7gün}}
• Properties: dealname,amount,dealstage,hubspot_owner_id

---

Örnek 2: Yeni Müşteri Karşılama

CRM'e yeni eklenen kişiyi bulup kişiselleştirilmiş hoş geldin e-postası gönderen workflow:

Webhook (HubSpot tetikleyici) → Kişi Getir (ID ile) → LLM (e-posta yaz) → E-posta Gönder

Kişi Getir (ID ile) ayarları:

• Contact ID: {{webhook.contact_id}}
• Properties: firstname,lastname,email,company,jobtitle

---

Örnek 3: Satış Ekibi AI Asistanı

Satış ekibinin doğal dille CRM'i sorgulamasını sağlayan chatbot:

Metin Girişi → HubSpot AI Asistan → Metin Çıktısı

HubSpot AI Asistan ayarları:

• Query: {{input.text}}
• System Prompt: "Sen bir satış analisti asistanısın. Türkçe yanıt ver. Para birimini TL olarak göster. Kişisel verileri maskeleyerek yanıtla."

---

Örnek 4: Şirket Profili Oluşturma

Bir şirket adından tam CRM profilini çıkaran workflow:

Metin Girişi (şirket adı) → Nesne Ara → Kişileri Getir → LLM (profil oluştur) → Metin Çıktısı

Nesne Ara ayarları:

• Object Type: companies
• Filter Property: name
• Filter Operator: CONTAINS_TOKEN
• Filter Value: {{input.text}}
• Properties: name,domain,industry,numberofemployees,annualrevenue

---

Sık Karşılaşılan Hatalar

Hata	Olası Neden	Çözüm
401 Unauthorized	Token geçersiz veya süresi dolmuş	HubSpot'ta Private App token'ını kontrol edin; gerekirse yenileyin
403 Forbidden	Token'ın gerekli scope izni yok	Private App ayarlarından gerekli CRM izinlerini ekleyin
404 Not Found	Geçersiz Contact ID veya Deal ID	ID'nin doğru olduğunu "Kişileri Getir" ile doğrulayın
429 Too Many Requests	API rate limit aşıldı	HubSpot API günlük 250.000 istek limitine sahiptir; workflow sıklığını azaltın
INVALID_FILTER_VALUE	Filtre değeri beklenen formatta değil	Filter Value'nun ilgili alan tipine (metin, sayı, tarih) uygun olduğunu kontrol edin
Boş sonuç (results: [])	Filtre koşuluna uyan kayıt yok	Filter Property ve Filter Value değerlerini kontrol edin

---