HubSpot CRM Entegrasyonu

Giriş

3CX, CRM için 3CX API aracılığıyla HubSpot ile aşağıdaki özelliklerle özelliklerle entegrasyon sağlar:

  • Arayan Kimliğinden Kişi Adına - gelen aramalar bir HubSpot kişi aramasını tetikler.
  • 3CX Webclient'ta bir isim aradığınızda HubSpot'ta İsim, Numara veya E-postaya göre Kişi Arama
  • Çağrı ve Sohbet Günlüğü - çağrılar ve sohbetler, CRM çağrı kayıtları olarak HubSpot İletişim Kartına kaydedilir.
  • Yeni numaralardan gelen çağrılar için 3CX istemcisinden yeni bir HubSpot kişisi oluşturun.
  • Tıkla ve Ara - Google Chrome ve Microsoft Edge için 3CX Click2Call Tarayıcı eklentilerini kullanarak, 3CX üzerinden doğrudan HubSpot üzerinden aramaları başlatın.

HubSpot CLI ile HubSpot CRM’yi Yapılandırın

HubSpot, Geliştirici Platformu arayüzünden yeni eski tip Genel Uygulamaların oluşturulmasını sonlandırmıştır. Artık yeni HubSpot uygulamaları, HubSpot’un Projeler çerçevesini ve HubSpot CLI’yi kullanarak oluşturulmalıdır.

Bu rehber, 3CX HubSpot CRM entegrasyonu için gerekli olan HubSpot OAuth uygulamasının nasıl oluşturulacağını açıklamaktadır.

Not: Mevcut eski tip Genel Uygulamalar çalışmaya devam etmektedir.

Adım 1: HubSpot Yapılandırma

HubSpot projesini oluşturmadan önce, 3CX sistemine erişim için kullanılan genel URL’yi belirleyin.

Örneğin, 3CX Yönetici Konsolu’na şu adres üzerinden erişiliyorsa:

https://mypbx.3cx-example.com

...o zaman HubSpot OAuth yönlendirme URL’si şu şekilde olmalıdır:

https://mypbx.3cx-example.com/api/oauth2crm

Adım 2: HubSpot CLI’yı Kurun

HubSpot CLI, bir Node.js uygulamasıdır; bu nedenle öncelikle npm ile birlikte Node.js’in yüklenmesi gerekir.

HubSpot CLI 8 Node.js 20 veya daha yeni bir sürüm gerektirir.

  • Yeni bir Komut İstemi penceresi açın.
  • Komut İsteminde şunu çalıştırın:

npm install -g @hubspot/cli@latest

  • Kurulum bitince HubSPot CLI sürümünü kontrol edin:

hs --version

  • A HubSpot CLI sürümü görüntülenmeli.

Adım 3: CLI’dan HubSpot’a Giriş Yapın

  • Komut İsteminde çalıştırın:

hs account auth

CLI, HubSpot hesabınızın kimlik doğrulama işlemini adım adım yönlendirecektir. Talimatları izleyin:

  • İstenirse, HubSpot hesabına kolayca tanınabilir bir yerel ad verin.
  • Bir tarayıcı penceresi açılacak veya CLI, HubSpot’u açmak için gerekli talimatları gösterecektir.
  • Projenin/uygulamanın oluşturulacağı HubSpot hesabına giriş yapın.

  • İstenen Kişisel Erişim Anahtarını oluşturun.
  • Anahtar, terminal penceresine otomatik olarak döndürülmelidir.
  • CLI, Kişisel Erişim Anahtarını terminale yapıştırmanızı isterse, anahtarı yapıştırın ve Enter tuşuna basın.
  • İstenirse bir hesap adı girin.
  • Bunun varsayılan hesap olup olmayacağı sorulursa, Evet’i seçin.

Adım 4: Çağrı ve Sohbet Günlüğünü Yapılandırın

  • Komut İsteminde
  • Bir proje klasörü oluşturun, ör:

mkdir C:\HubSpotProjects

cd /d C:\HubSpotProjects

  • Bu klasörde çalıştırın:

hs project create --project-base app --distribution private --auth oauth

  • CLI ilave bilgi soracak.

  • Proje adı, örnek: "3CX HubSpot Entegrasyonu"
  • Yerel klasör, varsayılan ya da "3cx-hubspot" gibi basit bir şey kullanılan
  • Özellikler
  • 3CX CRM entegrasyonu için HubSpot Uygulama Kartı, webhook, iş akışı eylemi, ayarlar sayfası veya başka bir proje özelliği gerekmez. CLI sizden özellik seçmenizi isterse, tüm özelliklerin seçimini kaldırın ve Enter tuşuna basarak devam edin.

  • Komut tamamlandıktan sonra yeni bir klasör olmalı, ör:  "C:\HubSpotProjects\3cx-hubspot"
  • Şu klasöre değiştirin:

cd /d C:\HubSpotProjects\3cx-hubspot

  • Önemli dosyalar şunları içermeli:

