Geliştirici kılavuzları
Kavchat, yazdığınız senaryolara göre yanıt veren bir destek sohbetidir. Dil modeli kullanmaz: yayınladığınız senaryo kullanıcının cihazında çalışır. Bu sayede yanıtlar hızlı ve öngörülebilirdir; internet bağlantısı olmadan da çalışmaya devam eder. Burada parçaların nasıl bir araya geldiğini ve nereden başlayacağınızı bulabilirsiniz.
Kavchat nasıl çalışır?
- Kontrol paneli. Siz ve ekibiniz app.kavchat.com adresinden giriş yaparsınız. Her çalışma alanının bir genel anahtarı (
pk_live_...) ve bir gizli anahtarı (sk_live_...) vardır. İkisi de Kurulum sayfasında yer alır. - Senaryolar. Görsel düzenleyicide adımlardan oluşan senaryolar hazırlarsınız. Her adımda bir mesaj, düğmeler ve anahtar kelimeler bulunur. Bir düğme başka bir adıma, başka bir senaryoya, bir bağlantıya, uygulamanızdaki bir ekrana veya destek talebi formuna yönlendirir.
- Yayınlama. Her yayın, numaralı bir sürüm olarak kaydedilir. Botu kimlerin göreceğini siz belirlersiniz: hiç kimse, yalnızca test kullanıcıları (telefon numarasına göre) veya herkes. Uygulamayı güncellemeden, istediğiniz zaman önceki bir sürüme dönebilirsiniz.
- Widget veya SDK. Web siteniz widget'ı genel anahtarla yükler, uygulamanız ise mobil SDK'lardan birini kullanır. Yayınlanan sürümü indirip cihazda saklar ve sohbeti cihaz üzerinde yürütürler.
- Kimlik belirteci (isteğe bağlı). Kullanıcı giriş yaptığında sunucunuz gizli anahtarla kısa bir JWT imzalar. Böylece Kavchat, sisteminizdeki kullanıcı kimliğini sohbete ve destek talebine ekler; yalnızca test kullanıcılarına açık bir botu doğru kişilere gösterebilir.
- Destek talepleri ve webhook. Senaryo sorunu çözemediğinde destek talebi formu, sohbetin tamamını içeren bir talep oluşturur. Talep, kontrol panelindeki destek talebi gelen kutusuna ulaşır. Premium'da imzalı bir webhook ile sisteminize de gönderilir. Sunucunuz ayrıca Server API üzerinden talepleri okuyabilir ve kapatabilir.
İki anahtar, iki ayrı yer
| Anahtar | Nerede bulunur? | Ne işe yarar? |
|---|---|---|
Genel anahtar pk_live_... | Web sayfalarınızda ve uygulamalarınızda. Herkese açık olabilir. | Botu yükleme, sohbet akışını raporlama ve destek talebi oluşturma. |
Gizli anahtar sk_live_... | Yalnızca sunucunuzda. Asla tarayıcıda veya uygulamada bulunmamalıdır. | Kimlik belirteci imzalama, webhook doğrulama ve Server API çağrıları. |
Hızlı başlangıç
Web siteniz için bu satırı </body> etiketinden önce eklemeniz yeterlidir. Kontrol panelindeki Kurulum sayfasından kendi anahtarınızla birlikte kopyalayın:
<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>Bir senaryo yayınlayın, botu herkese (veya test kullanıcılarının telefon numaralarına) açın ve sayfayı yenileyin.
Kılavuzlar
Butonlar ve sorular
Her adımda kısa butonlar ve tam cümleli sorular; konu sayısı fazlaysa arama.
Web sitesi widget'ı
Tek satır kod, isteğe bağlı JavaScript arayüzü, olaylar ve CSP.
React Native
Provider, sohbet ekranı ve yüzen düğme. Expo ile veya Expo olmadan tüm React Native uygulamalarında çalışır (0.72 ve üzeri).
Flutter
Yerleşik RTL desteğiyle denetleyici, yüzen düğme ve sohbet ekranı.
iOS
SwiftUI ve UIKit bileşenlerini içeren Swift paketi. iOS 15 ve üzeri.
Android
Jetpack Compose bileşenleri ve Views uygulamaları için Activity. API 23 ve üzeri.
Kullanıcıları tanımlama
Sunucunuzda kısa ömürlü bir token imzalayın. 7 dilde örnekler.
Webhook
Her yeni talep, imzalı olarak sisteminize gelir. Premium'da.
Server API
Doğrudan sunucunuzdan talepler, raporlar, hedef kitle ve sürümler.
Yardıma mı ihtiyacınız var?
Bize support@kavchat.com adresinden yazın. API'nin tamamı openapi.yaml dosyasında açıklanmıştır (OpenAPI 3.1).