Salesforce CRM Entegrasyonu

Giriş

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

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

Gereksinimler:

  • Salesforce hesabınızda REST API etkin olmalıdır. Hangi Salesforce sürümlerinde API mevcut öğrenmek için burayı kontrol edin.
  • Kişi Hesapları etkinleştirilmiş Salesforce hesapları desteklenmez.

Adım 1: Salesforce’u Yapılandırın

  1. Salesforce hesabınıza giriş yapın https://login.salesforce.com/ veya buradan bir geliştirici hesabı oluşturun https://developer.salesforce.com/signup.
  2. “Dişli simgesi” > “Kurulum.” üzerine tıklayın.
  3. Kenar çubuğunda, PLATFORM ARAÇLARI bölümünün altında “Uygulamalar > Uygulama Yöneticisi”ni seçin.
  4. Web sayfasının sağ üst köşesindeki “Yeni Harici İstemci Uygulaması” butonuna tıklayın.
  5. "Harici İstemci Uygulama Yöneticisi” formu karşınıza gelecektir.

  1.  Temel Bilgiler panelinde, bir Harici İstemci Uygulaması adı, bir İletişim e-postası ve Dağıtım Durumu sağlayın.

  1. Aşağı kaydırarak API'ye (OAuth Ayarlarını Etkinleştir) gidin ve “OAuth Etkinleştir” onay kutusunu işaretleyin.
  2. Geri Arama URL’si alanına, 3CX yönetici konsoluna erişmek için kullandığınız URL’yi girin ve sonuna “/api/oauth2crm” ekleyin, örneğin: “https://my-pbx.example.com/api/oauth2crm”. Ardınan, yukarıdaki görselde gösterildiği gibi izinleri verin. İzinler şunlardır:
  • Access the identity URL service (id, profile, email, address, phone)
  • Access unique user identifiers (openid)
  • Full Access (full)
  • Manage user data via APIs (api)
  • Manage user data via Web browsers (web)
  • Perform requests at any time (refresh_token, offline_access)
  1. Güvenlik bölümüne gidin, "Require Secret for Web Server Flow" ve “Require Secret for Refresh Token Flow” seçeneklerinin seçildiğinden emin olun.
  2. Ayrıca, PKCE (Proof Key for Code Exchange) artık 3CX Sürüm 20, Güncelleme 6’da desteklendiğini unutmayın. “Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows” seçeneğini etkinleştirerek PKCE kimlik doğrulama akışını kullanabilirsiniz. Bu seçenek devre dışı bırakılırsa, PKCE yok sayılır ve yetkilendirme başarıyla gerçekleşir.
  3. Create düğmesine basın.
  4. Listeden “Apps > External Client App Manager> Find your app” seçeneğine tıklayın ve “Edit Policies”e tıklayın.

  1. Policies altında 0Auth policies bölümüne gidin ve İzin verilen kullanıcılar’ı “All users can self-authorize” olarak ayarlayın.
  2. Save düğmesine basın.

  1. Ayarlar altında, 0Auth Settings bölümüne gidin ve “Consumer Key and Secret” butonuna tıklayın. Ardınan, “Consumer Key” ve “Consumer Secret” değerlerini kopyalayın; bunları daha sonra 3CX CRM entegrasyon bölümüne eklemeniz gerekecek.

