Özellikler

Bitrix24'ü mevcut sistemlerinize güvenle bağlayın

Bitrix24 kapalı bir kutu değil. REST API, CRM varlıklarınıza standart HTTP üzerinden programatik ve yetki kapsamı denetlenmiş erişim verir; entegrasyonu biz tasarlar, kurar ve izleriz.

Ücretsiz Ön Görüşme Tüm özellikleri gör

Bir bakışta

OAuth 2.0 ve gelen webhook
Kapsam bazlı yetkilendirme
ERP ve muhasebe entegrasyonu
BI ve veri ambarı beslemesi
E-ticaret ve destek entegrasyonu

SORUN

Entegrasyonlar kısa sürede teknik borca dönüşüyor

Parçalı kimlikler: aynı müşteriye bir sistemde cari kodu, diğerinde account_id veriliyor; eşleşme kopuyor.
Kırılgan orkestrasyon: birbirini kovalayan cron işlerinden biri patladığında zincirin tamamı duruyor.
Gecikmeli senkron: "günün sonunda aktarırız" yaklaşımı yüzünden satış ekibi eski stokla teklif veriyor.
Alan eklenip çıkarıldıkça başlangıç varsayımları geçersiz kalıyor, entegrasyon sessizce bozuluyor.
Yetkiler geniş veriliyor; bir tokenın nereye eriştiğini kimse tam bilmiyor.

ÇÖZÜM

Entegrasyonu üretim kalitesinde kuruyoruz

Bitrix24 REST API üzerinde çalışan entegrasyonları sadece "çalışıyor" diye teslim etmiyoruz; idempotent tasarım, oran sınırı yönetimi ve izlenebilirlik ile birlikte kuruyoruz.

Çekirdek objeler için CRUD: Deal, Lead, Contact, Company, Activity, Product, Quote, Invoice.
Zengin filtreleme, sıralama ve alan seçimiyle sadece ihtiyacınız olan veri çekilir.
Batch çağrılarla çok sayıda işlem tek istekte toplanır, ağ gidiş-dönüşü azalır.
Olay abonelikleri (onCrmDealAdd, onCrmDealUpdate vb.) ile değişiklikler anında dış sisteme iletilir.
Idempotent tasarım: her dış işlem doğal anahtarla eşlenir, tekrar çağrı mükerrer kayıt üretmez.
429 ve gecikme durumları kuyruklama, çalışma havuzu ve exponential backoff + jitter ile yönetilir.

Çekirdek objeler ve programatik erişim

CRM REST API, CRM varlıklarınıza standart HTTP üzerinden programatik, güvenli ve tahmin edilebilir erişim sunar.

Deal, Lead, Contact, Company, Activity, Product, Quote ve Invoice gibi çekirdek objeler için CRUD işlemleri, arama, filtreleme ve ilişkilendirme yapılır. Aynı metot kümesi bulut ve self-hosted kurulumda çalışır.

crm.deal.*, crm.lead.*, crm.contact.* ve crm.activity.* metotlarıyla tam CRUD.
Ürün, teklif ve fatura belgeleri de API üzerinden yönetilir.
Kayıtlar arası ilişkiler (kişi-şirket-fırsat) API tarafında korunur.
Uç nokta referansı, örnek istek ve yanıtlar training.bitrix24.com/rest_help adresinde yayımlanır.

Geliştirici deneyimi ve performans

İyi bir API yalnızca fonksiyon değil, öngörülebilirlik de sunar. Bitrix24 CRM REST API; toplu (batch) çağrılar, zengin filtreleme, sıralama ve alan seçimi, anlamlı hata kodları ve olay abonelikleriyle entegrasyon hızınızı artırır.

Bu sayede entegrasyon ilk günden itibaren üretim yüküne hazır kurulur.

Batch çağrılarla çok sayıda işlem tek istekte toplanır.
Filtreleme, sıralama ve alan seçimiyle sadece gereken veri çekilir.
onCrmDealAdd ve onCrmDealUpdate gibi olaylara abone olunur.
Anlamlı hata kodları sayesinde sorun üretimde değil, izlemede yakalanır.

OAuth 2.0, webhook ve kapsam yönetimi

Entegrasyon güvenliği basit bir token meselesi değildir; bağlam, kapsam ve izlenebilirlik ister. Bitrix24 CRM REST API iki model sunar: uygulama kaydı üzerinden OAuth 2.0 ve gelen (incoming) webhook.

OAuth yaklaşımında token yenileme ve kapsam yönetimi devreye girer; webhook yaklaşımında önceden tanımlı bir erişim URL'si kullanılır.

