CRM Entegrasyonu Nasıl Yapılır? Webhook ve API Rehberi

CRM entegrasyonu nasıl yapılır sorusunun üç yanıtı var: hazır bağlayıcı, webhook ve API. Konu CRM otomasyonu işinin temelidir: CRM otomasyonu; web formu, WhatsApp, sosyal medya ve e-ticaret sitesinden gelen taleplerin CRM'de tek kayda düşürülmesi, sınıflandırılması ve ilk yanıtın beklemeden gönderilmesidir. Bu yazı her yolun ne zaman işe yaradığını ve bağlantının nasıl güvenli tutulacağını anlatır.

Kısa cevap: CRM entegrasyonu üç yoldan biriyle yapılır

CRM entegrasyonu nasıl yapılır diye soruyorsanız seçenekler hazır bağlayıcı, webhook ve API'dir. Hazır bağlayıcı en hızlı kurulan yoldur. Webhook, talebi olay anında CRM'e iletir. API ise CRM'deki veriyi okumanız ya da güncellemeniz gerektiğinde devreye girer.

• Hazır bağlayıcı: CRM'in ya da bir entegrasyon aracının hazır sunduğu bağlantıdır. Kod yazmadan kurulur, ama yalnızca sunulan alanlar ve olaylarla çalışır.
• Webhook: Kaynak sistem bir olay olduğunda sizin verdiğiniz adrese veri gönderir. Yeni talebi yakalamak için en doğal yoldur.
• API: Kendi isteğinizle CRM'e veri yazar ya da CRM'den veri okursunuz. Esnektir, ama kurulum ve bakım emeği ister.

Bu üç yolu karşılaştırırken tek ölçü hız değildir. CRM entegrasyonu nasıl yapılır sorusunun doğru yanıtı, talebin hangi kanaldan geldiğine, ekibinizin kod yazıp yazamayacağına ve hata olduğunda kimin müdahale edeceğine bağlıdır.

Hangi yol ne zaman kullanılır?

Yeni talebi yakalamak istiyorsanız CRM webhook yolunu, CRM'deki bilgiyi başka sisteme almak istiyorsanız API'yi, hızlı ve kodsuz bir çözüm istiyorsanız hazır bağlayıcıyı seçin. Üç yol birbirini dışlamaz; çoğu bağlantıda ikisi birlikte kullanılır.

Bu tabloda maliyet için rakam yok; çünkü maliyet işin kapsamına göre değişir. Sedeus'un çalışma modeli için fiyatlandırma sayfasına bakın. Hangi akışları bağlayacağınızı seçmek için CRM otomasyonu örnekleri yazısındaki 25 akıştan yararlanabilirsiniz.

Webhook nasıl çalışır?

Webhook, bir olay olduğunda kaynak sistemin sizin verdiğiniz adrese otomatik bir HTTP isteği göndermesidir. Form gönderildiğinde ya da WhatsApp mesajı geldiğinde kaynak, JSON gövdeli bir POST isteği atar; alıcı bu veriyi CRM kaydına çevirir.

Aşağıdaki gövde temsilî bir örnektir; gerçek bir kişiye ait değildir ve alan adları sizin kaynağınıza göre değişir.

{
  "kaynak": "web_formu",
  "ad": "Örnek Kişi",
  "telefon": "+905000000000",
  "eposta": "ornek@example.com",
  "mesaj": "Fiyat bilgisi almak istiyorum.",
  "izin": { "ticari_ileti": true, "kayit_zamani": "2026-10-17T10:15:00+03:00" },
  "zaman": "2026-10-17T10:15:00+03:00"
}

Bu gövde yedi bilgi taşır: talebin geldiği yer, kişinin adı, telefonu ve e-postası, mesajı, ticari ileti izni ve olayın zamanı. İzin ile zaman bilgisi önemlidir; çünkü CRM'e yazılan kayıt, kişinin neye ve ne zaman izin verdiğini de göstermelidir.

Her CRM webhook'unun kuralları farklıdır; bu yüzden seçtiğiniz CRM'in belgesindeki webhook bölümünü okuyun. Pipedrive'ın webhook rehberine (yeni sekmede açılır) göre istek JSON biçimindedir ve başarılı teslimat için 2XX durum kodu dönmelidir. Yanıt gelmezse üç kez daha, 3, 30 ve 150 saniye aralıkla denenir; zaman aşımı 10 saniyedir. Üç ardışık gün başarısız olursa webhook silinir. Bu yüzden alıcı adresiniz isteği hızla kabul edip işlemeyi arkaya bırakmalıdır.

