Bitrix24 entegrasyonu, web sitenizi, formlarınızı veya iş uygulamalarınızı Bitrix24 CRM'e bağlayarak potansiyel müşteri, kişi ve anlaşma kayıtlarını otomatik oluşturmak ve CRM'deki olaylardan haberdar olmaktır. Kod yazmanın en kısa yolu Bitrix24'ün gelen ve giden webhook'larıdır.

İlgili içerikler: CRM entegrasyonu rehberi · HubSpot entegrasyonu · Zoho CRM entegrasyonu

Gelen Webhook Oluşturma

Gelen Webhook Oluşturma: Developer resources, Other, Inbound webhook yolundan yeni webhook açın., "Assign permissions" bölümünde gereken izni seçin (CRM için crm) ve kaydedin...
  • Developer resources, Other, Inbound webhook yolundan yeni webhook açın.
  • "Assign permissions" bölümünde gereken izni seçin (CRM için crm) ve kaydedin.
  • Size verilen adres biçimi: https://{portal}.bitrix24.com/rest/{user_id}/{webhook_code}/{metot}.json

Webhook, onu oluşturan çalışanın yetkileriyle ve seçilen izinler içinde çalışır. Kimlerin webhook oluşturabileceği yönetici ayarlarından belirlenir.

Kayıt Oluşturma: crm.item.add

Belgeye göre crm.lead.add metodunun geliştirilmesi durduruldu; yerine evrensel crm.item.add öneriliyor. Varlık türü entityTypeId ile seçilir:

entityTypeIdVarlık
1Potansiyel müşteri (Lead)
2Anlaşma (Deal)
3Kişi (Contact)
4Şirket (Company)
bash
curl -X POST "https://PORTAL.bitrix24.com/rest/1/WEBHOOK_KODU/crm.item.add.json" \
  -H "Content-Type: application/json" \
  -d '{"entityTypeId":1,"fields":{"title":"Web formu","name":"Ayşe","lastName":"Yılmaz","fm":[{"typeId":"EMAIL","valueType":"WORK","value":"ayse@ornek.com"}]}}'
  • Alan adları camelCase yazılır (title, name, lastName, assignedById); özel alanlar ufCrm ile başlar.
  • Telefon ve e-posta fm dizisinde gönderilir.
  • Belgeye göre hatalı alan adları hata vermeden yok sayılır. Kaydı oluşturduktan sonra alanların yazıldığını kontrol edin.

Mükerrer Kontrolü

crm.duplicate.findbycomm metodu e-posta veya telefona göre mevcut potansiyel müşteri, kişi ve şirket kimliklerini döndürür. Tek istekte en fazla 20 değer sorgulanabilir. Formdan gelen kaydı oluşturmadan önce bu metotla kontrol edin.

Giden Webhook ve Olaylar

Giden Webhook ve Olaylar: Giden webhook, Developer resources, Other, Outbound webhook yolundan, işleyici..., localhost ve kendinden imzalı sertifikalı adresler kabul edilmez...
  • Giden webhook, Developer resources, Other, Outbound webhook yolundan, işleyici adresi ve olay seçilerek kurulur (ör. ONCRMLEADADD, ONCRMDEALUPDATE).
  • localhost ve kendinden imzalı sertifikalı adresler kabul edilmez.
  • Gelen her istekteki auth[application_token] değerini doğrulayın.
  • ONCRMLEADADD olayı yalnızca kaydın kimliğini taşır; ayrıntı için ayrıca API çağrısı yapılır.

İstek Sınırları

İstek Sınırları

Bitrix24 sızdıran kova modeli kullanır: Enterprise planda eşik 250, saniyede 5 azalır; diğer planlarda eşik 50, saniyede 2 azalır. Eşik aşılınca 503 QUERY_LIMIT_EXCEEDED, bir metodun toplam çalışma süresi aşılınca 429 OPERATION_TIME_LIMIT döner. batch metoduyla tek istekte en fazla 50 komut gönderilebilir.

CRM Formları

Bitrix24'ün kendi CRM formları CRM, Sales, Sales channels, CRM forms altında yer alır. Formun ayarlarındaki gömme kodu ile başka sitelere sayfa içi blok veya açılır pencere olarak eklenebilir.

Veri Merkezi

Bitrix24 durum sayfasına göre .com.tr hesapları Almanya'da barınıyor; .com hesapları ABD'de. Türkiye içinde veri merkezi bulunmuyor.

Sık Sorulan Sorular

crm.lead.add hâlâ çalışıyor mu?

Belgede geliştirmesinin durdurulduğu yazıyor. Yeni entegrasyonlarda crm.item.add ve entityTypeId=1 kullanın.

503 alıyorum, ne yapmalıyım?

İstek sınırını aşmışsınız. İstekleri yavaşlatın, artan bekleme süreleriyle yeniden deneyin ve toplu işlemlerde batch kullanın.

Webhook ile olay dinleyebilir miyim?

Evet, giden webhook ile. Ancak başarısız bildirimler yeniden gönderilmediği için kritik akışlarda ek kontrol kurun.

Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.