Kapsam (scope) bazlı izinlerle uygulamaya yalnızca ihtiyacı olan erişim verilir.
OAuth 2.0 akışları token yenilemeyi ve uzun ömürlü entegrasyonu destekler.
Gelen webhook, tek portalda çalışan iç entegrasyonlar için dakikalar içinde kurulur.
Olay yüklerindeki imza ve secret doğrulanarak güvenli teslim sağlanır.
Erişim anahtarları güvenli saklanır; asgari yetki prensibi uygulanır.

Gerçek senaryolar: ERP'den BI'a

En sık kurduğumuz akış, anlaşma kazanıldığında ERP'de otomatik sipariş ve fatura açılması; dönen sipariş veya fatura numarası CRM'de özel alana yazılır.

İade ve iptal akışlarında stok ile gelir düzeltmesi çift yönlü yürür, kapanış öncesi kredi limiti kontrolü gerçek zamanlı tetiklenir. Aynı API veri ambarı, e-ticaret ve saha ekipleri için de kullanılır.

ERP ve muhasebe: kazanılan anlaşmadan sipariş ve fatura üretimi, çift yönlü düzeltme.
Veri ambarı ve BI: crm.deal.list ve crm.activity.list ile artımsal veri çekme.
E-ticaret: sepet-CRM eşlemesi ve terk edilen sepet olayında kampanya tetikleme.
Destek ve saha: bilet kapandığında CRM aktivitesi, randevu değişiminde senkron.

Üretim kalitesinde dağıtım desenleri

Entegrasyonlar ilk başarı hikâyesinden kısa süre sonra teknik borca dönüşme eğilimindedir; çünkü alanlar değişir, yeni sistemler girer ve başlangıç varsayımları geçerliliğini yitirir.

Bunu önlemek için kodun ötesinde disiplin gerekir. Entegrasyonu idempotent tasarım, oran sınırı yönetimi ve güvenli olay teslimiyle birlikte kuruyoruz.

Idempotent tasarım: her dış işlem doğal anahtarla eşlenir, tekrar çağrı mükerrer kayıt üretmez.
Geri basınç ve oran sınırları: kuyruklama, çalışma havuzları, exponential backoff ve jitter.
429 ve gecikme yanıtları hata değil, beklenen durum olarak ele alınır.
Tek müşteri kimliği kurularak parçalı kimlik sorunu çözülür.
İzleme ve loglama entegrasyonun teslim kapsamına dâhil edilir.

YETENEKLER

Öne çıkan yetenekler

OAuth 2.0 ve gelen webhook

Uygulama yaklaşımında OAuth 2.0 ile kapsam bazlı yetkilendirme, hızlı senaryolarda önceden tanımlı erişim URL'si olan gelen webhook kullanılır. Hangisinin size uyduğunu birlikte kararlaştırırız.

Kapsam bazlı yetkilendirme

Bir uygulamaya yalnızca ihtiyaç duyduğu kaynaklara erişim verilir. CRM, görev veya telefon kapsamları ayrı ayrı tanımlanır; asgari yetki prensibi uygulanır.

ERP ve muhasebe entegrasyonu

Fırsat kazanıldığında ERP'de sipariş ve fatura açılır, dönen belge numarası CRM'de özel alana yazılır. İade ve iptalde stok ile gelir düzeltmesi çift yönlü yürür.

BI ve veri ambarı beslemesi

crm.deal.list ve crm.activity.list ile son değişiklik zamanına göre artımsal veri çekilir. ETL/ELT hattınız tam kopya yerine sadece deltayı işler.

E-ticaret ve destek entegrasyonu

Sepet-CRM eşlemesi kurulur, terk edilen sepet olayı kampanya akışını tetikler. Destek bileti kapandığında CRM aktivitesi açılır, saha randevusu değiştiğinde senkron korunur.

Güvenli olay teslimi ve izleme

Olay yüklerindeki imza ve secret bilgileri doğrulanır, hatalı istekler loglanır. Anlamlı hata kodları sayesinde sorun üretimde değil, izlemede yakalanır.

KİMLER İÇİN

Kimler için ideal?

Bu modülü en çok aşağıdaki ekiplerde konuşlandırıyoruz. Sizin senaryonuz listede yoksa da birlikte değerlendirelim.

CRM'i ERP veya muhasebe yazılımına bağlamak isteyen BT yöneticileri
E-ticaret sitesinin siparişlerini CRM'e akıtmak isteyen dijital ekipler
Bitrix24 verisini veri ambarına alıp BI aracında raporlayan analiz birimleri
Kendi geliştirdiği iç uygulamayı CRM ile konuşturmak isteyen yazılım ekipleri
Çok sistemli yapıda tek müşteri kimliği kurmak isteyen kurumsal mimariler