Adım 2: 3CX'i Yapılandırın

  1. 3CX Yönetici Konsolunda “Entegrasyonlar” > “CRM” bölümüne gidin.
  2. Açılır listeden "SalesforceV2”yi seçin.
  3. Önceki adımda aldığınız Consumer Key ve Consumer Secret bilgilerini girin ve yetkilendirme sürecini başlatmak için “Kaydet" düğmesine ve ardından "Authorize" düğmesine basın. 3CX'e erişim izni verin; Refresh Token altında Yenileme Simgesi gösterilecektir.

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

  1. Harici aramaları ve sohbetleri Salesforce'a bildirmek için, 3CX kullanıcısı için yapılandırılan e-posta adresi bir Salesforce kullanıcısının e-posta adresiyle eşleşmelidir. Bu şekilde 3CX, aramayı veya sohbeti alan 3CX kullanıcısını Salesforce kullanıcısına eşleyebilir.
  2. Harici aramaları CRM'e bildirmek için “Enable Call Journaling” seçeneğini işaretleyin ve şu “Call Journaling” parametrelerini yapılandırın:
  • “Call Subject” - çağrının konusu.
  • “Answered Inbound Call” - cevaplanan gelen çağrılar için açıklama.
  • “Missed Call” - cevaplanmayan çağrılar için açıklama.
  • “Answered Outbound Call” - cevaplanan giden çağrılar için açıklama.
  • “Unanswered Outbound Call” - cevaplanmayan giden çağrılar için açıklama.
  1. Lütfen "Call Journaling" parametrelerinde
    [variable_name]
    olarak belirtilen değişkenleri kullanabileceğinizi unutmayın, örneğin harici numara
    [Number]
    olarak belirtilir. Kullanılabilir değişkenler     burada listelenmiştir.

  1. Sohbetleri CRM'e raporlamak istiyorsanız Enable Chat Journaling onay kutusunu işaretleyin ve aşağıdaki parametreleri yapılandırın:
  • Chat Subject: Sohbet oturumunun konusu.
  1. Lütfen "Chat Journaling" parametrelerinde
    [variable_name]
    olarak belirtilen değişkenleri kullanabileceğinizi unutmayın, örneğin harici numara
    [Number]
    olarak belirtilir. Kullanılabilir değişkenler     burada listelenmiştir.

Adım 4: e164 Kişilerini ve Arayan Kimliğini Yapılandırın

  1. Salesforce ile eşleşme elde etmek için, gelen Arayan Kimliğinin son 7 hanesinin CRM girişindeki telefon alanının son 7 hanesi ile eşleşmesi veya SIP Trunk'tan alınan tam numaranın CRM'deki telefon numarasıyla tam olarak eşleşmesi gerekir.
  2. Salesforce, numaraları E164 formatında saklayabilir; bu nedenle, SIP Trunk'ınız arayanın numarasını da E164 formatında sağlıyorsa, tam eşleşme tercih edilir. Ayrıca, arayanın numarasını CRM’e iletilmeden önce ayarlamak için Arayan Kimliği Yeniden Biçimlendirme özelliğini de kullanabilirsiniz.
  3. ⚠ Önemli: 3CX Yönetici Konsolunda “Sistem” > “Telefon Rehberi” > “Seçenekler”e gidin. Eşleştirme stratejisini mümkün olduğunda "Match exactly" (Salesforce ve SIP Trunk'ta E164 formatı gereklidir) veya "Match at least X number of characters" olarak ayarlayın ve değeri 7 olarak ayarlayın.
  4. ⚠ Önemli: Salesforce'ta tüm kişilerinizin numaralarının artı (+) öneki de dahil olmak üzere E164 formatında saklandığından emin olun. Bu artı (+) öneki, ABD veya Kanada'da bulunuyorsanız numarayı otomatik olarak yeniden biçimlendirmesini ve kişi aramasının başarısız olmasını önler.

Adım 5: Kişi Oluşturmayı Yapılandırın

  1. Bilinmeyen bir numaradan (hem 3CX'te hem de CRM'de bulunmayan) bir arama geldiğinde CRM'de yeni kişiler oluşturmak istiyorsanız, "Allow contact creation directly to your CRM using 3CX Web Client" onay kutusunu işaretleyin ve aşağıdaki parametreleri yapılandırın.
  2. Kişi Oluşturma parametreleri şunlardır:
  • Create Lead or Contact - Oluşturulacak varlık (Potansiyel Müşteri/İrtibat Kişisi).
  • New Lead Company - Bir Potansiyel Müşteri oluşturulduğunda şirketin adı.
  1. Parametrelerde değişken kullanabileceğinizi lütfen unutmayın. Değişkenler [] arasında belirtilir, örneğin harici numara [Number] olarak belirtilir. Kullanılabilir değişkenler burada listelenmiştir.
  2. Arayanın numarası bir kişiyle eşleştirilemediğinde, 3CX istemcisi kullanıcının bir iletişim kutusunda ayrıntıları doldurarak kişiyi oluşturmasına olanak tanır.

📄Not: Salesforce'ta kişi oluştururken, Web İstemcisinde belirtilen şirket adı dikkate alınmayacaktır. Bu, Salesforce API sınırlamalarından kaynaklanmaktadır. Bu durum yalnızca kişiler için geçerlidir; şirket adı potansiyel müşteri oluştururken ayarlanır.

Ayrıca Bakınız

Son Güncelleme

Bu belge son olarak 16 Temmuz 2025'te güncellendi

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