Dokumentasyon

Mobile SDK

Ilunsad ang mismong support chat na pinagsama ang AI at tao — ang ginagamit ninyo sa web — sa loob ng native ninyong Android, iOS, at Flutter app. Isang backend contract, isang kilos, tatlong platform.

Mga platform#

Magkapareho ang pampublikong API surface ng tatlong native SDK. Piliin ang tugma sa app ninyo:

SDKStackPinakamababa
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (walang dependency)iOS 15+, Swift 5.9+
FlutterPurong Dart, walang native bridgeDart 3.4+, Flutter 3.16+

Ang bawat SDK ay nagre-render ng totoong native na chat bilang bottom sheet sa ibabaw ng app ninyo — hindi WebView. Ang app ninyo ang gumuguhit ng entry point (button, icon, badge) at binubuksan ang chat sa pamamagitan ng Respondo.open().

Ano ang kasama#

Ginagaya ng mga mobile SDK ang hanay ng tampok ng web widget:

  • Ubod ng chat: ahente ng AI, live na pagpasa sa mga taong tagasuporta, indikasyon ng pagta-type at pagkabasa, at mga attachment na file.
  • News feed ("What's new") at mga checklist ng pagsisimula.
  • Mga survey (NPS, CSAT, at iba pa).
  • Mga banner sa antas ng pahina at proactive na teaser na nakatali sa kasalukuyang screen. Iulat ang kasalukuyang screen gamit ang Respondo.setCurrentScreen("screen_name") sa navigation — dito tumutugma ang mga proactive na teaser at ang page-level na targeting.
  • Mga push notification para sa tugon ng tagasuporta at para sa mga kampanya, may deep link papunta sa tamang usapan.
Ang mga product tour at tooltip ay para lang sa web at hindi dinadala sa mga mobile SDK.

Paano ito gumagana#

Ang bawat SDK ay manipis na kliyente ng parehong pampublikong widget contract na ginagamit ng web widget — muling ginagamit ang backend nang walang pagbabago. Dumadaan ang pagpapalitan ng mensahe sa REST kasama ang WebSocket, at marahang bumababa ang paraan ng paghahatid (WebSocket, tapos SSE, tapos REST polling) at agad ding umaakyat pabalik sa sandaling makabawi ang koneksyon.

Nakapatong-patong ang awtorisasyon:

  • visitor_id — matatag na anonymous na id na ginagawa ng SDK at ligtas na itinatago sa device: mga preference na naka-encrypt sa Android Keystore, ang iOS keychain, at sa Flutter ay isang app-private na file sa storageDirectory na ipinapasa ninyo sa init.
  • userHash — lagdang HMAC mula sa backend ninyo na nag-uugnay sa isang usapan sa totoong tao (pagpapatunay ng identity).
  • session-token — ibinibigay kada usapan at ipinapadalang muli sa mga tawag sa REST at WebSocket.

Magsimula#

Pumunta sa pahina ng platform na tugma sa app ninyo — Android SDK, iOS SDK, o Flutter SDK — para sa pag-install at sa gumaganang init. Pagkatapos, ikabit ang Pagpapatunay ng identity para makilala ang mga naka-sign in na user sa iba't ibang device, at ang Push notification para sa paghahatid kapag offline.

Ang bawat SDK ay ini-install mula sa registry ng sarili nitong platform: ang Android mula sa Maven Central (ai.respondo:respondo-sdk), ang iOS sa pamamagitan ng Swift Package Manager mula sa github.com/respondo-app/sdk-ios, at ang Flutter mula sa pub.dev (respondo_sdk). Pampubliko sa GitHub ang source ng Android at iOS.