Bir CRM webhook'u adım adım nasıl kurulur?

Bir CRM webhook'u kurmak yedi adımdır. CRM entegrasyonu nasıl yapılır sorusunun uygulamadaki karşılığı çoğu zaman bu sıradır.

1. Kaynağı belirleyin: web formu, WhatsApp ya da e-ticaret sitesi.
2. Alıcı adresi hazırlayın; HTTPS kullanın.
3. Kaynakta webhook'u bu adrese bağlayın ve hangi olayların gönderileceğini seçin.
4. Gelen gövdeyi alan eşleştirme tablonuza göre CRM alanlarına çevirin.
5. Kayıt var mı diye arayın; varsa güncelleyin, yoksa oluşturun.
6. Hızlıca 2XX ile yanıt verin ve işlemin sonucunu kayıt günlüğüne yazın.
7. Kendi test kaydınızla deneyin; sonra gerçek talebe açın.

CRM API entegrasyonu ne zaman gerekir? API ile okuma ve yazma

CRM API entegrasyonu, olay gelmesini beklemeden CRM'deki veriyi sorgulamanız gerektiğinde gerekir. Gelen talebin CRM'de zaten kayıtlı olup olmadığını denetlemek, eksik alanı tamamlamak ya da kayıtları başka bir sisteme aktarmak buna örnektir.

CRM API entegrasyonu kurmadan önce üç şeyi netleştirin: hangi veriyi okuyacaksınız, hangi veriyi yazacaksınız ve çağrıyı hangi kimlikle yapacaksınız. Okuma ile yazma yetkisini ayırmak, bir hata olduğunda zararı küçük tutar. CRM webhook'u olayı getirir; API ise o olayın etrafındaki bilgiyi tamamlar.

API çağrılarının sınırı vardır. Pipedrive'ın hız sınırı belgesine (yeni sekmede açılır) göre günlük bütçe 30.000 temel token ile plan çarpanı ve kullanıcı sayısının çarpımından oluşur; bütçe bitince 429 hatası döner. Zoho CRM'in API limitleri belgesinde (yeni sekmede açılır) ise her çağrı genellikle bir kredi düşürür ve limit kayan 24 saatlik pencerede hesaplanır. Bu nedenle olayı webhook ile alın, API'yi yalnızca gereken yerde çağırın.

HubSpot'un webhook yönetimi belgesi (yeni sekmede açılır) de aynı yaklaşımı gösterir: sınır aşılınca 429 yanıtı gelir ve ne zaman yeniden deneneceğini Retry-After başlığı bildirir. Kendi çağrılarınızda bu başlığa saygı gösterin.

Alan eşleştirme ve mükerrer kayıt nasıl yönetilir?

Alan eşleştirme, kaynaktaki her bilginin CRM'de hangi alana yazılacağını önceden belirlemektir. Eşleştirmeyi yazılı bir tablo olarak hazırlarsanız hem kurulum hem sonraki bakım kolaylaşır. Aşağıdaki tablo yukarıdaki gövdeye göre örnek bir eşleştirmedir.

Eşleştirme tablosunu CRM API entegrasyonu için de kullanabilirsiniz; aynı tablo hem CRM webhook gövdesini hem API çağrısının alanlarını belirler. Alan adlarını CRM'in belgesindeki adlarla birebir yazın.

Eşleştirmede iki hata sık görülür: telefon numarasını her kaynaktan farklı biçimde yazmak ve mesajı kişinin adına bağlı bir alanın üzerine yazmak. İlki mükerrer kayda, ikincisi veri kaybına yol açar.

Mükerrer kayıt nasıl önlenir?

Mükerrer kaydı önlemenin yolu, kaydı oluşturmadan önce eşsiz bir anahtarla aramaktır. E-posta ve biçimi düzeltilmiş telefon numarası bu anahtar olarak kullanılır. Kayıt varsa yeni kişi açmayın; mevcut kişiye etkinlik ya da güncelleme ekleyin.

