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.