C:\HubSpotProjects\3cx-hubspot\hsproject.json

C:\HubSpotProjects\3cx-hubspot\src\app\app-hsmeta.json

Adım 5: 3CX için OAuth ve gerekli kapsamları yapılandırın

Aşağıdaki dosyayı Notepad’te açın: "C:\HubSpotProjects\3cx-hubspot\src\app\app-hsmeta.json".

Oluşturulan dosya, göz ardı edilebilecek ek özellikler içerebilir; önemli olan kısım, uygulamanın yapılandırması ve özellikle de kimlik doğrulama bölümüdür.

Aşağıda gösterildiği gibi, “https://pbx.example.com/api/oauth2crm” ifadesini 1. Adımda belirlediğiniz gerçek 3CX genel URL’siyle değiştirerek, distribution, requiredScopes ve redirectUrls ayarlarını uygulamanız için yapılandırın.

{

  "uid": "3CXHubSpotIntegration_app",

  "type": "app",

  "config": {

    "description": "OAuth application for the 3CX HubSpot CRM integration",

    "name": "3CX HubSpot Integration-App",

    "distribution": "private",

    "auth": {

      "type": "oauth",

      "redirectUrls": [

        "https://pbx.example.com/api/oauth2crm"

      ],

      "requiredScopes": [

      "oath",

           "crm.objects.contacts.read",

                "crm.objects.contacts.write",

                "crm.objects.companies.read",

                "crm.objects.owners.read",

                "timeline"

      ],

      "optionalScopes": [],

      "conditionallyRequiredScopes": []

    },

    "permittedUrls": {

      "fetch": [

        "https://api.hubapi.com"

      ],

      "iframe": [],

      "img": []

    },

    "support": {

      "supportEmail": "[email protected]",

      "documentationUrl": "https://example.com/docs",

      "supportUrl": "https://example.com/support",

      "supportPhone": "+18005555555"

    }

  }

}

Adım 6: Projeyi Doğrulayın ve HubSpot’a yükleyin

  • Proje klasöründen çalıştırın:

hs project validate

  • Doğrulama başarılı olursa devam edin.
  • Doğrulama bir hata bildirirse, belirtilen JSON özelliğini düzeltin ve komutu tekrar çalıştırın.
  • Sonra çalıştırın:

hs project upload

  • Proje ilk kez yüklendiğinde HubSpot şuna benzer bir mesaj gösterebilir:

  • “Bu hesapta proje mevcut değil. Oluşturmak ister misiniz?”
  • “E” yanıtını verin ve devam edin.
  • CLI şunları gerçekleştirecektir:
  • dosyaları yükleyecek
  • bir HubSpot derlemesi oluşturacak
  • uygulamayı yükleyecek

Adım 7: HubSpot’ta İstemci Kimliği ve İstemci Gizli Anahtarını Alın

  • Tarayıcınızda HubSpot hesabınıza giriş yapın ve Geliştirme > Projeler‘e gidin.
  • 3CX HubSpot Entegrasyonu’nu (veya oluşturduğunuz proje adını) açın.
  • Proje Bileşenleri altında, uygulamanın adını tıklayın.
  • Kimlik Doğrulama sekmesini açın.

  • HubSpot, aşağıdaki İstemci kimlik bilgilerini gösterecektir:
  • İstemci Kimliği
  • İstemci Gizli Anahtarı
  • Her iki değeri de güvenli bir yere kaydedin.

Adım 8: Özel OAuth Uygulamasına ek HubSpot CRM hesapları ekleyin (İsteğe bağlı)

Bu, eski Public App prosedürüne kıyasla önemli bir yeni adımdır.

Proje “distribution”: ‘private’ ayarıyla oluşturulduğu için HubSpot, yalnızca açıkça onaylanmış hesaplar için OAuth yetkilendirmesine izin vermektedir. Varsayılan olarak, yalnızca uygulamayı oluşturan hesap erişim hakkına sahiptir (“private”).

HubSpot'ta:

  • Geliştirme’yi açın.
  • Projeler'i açın.
  • 3CX projesini açın.
  • Proje Bileşenleri altında 3CX uygulamasını seçin.

  • Dağıtım sekmesini açın.
  • “Onaylanmış hesap(lar) ekle”ye tıklayın.
  • Mevcut üretim hesapları altından, 3CX ile entegre edilecek kişileri ve şirketleri içeren HubSpot CRM hesabını seçin.
  • HubSpot giriş bilgilerinizle hem geliştirme hesabına hem de şirketin normal CRM hesabına erişiminiz varsa, gerçek müşteri verilerini içeren CRM hesabının onaylandığından emin olun.
  • Değişiklikleri kaydete tıklayın.