• Önce ara, sonra yaz: CRM'inizin belgesinde hangi alanın tekil kabul edildiğine ve güncelleme ile oluşturmanın tek istekle yapılıp yapılamadığına bakın.
• Biçimi tek tipe indirin: Aynı telefon farklı yazılırsa arama kaçırır.
• Olay kimliğini saklayın: Yeniden deneme, aynı olayın ikinci kez gelmesine neden olabilir. Daha önce işlenmiş kimliği görürseniz isteği tekrar işlemeyin.
• Kaynak alanını koruyun: Aynı kişi hem formdan hem WhatsApp'tan yazarsa iki kayıt değil, iki etkinlik oluşmalıdır.

Bağlantı nasıl güvenli olur?

Güvenli bağlantı için isteğin kimden geldiğini doğrulayın, eski isteği reddedin ve her çağrıyı kaydedin. Uygulamada bu, imzalı webhook, zaman damgası denetimi, tekrar deneme yönetimi ve kayıt günlüğü demektir.

• İmzalı webhook ve HMAC: HMAC, gönderenle alıcının paylaştığı gizli bir anahtarla isteğin içeriğinden üretilen imzadır. Alıcı aynı imzayı kendisi üretir; uyuşmazsa isteği reddeder. HubSpot'un istek doğrulama belgesine (yeni sekmede açılır) göre X-HubSpot-Signature-v3 başlığı HMAC SHA-256 ile üretilir ve zaman damgası 5 dakikadan eski istekler reddedilmelidir. Pipedrive isteğe bağlı olarak her istekte Basic Authentication bilgisi gönderir; Zoho CRM ise bildirimle birlikte isteğe bağlı bir token geri yollar.
• Sedeus'ta uygulama: Entegrasyon Marketi'ndeki modüllerde sitemiz ile iş akışı sunucusu arasındaki çağrılar HMAC-SHA256 ile imzalanır ve zaman damgası taşır; 5 dakikadan eski istek reddedilir.
• Tekrar deneme: Kaynak başarısız isteği yeniden gönderir. Alıcınız aynı olayı iki kez görebileceğini varsaymalı ve hızlı bir 2XX ile yanıt vermelidir.
• Kayıt günlüğü: Her isteğin zamanını, kaynağını ve sonucunu kaydedin. Hata olduğunda nerede koptuğunu bu günlükten görürsünüz. Telefon ve e-posta gibi kişisel veriyi günlüğe tam yazmayın, maskeleyin.

Kayıt günlüğüne bakarak her CRM webhook'unu üç soruyla izleyin: istek geldi mi, CRM'e yazıldı mı, yazılmadıysa neden? Bu üç sorunun yanıtı hazırsa CRM entegrasyonu nasıl yapılır sorusunun bakım tarafı da çözülmüş olur. Başarısız kayıtlar için bir uyarı kuralı ekleyin; günlüğe yalnızca arada bakılan bir bağlantı, sessizce talep kaybeder.

Bağlantı bozulmadan önce hatayı yakalamak için API entegrasyon hatalarını önleme yazısındaki test yaklaşımına da bakabilirsiniz.

KVKK açısından nelere dikkat edilmeli?

CRM entegrasyonu kişisel veriyi iki sistem arasında taşıdığı için KVKK kapsamındaki yükümlülükleri de taşır. Yalnızca gereken alanları aktarın, izin bilgisini kayıtla birlikte saklayın ve ticari ileti için ret yolunu açık tutun.

• Aktarılacak alanları baştan sınırlayın; formda sormadığınız bilgiyi gövdeye eklemeyin.
• İzin alanını ve izin zamanını CRM'de ayrı tutun; izni olmayan kişiyi ticari ileti akışına almayın.
• Günlüklerde kişisel veriyi maskeleyin ve günlüğü ne kadar saklayacağınızı önceden belirleyin.
• Kaynak ve hedef sistemin kişisel veriyi nerede işlediğini sözleşmeler ve gizlilik metinleriyle uyumlu tutun.

Bu başlık hukuki görüş değildir; yükümlülükleriniz için hukuk danışmanınıza başvurun.

Hangi yolun işletmenize uyduğundan emin değilseniz ücretsiz sistem analizi ile talep yollarınızı ve CRM'inizi birlikte inceleyelim.

Sık sorulan sorular