Sistemler konuşunca: web sitenizin API entegrasyonları

Bir müşteri sitenizdeki formu doldurdu. Sonra ne oluyor? Çoğu şirkette cevap şu: form bir e-posta gönderiyor, o e-postayı biri okuyup bilgileri CRM'e elle giriyor, muhasebe programına ayrıca yazıyor, e-posta listesine bir de oradan ekliyor. Aynı bilgi, dört sisteme dört kez giriliyor — ve her seferinde bir yazım hatası ihtimaliyle.

API entegrasyonu tam olarak bu kopukluğu çözer: sistemlerin insansız konuşması. Sitenizin CRM'inizle, ödeme altyapınızla, stok programınızla, faturalandırma servisinizle doğrudan veri alışverişi yapması. Kulağa teknik geliyor ama mesele teknik değil; mesele, ekibinizin gününün ne kadarının kopyala-yapıştıra gittiğidir.

API nedir — jargonsuz hali

API (Application Programming Interface), bir yazılımın diğer yazılımlara açtığı resmi kapıdır. Restoran benzetmesi eskidir ama işler: siz (siteniz) mutfağa (diğer sisteme) doğrudan girmezsiniz; garsona (API'ye) sipariş verirsiniz, garson standart bir formatta mutfağa iletir, sonucu size getirir.

Kritik kelime "standart". API'nin var olması demek, o sistemin "benimle şu kurallarla konuşabilirsin" diye yazılı bir sözleşme yayınlaması demektir. Kullandığınız araçların çoğunun — ödeme sistemleri, CRM'ler, kargo firmaları, e-fatura sağlayıcıları, Google servisleri — bugün birer API'si var. Yani parçalar ortada; eksik olan genellikle onları birbirine bağlayan iş.

Web sitesi API entegrasyonlarının tipik örnekleri

Soyut kalmasın; sahada en çok karşılaştığımız senaryolar şunlar:

Form → CRM

Sitenize gelen her talep, insan eli değmeden CRM'de bir kayıt olur: kaynağı, tarihi, formda yazılanlarla birlikte. Satış ekibi e-posta kutusu yerine tek bir yerden çalışır, hiçbir talep "spam'e düşmüş" bahanesiyle kaybolmaz.

Ödeme ve faturalandırma

Sitede tahsilat yapılıyorsa ödeme sağlayıcı entegrasyonu zaten zorunludur; asıl fark yaratan ikinci adımdır: başarılı ödemenin otomatik olarak e-fatura/e-arşiv sürecini tetiklemesi. Elle fatura kesen bir işletmede bu tek entegrasyon, ay sonu mesaisini ciddi biçimde kısaltır.

Stok ve ürün bilgisi

Ürünleriniz bir ERP veya stok programında yaşıyorsa, sitenin oradan beslenmesi gerekir. Aksi halde iki ayrı "doğru" oluşur: programda stok bitmiştir ama sitede satılık görünür. Müşteriye "aslında o ürün yok" demek, entegrasyon eksikliğinin en pahalı halidir.

Kargo ve operasyon

Sipariş oluştuğunda kargo firmasının API'sinden otomatik gönderi kaydı, müşteriye takip numarasının otomatik gitmesi. Küçük görünür; günde yirmi sipariş işleyen bir ekipte saatler kazandırır.

Bildirim ve iletişim

Kritik olaylarda ekibe otomatik mesaj: yeni sipariş düştüğünde, form geldiğinde, ödeme başarısız olduğunda. E-posta yerine ekibin zaten baktığı kanala.

"Zapier varken neden özel entegrasyon?"

Dürüst cevap: bazen gerçekten gerek yok. Zapier, Make ve benzeri araçlar, iki popüler servisi basit bir kuralla bağlamak için gayet iyidir. "Form gelince Slack'e mesaj at" senaryosu için özel yazılım yazdırmak parayı sokağa atmaktır — hazır aracı kullanın.

Özel entegrasyon üç durumda anlamlı hale gelir:

Kullandığınız sistem popüler değilse. Türkiye'ye özgü bir ERP, sektörünüze özel bir program, şirket içi eski bir yazılım — hazır bağlayıcı bulamazsınız.
Veri dönüşümü karmaşıksa. "A'daki alanı B'ye kopyala"dan fazlası gerekiyorsa: fiyat hesaplama, stok kuralları, birden fazla kaynaktan birleştirme.
Hacim ve güvenilirlik kritikse. Hazır otomasyon araçları görev başına ücretlendirir ve hata durumlarında sınırlı kontrol verir. Ayda on binlerce işlem geçen, kaybolan tek kaydın müşteri kaybı demek olduğu akışlarda kendi entegrasyon katmanınız olmalıdır.

Ölçüt bütçe değil, kırılganlıktır: o akış durduğunda işiniz duruyorsa, akışın sahibi siz olmalısınız.

İyi entegrasyon ile kırılgan entegrasyonu ayıran nedir?

İki sistemi konuşturmak zor değildir; zor olan, konuşmanın yıllarca kesilmemesini sağlamaktır. Teklif değerlendirirken şu dört soruyu sorun:

Hata olduğunda ne oluyor?

Karşı taraf API'si bir gün mutlaka cevap vermeyecek — bakım, kesinti, limit aşımı. Kötü entegrasyon o anda veriyi sessizce kaybeder. İyi entegrasyon bekletir, yeniden dener, olmuyorsa kayıt tutup birine haber verir. "Retry ve kuyruk mantığınız nasıl?" sorusuna net cevap alamıyorsanız, kırılgan bir şey satın alıyorsunuz demektir.

Kimse bakmıyorken kim izliyor?

Entegrasyonlar sessiz öldüğü için tehlikelidir: form CRM'e düşmemeye başlar ve bunu üç hafta sonra, "bu ay talepler neden azaldı?" toplantısında fark edersiniz. İzleme ve uyarı, entegrasyonun süsü değil parçasıdır.

Anahtarlar nerede duruyor?

API entegrasyonu, sistemlerinizin anahtarlarını bir yere koymak demektir. O anahtarların kodun içine gömülmemesi, yetkilerin en dar kapsamda tutulması, sızıntı halinde iptal edilebilir olması gerekir. Bu kısım görünmez ama pazarlığa açık değildir.

Karşı taraf değişince ne olacak?

API'ler evrilir: sağlayıcılar sürüm kapatır, alan adı değiştirir. Entegrasyon "yapıldı ve bitti" bir iş değil, düşük tempolu da olsa bakım isteyen bir üründür. Yıllık küçük bir bakım maliyetini baştan konuşmayan teklif, o maliyeti size sürpriz olarak sonra çıkarır.

Entegrasyon ne kadara mal olur?

Net rakam vermek dürüst olmaz; iş, uçlar arasında çok değişir. Ama maliyeti belirleyen değişkenler bellidir ve bunları bilmek teklifleri karşılaştırılabilir kılar:

Karşı sistemin API kalitesi. İyi belgelenmiş, modern bir API ile çalışmak hızlıdır; belgesiz, yarı kapalı bir eski sistemle çalışmak işin en pahalı halidir. Bazen "entegrasyon" projesinin yarısı, karşı sistemin nasıl davrandığını keşfetmekle geçer.
Yön sayısı. Tek yönlü akış (site → CRM) basittir; çift yönlü senkron (iki taraf da birbirini güncelliyor) çakışma kurallarıyla birlikte belirgin biçimde zorlaşır.
Hata toleransı. "Kaybolan kayıt telafi edilemez" seviyesindeki akışlar, kuyruk ve izleme altyapısıyla birlikte daha fazla mühendislik ister.

Teklifler arasında büyük fiyat farkı görüyorsanız, sebep çoğu zaman bu üç kalemden birinin hesaba katılıp katılmamasıdır — ucuz teklif genellikle hata senaryolarını yok sayandır.

Nereden başlamalı?

Yaygın hata, her şeyi tek projede bağlamaya çalışmaktır. Daha sağlıklı sıra şu:

Elle taşınan veriyi listeleyin. Ekibinize sorun: hangi bilgiyi bir ekrandan kopyalayıp başka ekrana yapıştırıyorsunuz? Bu liste, entegrasyon yol haritanızdır.
En sık ve en hatalı olanı seçin. Günde on kez yapılan ve yanlış girildiğinde müşteriye yansıyan iş, ilk adaydır.
Tek akışı uçtan uca bağlayın, sonra yenisine geçin. Çalışan bir entegrasyon, ikincisi için hem güven hem altyapı üretir.

Bir de beklenti dengesi: entegrasyon sihirli değildir. Kaynak sistemdeki veri dağınıksa — mükerrer müşteri kayıtları, tutarsız ürün kodları — entegrasyon o dağınıklığı sadece daha hızlı taşır. Bazen ilk iş bağlamak değil, temizlemektir; bunu baştan söyleyen bir ekip, size dürüst davranıyordur.

Sitenizle sistemleriniz arasında hâlâ kopyala-yapıştır köprüsü varsa, muhtemelen en verimli yatırımınız yeni bir özellik değil, bir entegrasyondur. Hangi akıştan başlamanın mantıklı olduğunu birlikte bakmak isterseniz Vucod'a yazın; her başvuruya 48 saat içinde dönüyoruz: vucod.com