Bilmek ile bakmak arasındaki fark
İki tür müşteri sorusu vardır. İlk tür geneldir: İade politikanız nedir? Kargo ne kadar sürer? Almanya’ya gönderiyor musunuz? İyi doldurulmuş bir bilgi tabanı bunları halleder.
İkinci tür özeldir: #4521 numaralı siparişim nerede? Mavi sürüm hâlâ stokta mı? Bu ay paketimde ne kadar kaldı? Bunlar bir bilgi tabanında yaşamaz. Sistemlerinizde yaşar — sipariş yönetimi, envanter, faturalandırma — ve her saniye değişir.
Yalnızca ilk türle başa çıkan bir sohbet botu, gösterişli bir SSS’dir. İkinciyle de başa çıkan bir bot, bir asistandır. İkisi arasındaki fark API erişimidir.
Bu boşluk neden müşteri kaybettiriyor
Bugünkü „AI sohbetlerinin“ çoğu yalnızca bir bilgi tabanının üstüne kuruludur. Kargo politikanızı on yedi dilde aktarabilirler, ama müşteriye paketinin gerçekten şu an nerede olduğunu söyleyemezler. Müşteri sorar, bot kaçar ve müşteri ya pes eder ya da botun milisaniyelerle alabileceği aynı verileri kontrol edecek bir operatörü bekler.
Sohbet botu tavanı budur. Her „bunu sizin için kontrol edeyim“ saniyeler içinde, ilk mesajda, müşterinin niyeti hâlâ sıcakken yanıtlama fırsatının kaybedilmesidir.
API bağlantıları aslında ne yapar
enuchat’te bir API bağlantısı, sohbet ile arka uç hizmetlerinizden biri arasında yapılandırılmış bir bağdır. Bunu bir kez tanımlarsınız: temel URL, kimlik doğrulama yöntemi ve birkaç endpoint, parametreleri ve yanıtın nasıl eşleneceğiyle.
O andan itibaren AI, bir konuşma sırasında bu endpoint’leri çağırabilir. Bir ziyaretçi bir siparişi sorduğunda, AI sipariş numarasını çıkarır, sipariş endpoint’inizi çağırır, canlı durumu okur ve bunu yanıta dokur. Ziyaretçi bir cümle görür: „#4521 numaralı siparişiniz dün gönderildi ve perşembe günü ulaşması bekleniyor.“ O cümlenin arkasında gerçek bir API çağrısı oldu.
Müşteri tesisatı görmez. Yalnızca sohbetin gerçekten bildiğini görür.
Beş kimlik doğrulama yöntemi, özel kod yok
Bağlamak isteyeceğiniz çoğu API zaten standart kimlik doğrulama kullanır. enuchat beşini kutudan çıktığı gibi destekler:
- Hiçbiri — kimlik doğrulama gerektirmeyen genel API’ler için
- API Key — başlık veya sorgu parametresi olarak gönderilir
- Bearer Token — basit token tabanlı kimlik doğrulama
- Basic Auth — eski sistemler için
- OAuth 2.0 client credentials — Salesforce, HubSpot veya kendi OAuth sunucunuz gibi modern sağlayıcılar için
OAuth 2.0 için enuchat token yaşam döngüsünü otomatik yönetir — ilk çağrıda alır, süresi bitene kadar önbelleğe alır, gerektiğinde yeniler. Kimlik bilgilerini bir kez yapılandırır, unutursunuz. Tüm kimlik bilgileri libsodium ile beklemede şifrelenir ve API yanıtlarında asla görünmez.
Değişkenler, şablonlar ve yanıt eşlemesi
Endpoint’ler şablon olarak tanımlanır. /orders/{orderId} gibi bir yol veya {customerId}’ye atıfta bulunan bir JSON gövdesi, oturum değişkenlerinden değerleri yerleştirir — AI veya statik bir kuralın konuşma sırasında atayabileceği değişkenler.
API yanıt verdiğinde, JSON yanıtındaki alanları nokta gösterimiyle oturum değişkenlerine eşlersiniz. data.status order_status olur. data.shipping.eta delivery_eta olur. AI sonra bu değerleri doğal bir yanıtta dokur — ziyaretçinin kendi dilinde.
Çoğu kullanım durumunu kapsayan üç desen
Pratikte, çoğu API entegrasyonu üç biçimden birine düşer.
Bak ve yanıtla
Ziyaretçi tek bir API çağrısıyla yanıtlanabilecek bir soru sorar. Kural CALL_API’yi ardından REPLY_AI’yi ateşler. AI getirilen verileri, bağlamsal ve temellendirilmiş bir yanıt oluşturmak için kullanır. Sipariş durumu, hesap bakiyesi, oda müsaitliği, güncel fiyatlandırma, paket takibi — bunların hepsi buraya uyar.
Bak ve yönlendir
API çağrısı bir sonraki adıma karar vermek için yeterli bilgi döndürür. Premium bir hesap kıdemli bir temsilciye yükseltilir. Süresi dolmuş bir abonelik faturalandırmaya yönlendirilir. AI CALL_API’yi ardından ASSIGN_TO_OPERATOR’ı kullanarak gerçek müşteri verilerine dayanan yönlendirme kararları alır, tahminlere değil.
Çok adımlı akışlar
İlk mesaj SET_VARIABLE ile konuşmayı etiketler, ikincisi yeterli bağlam olduğunda API çağrısını tetikler ve üçüncüsü yanıtı oluşturur. Arka ucunuzu pinglemeden önce niyeti onaylamanız gerektiğinde veya veri sorgusu ziyaretçinin iki mesaj önce söylediği bir şeye bağlı olduğunda yararlıdır.
Yerleşik güvenlik
Arka uçları bir sohbet widget’ına bağlamak bazı ekipleri sinirli yapar — haklı olarak. enuchat varsayılan olarak birden fazla koruma katmanı sağlar:
- SSRF önleme localhost, özel IP’ler ve dahili hostname’lere yapılan çağrıları engeller
- 5 saniyelik zaman aşımı yavaş bir API’nin konuşmayı askıda bırakmasını önler
- Tenant kapsamlandırma tenant’lar arası veri sızıntısı olmaması anlamına gelir — endpoint’leriniz yalnızca kendi widget’larınıza görünürdür
- Test düğmeleri hem bağlantıyı hem de her endpoint’i kurallara bağlamadan önce bağımsız olarak doğrular
- Şifrelenmiş kimlik bilgileri asla panele açık metin olarak geri dönmez
Müşterileriniz için neler değişir
Sohbet, „bunu kontrol edebilecek birini bulayım“’dan „kontrol edildi, işte yanıt“’a geçer — 60+ dilden herhangi birinde, pazar günü gece 3’te, destek ekibiniz uyurken. Aksi takdirde sepeti, siparişi veya planı terk edecek olan müşteriler kalır, çünkü yanıt onlar hâlâ sorarken gelir.
Sohbet botu ile asistan arasındaki fark budur. Ve müşterilerinizin gerçekten hissettiği fark budur.
Nasıl başlanır
enuchat zaten kuruluysa, API bağlantıları Ayarlar → API Bağlantıları altındadır. Ekibinizin haftada yüz kez yazdığı bir soruyu yanıtlayan tek bir endpoint seçin — sipariş durumu genellikle en yüksek getirili başlangıç noktasıdır. Bağlantıyı yapılandırın, endpoint’i ekleyin, bir kurala bağlayın ve canlıya almadan önce bir kez test edin. Tam tur için API Bağlantıları kılavuzuna bakın.
enuchat’te yeniyseniz, enuchat.com’da kaydolun. Ücretsiz katman ilk günden itibaren API bağlantılarını içerir — kart yok, konuşma başına ücret yok, deneme süresi sona ermez.
İlk endpoint’inizi takmak için beş dakika. İlk yararlı yanıt genellikle aynı gün gelir.