3CX'te HubSpot'u Yapılandırın ve Yetkilendirin

  1. 3CX Yönetici Konsolu'nda “Entegrasyonlar” > “CRM”e gidin.
  2. Açılır listeden “HubSpot”u seçin.
  3. İstediğiniz Kişi Arama Sırasını seçin.
  4. “İstemci Kimliği” ve “İstemci Gizli Anahtarı” alanlarına, uygulamanızdan daha önce kopyaladığınız OAuth değerlerini girin.
  5. Kaydet'e tıklayın.
  6. Yetkilendir'e tıklayın.

  • Bir HubSpot yetkilendirme sayfası açılmalıdır.
  • Gerekirse HubSpot’a giriş yapın.
  • 3CX tarafından kullanılacak kişi ve şirketleri içeren HubSpot CRM hesabını seçin.
  • İstenen izinleri inceleyin.
  • HubSpot, uygulamanın doğrulanmamış olduğu konusunda uyarıda bulunabilir. Bu durum, kendi hesabınız için oluşturulmuş ve HubSpot Marketplace'e gönderilmemiş bir uygulama için normaldir.
  • Kurulumu/yetkilendirmeyi onaylayın.
  • 3CX artık OAuth yetkilendirme kodunu alır ve bunu HubSpot OAuth jetonlarıyla değiştirir.
  • 3CX Yönetici Konsolu'nda HubSpot CRM için “Jetonu Yenile” alanının otomatik olarak doldurulduğunu doğrulayın.
  • 3CX istemcisinden kişi oluşturma özelliğini etkinleştirmek istiyorsanız, bu seçeneği işaretleyin. Arayanın numarası bir kişiyle eşleştirilemediğinde, 3CX istemcisi, kullanıcının bir iletişim kutusuna ayrıntıları girerek kişi oluşturmasına izin verir.

e164 Kişilerini ve Arayan Kimliğini Yapılandırın

  1. HubSpot ile eşleşme sağlanabilmesi için, gelen Arayan Kimliği’nin ön ek dahil olmak üzere CRM kaydıyla tam olarak aynı olması gerekir; zira HubSpot, numaraları tam olarak arar. Rakamların bir kısmını kullanarak HubSpot’ta sorgulama yapıldığında herhangi bir veri döndürülmez.
  2. HubSpot entegrasyonunun çalışması için, numaraları HubSpot’ta E164 formatında kaydetmeniz ve SIP Trunk’ınızın da arayanın numarasını E164 formatında sağlaması gerekir; böylece her ikisi de eşleşir. Aksi takdirde, arayanın numarasını CRM'ye aktarılmadan önce ayarlamak için Arayan Kimliği Yeniden Biçimlendirme özelliğini kullanabilirsiniz.
  3. Şimdi Sistem > Telefon Defteri > Seçenekler'e gidin, eşleştirme stratejisini “Tam olarak eşleştir” olarak ayarlayın ve “Tamam”ı tıklayın.

Transkripsiyon dahil olmak üzere Arama ve Sohbet Günlüğü Ayarlarını Yapılandırın

  • Dış aramaları ve sohbetleri HubSpot’a bildirmek için, 3CX dahili numarası için yapılandırılan e-posta adresinin bir HubSpot kullanıcısının e-posta adresiyle eşleşmesi gerekir. Bu sayede 3CX, aramayı veya sohbeti alan 3CX dahili numarasını ilgili HubSpot kullanıcısıyla eşleştirebilir.
  • Dış aramaları CRM'ye bildirmek için “Arama Günlüğünü Etkinleştir” seçeneğini işaretleyin ve şu “Arama Günlüğü” parametrelerini yapılandırın:
  • Arama Konusu - aramanın konusu.
  • Cevaplanan Gelen Arama - cevaplanan gelen aramalar için açıklama.
  • Cevapsız Arama - cevapsız aramalar için açıklama.
  • Cevaplanan Giden Arama - cevaplanan giden aramalar için açıklama.
  • Cevaplanmayan Giden Arama - cevaplanmayan giden aramalar için açıklama.
  • “Arama Günlüğü” parametrelerinde
    [değişken_adı]
    şeklinde belirtilen değişkenleri kullanabileceğinizi lütfen unutmayın; örneğin, harici numara
    [Number]
    olarak belirtilir. Kullanılabilecek değişkenler     burada listelenmiştir.

  • Sohbetleri CRM'ye aktarmak istiyorsanız, “Sohbet Günlüğünü Etkinleştir” onay kutusunu işaretleyin ve aşağıdaki parametreleri yapılandırın:
  • Sohbet Konusu - sohbet oturumunun konusu.
  • “Sohbet Günlüğü” parametrelerinde [kod][değişken_adı][/kod] şeklinde belirtilen değişkenleri kullanabileceğinizi lütfen unutmayın; örneğin, harici numara [kod][Numara][/kod] olarak belirtilir. Kullanılabilecek değişkenler burada listelenmiştir.

Ayrıca Bakınız

Son Güncelleme

Bu belge en son 26 Ağustos 2026 tarihinde güncellendi

https://www.3cx.com.tr/docs/hubspot-crm-entegrasyonu/