Documentatie

Mobile SDK

Lever dezelfde AI-plus-mens supportchat die je op het web draait, binnen je native Android-, iOS- en Flutter-apps. Eén backend-contract, één gedrag, drie platforms.

Platforms#

Drie native SDK’s delen een identiek publiek API-oppervlak. Kies degene die bij je app past:

SDKStackMinimum
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (geen dependencies)iOS 15+, Swift 5.9+
FlutterPure Dart, geen native bridgesDart 3.4+, Flutter 3.16+

Elke SDK rendert een echte native chat als bottom sheet over je app — geen WebView. Je app tekent het startpunt (een knop, een icoon, een badge) en opent de chat met Respondo.open().

Wat is inbegrepen#

De mobiele SDK’s spiegelen de featureset van de webwidget:

  • Chatkern: AI-agent, live overdracht naar menselijke medewerkers, typ- en leesstatus, bijlagen.
  • Nieuwsfeed ("Wat is nieuw") en onboarding-checklists.
  • Enquêtes (NPS, CSAT en meer).
  • Banners op paginaniveau en proactieve teasers gekoppeld aan het huidige scherm. Meld het huidige scherm met Respondo.setCurrentScreen("screen_name") bij navigatie — proactieve teasers en targeting op paginaniveau matchen ertegen.
  • Push-notificaties voor antwoorden van medewerkers en campagnes, met deep links naar het juiste gesprek.
Producttours en tooltips zijn alleen-web-oppervlakken en worden niet overgenomen in de mobiele SDK’s.

Hoe het werkt#

Elke SDK is een dunne client voor hetzelfde publieke widgetcontract als de webwidget — de backend wordt ongewijzigd hergebruikt. Berichten lopen over REST plus een WebSocket, en de bezorging valt netjes terug (WebSocket, dan SSE, dan REST-polling) en klimt weer omhoog zodra de verbinding herstelt.

Autorisatie is gelaagd:

  • visitor_id — een stabiele anonieme id die de SDK genereert en veilig op het apparaat opslaat: met de Android Keystore versleutelde preferences, de iOS-keychain, en op Flutter een app-privaat bestand in de storageDirectory die je aan init doorgeeft.
  • userHash — een HMAC-handtekening van je backend die een gesprek koppelt aan een echte persoon (identiteitsverificatie).
  • session-token — uitgegeven per gesprek en herhaald bij REST- en WebSocket-aanroepen.

Aan de slag#

Ga naar de platformpagina die bij je app past — Android SDK, iOS SDK of Flutter SDK — voor de installatie en een werkende init. Zet vervolgens Identiteitsverificatie op om ingelogde gebruikers over apparaten heen te herkennen, en Push-notificaties voor bezorging offline.

Elke SDK installeert vanuit zijn platformregister: Android vanaf Maven Central (ai.respondo:respondo-sdk), iOS via Swift Package Manager vanaf github.com/respondo-app/sdk-ios, en Flutter vanaf pub.dev (respondo_sdk). De bronnen van Android en iOS zijn openbaar op GitHub.