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.