Dokumentasi

Mobile SDK

Hadirkan chat dukungan gabungan AI-dan-manusia yang sama seperti yang Anda jalankan di web ke dalam aplikasi native Android, iOS, dan Flutter Anda. Satu kontrak backend, satu perilaku, tiga platform.

Platform#

Tiga SDK native berbagi permukaan API publik yang identik. Pilih yang sesuai dengan aplikasi Anda:

SDKStackMinimum
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (tanpa dependensi)iOS 15+, Swift 5.9+
FlutterDart murni, tanpa bridge nativeDart 3.4+, Flutter 3.16+

Setiap SDK menampilkan chat native sungguhan sebagai bottom sheet di atas aplikasi Anda — bukan WebView. Aplikasi Anda menggambar titik masuknya (sebuah tombol, ikon, atau badge) dan membuka chat dengan Respondo.open().

Apa yang termasuk#

SDK mobile mencerminkan kumpulan fitur widget web:

  • Inti chat: agen AI, pengalihan langsung ke agen manusia, status mengetik dan dibaca, lampiran file.
  • Umpan berita ("What's new") dan checklist onboarding.
  • Survei (NPS, CSAT, dan lainnya).
  • Banner tingkat halaman dan teaser proaktif yang terkait dengan layar saat ini. Laporkan layar saat ini dengan Respondo.setCurrentScreen("screen_name") saat navigasi — teaser proaktif dan penargetan tingkat halaman mencocokkan terhadapnya.
  • Notifikasi push untuk balasan agen dan kampanye, dengan deep link langsung ke percakapan yang tepat.
Product tour dan tooltip adalah permukaan khusus web dan tidak dibawa ke SDK mobile.

Cara kerjanya#

Setiap SDK adalah klien tipis untuk kontrak widget publik yang sama dengan widget web — backend digunakan kembali tanpa perubahan. Pesan berjalan melalui REST plus WebSocket, dan pengiriman turun secara mulus (WebSocket, lalu SSE, lalu polling REST) serta naik kembali begitu koneksi pulih.

Otorisasi berlapis:

  • visitor_id — id anonim stabil yang dibuat SDK dan disimpan secara aman di perangkat: preferensi terenkripsi Android Keystore, keychain iOS, dan di Flutter file privat aplikasi di storageDirectory yang Anda teruskan ke init.
  • userHash — tanda tangan HMAC dari backend Anda yang mengikat sebuah percakapan ke orang yang sesungguhnya (verifikasi identitas).
  • session-token — diterbitkan per percakapan dan dikirim ulang pada panggilan REST dan WebSocket.

Mulai#

Buka halaman platform yang sesuai dengan aplikasi Anda — Android SDK, iOS SDK, atau Flutter SDK — untuk instalasi dan init yang berfungsi. Kemudian siapkan Verifikasi identitas untuk mengenali pengguna yang masuk di berbagai perangkat, dan Notifikasi push untuk pengiriman saat offline.

Setiap SDK dipasang dari registry platformnya: Android dari Maven Central (ai.respondo:respondo-sdk), iOS melalui Swift Package Manager dari github.com/respondo-app/sdk-ios, dan Flutter dari pub.dev (respondo_sdk). Kode sumber Android dan iOS bersifat publik di GitHub.