Bu sizin sürecinizde nasıl kurulur?

Otuz dakikalık ücretsiz ön görüşmede iş akışınızı dinleyip bu başlığın sizde nasıl çalışacağını birlikte çıkarıyoruz.

Ücretsiz ön görüşme

KURULUM

Nasıl devreye alıyoruz?

Kurulumu biz yapıyoruz; siz sadece süreçlerinizi anlatıyorsunuz.

01
Entegrasyon tasarımı
Hangi sistemlerin hangi veriyi hangi yönde paylaşacağını, tetikleyicileri ve tek müşteri kimliğinin nasıl kurulacağını yazılı olarak tasarlıyoruz.
02
Geliştirici ayarları
Portalınızda yeni bir uygulama kaydı oluşturuyor veya gelen webhook tanımlıyoruz. Uygulama yaklaşımında OAuth 2.0, webhook yaklaşımında önceden tanımlı erişim URL'si kullanılır.
03
Kapsam ve yetkilendirme
Entegrasyonun ihtiyaç duyduğu kapsamları asgari düzeyde veriyor, anahtarları güvenli saklıyor ve olay yükleri için imza doğrulamasını kuruyoruz.
04
Geliştirme ve test
Metotları test portalında deniyor, batch ve filtre kullanımını optimize ediyor, oran sınırı senaryolarını kuyruk ve backoff ile sınıyoruz.
05
Devreye alma ve izleme
Canlıya alırken log ve uyarı mekanizmasını kuruyoruz; hata durumlarında kimin nasıl müdahale edeceğini destek paketinizle birlikte tanımlıyoruz.

Birlikte çalıştığı modüller

ERP ve muhasebe yazılımlarıE-ticaret platformları ve sepet sistemleriVeri ambarı, ETL/ELT ve BI araçlarıDestek ve saha servis uygulamalarıBitrix24 Market uygulamalarıOtomasyon kuralları ve iş akışlarıMCP ile harici yapay zekâ araçları

KEŞFEDİN

İlgili özellikler

Bu modülle birlikte en sık devreye aldığımız başlıklar. Aynı kurulumda birbirini besliyorlar.

Otomasyon Robotları

Satışçının günü kayıt açmak, hatırlatma kurmak ve aynı e-postayı yeniden yazmakla geçiyorsa gelir orada kaybolur. Bu işleri robotlara devrediyor, ekibinizi müşteriyle konuşmaya geri döndürüyoruz.

İş Akışları

Onaylar e-posta ve WhatsApp üzerinden yürüdüğünde kimse sürecin nerede beklediğini bilmez. İzinden satın almaya kadar tüm iç süreçlerinizi adımları, sorumluları ve süreleri belli akışlara dönüştürüyoruz.

Yapay Zekâ CoPilot

CoPilot ayrı bir uygulama değil; Bitrix24'ün sohbetinin, CRM kartının ve görüntülü aramasının içinde çalışır. Ekibiniz yazma, dinleme ve not tutma işine harcadığı zamanı geri alır.

Sıkça Sorulan Sorular

Webhook mı, OAuth uygulaması mı kurmalıyız?

Tek portalda çalışan iç entegrasyonlar için gelen webhook genelde yeterli ve dakikalar içinde kurulur. Birden çok portalda dağıtılacak, kullanıcı adına işlem yapacak ya da uzun ömürlü olacak entegrasyonlarda OAuth 2.0 uygulaması öneriyoruz.

API oran sınırları işimizi aksatır mı?

Doğru tasarlanırsa aksatmaz. Batch çağrılarla istek sayısını düşürüyor, kuyruk ve exponential backoff + jitter ile 429 yanıtlarını sorunsuz karşılıyoruz. Yoğun senaryolarda toplu işleri çalışma saatleri dışına planlıyoruz.

Self-hosted Bitrix24 kurulumunda da REST API çalışır mı?

Çalışır. Kendi sunucunuzdaki kurulumda da aynı metot kümesini kullanırsınız; fark ağ erişimi ve sertifika yönetiminde olur. Kurumsal ağ içinde kalması gereken entegrasyonlar için bu senaryoyu sıkça uyguluyoruz.

Dokümantasyon ve geliştirici desteği nasıl?

Bitrix24 uç nokta referansını, örnek istek ve yanıtları, hata durumlarını ve olay listesini training.bitrix24.com/rest_help adresinde yayımlıyor. Geliştirme ekibiniz varsa onlara eşlik ediyor, yoksa entegrasyonu baştan sona biz geliştiriyoruz.

Bu özelliği işinize göre kuralım

Süreçlerinizi dinleyip hangi ayarların size uyduğunu gösteren ücretsiz bir ön görüşme planlayalım.