Dokümanlar

Mobile SDK

Web’de çalıştırdığınız aynı yapay zeka ve insan destekli sohbeti, yerel Android, iOS ve Flutter uygulamalarınızın içinde sunun. Tek backend sözleşmesi, tek davranış, üç platform.

Platformlar#

Üç yerel SDK, birebir aynı genel API yüzeyini paylaşır. Uygulamanıza uyanı seçin:

SDKYığınMinimum
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (sıfır bağımlılık)iOS 15+, Swift 5.9+
FlutterSaf Dart, yerel köprü yokDart 3.4+, Flutter 3.16+

Her SDK, uygulamanızın üzerinde alttan açılan bir sayfa olarak gerçek bir yerel sohbet çizer — bir WebView değil. Uygulamanız giriş noktasını (bir düğme, bir simge, bir rozet) çizer ve sohbeti Respondo.open() ile açar.

Neler dahil#

Mobil SDK’lar, web widget’ının özellik setini birebir yansıtır:

  • Sohbet çekirdeği: yapay zeka ajanı, insan temsilcilere canlı aktarım, yazıyor ve okundu durumu, dosya ekleri.
  • Haber akışı (“Yenilikler”) ve onboarding kontrol listeleri.
  • Anketler (NPS, CSAT ve daha fazlası).
  • Geçerli ekrana bağlı sayfa düzeyinde bannerlar ve proaktif teaser’lar. Geçerli ekranı gezinme sırasında Respondo.setCurrentScreen("screen_name") ile bildirin — proaktif teaser’lar ve sayfa düzeyi hedefleme onunla eşleşir.
  • Temsilci yanıtları ve kampanyalar için, doğru konuşmaya derin bağlantı içeren push bildirimleri.
Ürün turları ve araç ipuçları yalnızca web’e özgü yüzeylerdir ve mobil SDK’lara taşınmaz.

Nasıl çalışır#

Her SDK, web widget’ıyla aynı genel widget sözleşmesinin ince bir istemcisidir — backend değişmeden yeniden kullanılır. Mesajlaşma REST ve bir WebSocket üzerinden çalışır; teslimat zarifçe geri düşer (önce WebSocket, sonra SSE, sonra REST yoklama) ve bağlantı düzelir düzelmez yeniden yukarı tırmanır.

Yetkilendirme katmanlıdır:

  • visitor_id — SDK’nın oluşturup cihazda güvenle sakladığı kararlı bir anonim kimlik: Android’de Keystore ile şifrelenmiş tercihler, iOS’ta keychain ve Flutter’da init’e geçirdiğiniz storageDirectory’deki uygulamaya özel bir dosya.
  • userHash — bir konuşmayı gerçek bir kişiye bağlayan, backend’inizden gelen bir HMAC imzası (kimlik doğrulama).
  • session-token — her konuşma için verilir ve REST ile WebSocket çağrılarında tekrar gönderilir.

Başlayın#

Uygulamanıza uyan platform sayfasına gidin — Android SDK, iOS SDK veya Flutter SDK — kurulum ve çalışan bir init için. Ardından oturum açmış kullanıcıları cihazlar arasında tanımak için Kimlik doğrulama’yı ve çevrimdışı teslimat için Push bildirimleri’ni bağlayın.

Her SDK kendi platform reyestrinden kurulur: Android Maven Central (ai.respondo:respondo-sdk) üzerinden, iOS Swift Package Manager ile github.com/respondo-app/sdk-ios üzerinden ve Flutter pub.dev (respondo_sdk) üzerinden. Android ve iOS kaynakları GitHub üzerinde herkese açıktır.