Dokumentation

Mobile SDK

Bringen Sie denselben KI-plus-Mensch-Support-Chat, den Sie im Web betreiben, direkt in Ihre nativen Android-, iOS- und Flutter-Apps. Ein Backend-Vertrag, ein Verhalten, drei Plattformen.

Plattformen#

Drei native SDKs teilen sich eine identische öffentliche API-Oberfläche. Wählen Sie das, das zu Ihrer App passt:

SDKStackMinimum
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (keine Abhängigkeiten)iOS 15+, Swift 5.9+
FlutterReines Dart, keine nativen BridgesDart 3.4+, Flutter 3.16+

Jedes SDK rendert einen echten nativen Chat als Bottom Sheet über Ihrer App — keine WebView. Ihre App zeichnet den Einstiegspunkt (einen Button, ein Icon, ein Badge) und öffnet den Chat mit Respondo.open().

Was enthalten ist#

Die Mobile-SDKs spiegeln den Funktionsumfang des Web-Widgets:

  • Chat-Kern: KI-Agent, Live-Übergabe an Mitarbeiter, Tipp- und Lesestatus, Dateianhänge.
  • News-Feed ("Was ist neu") und Onboarding-Checklisten.
  • Umfragen (NPS, CSAT und mehr).
  • Banner auf Seitenebene und proaktive Teaser, die an den aktuellen Bildschirm gebunden sind. Melden Sie den aktuellen Bildschirm bei jeder Navigation mit Respondo.setCurrentScreen("screen_name") — proaktive Teaser und Targeting auf Seitenebene gleichen dagegen ab.
  • Push-Benachrichtigungen für Mitarbeiterantworten und Kampagnen, mit Deep Links in die richtige Konversation.
Product Tours und Tooltips sind reine Web-Oberflächen und werden nicht in die Mobile-SDKs übernommen.

Wie es funktioniert#

Jedes SDK ist ein schlanker Client für denselben öffentlichen Widget-Vertrag wie das Web-Widget — das Backend wird unverändert wiederverwendet. Das Messaging läuft über REST plus einen WebSocket, und die Zustellung fällt sauber zurück (WebSocket, dann SSE, dann REST-Polling) und steigt wieder auf, sobald die Verbindung sich erholt.

Die Autorisierung ist geschichtet:

  • visitor_id — eine stabile anonyme ID, die das SDK generiert und sicher auf dem Gerät speichert: Android-Keystore-verschlüsselte Preferences, der iOS-Schlüsselbund und unter Flutter eine app-private Datei im storageDirectory, das Sie an init übergeben.
  • userHash — eine HMAC-Signatur von Ihrem Backend, die eine Konversation an eine reale Person bindet (Identitätsverifizierung).
  • session-token — pro Konversation ausgestellt und bei REST- und WebSocket-Aufrufen erneut mitgesendet.

Erste Schritte#

Gehen Sie zur Plattformseite, die zu Ihrer App passt — Android SDK, iOS SDK oder Flutter SDK — für Installation und eine funktionierende Init. Verbinden Sie dann die Identitätsverifizierung, um angemeldete Nutzer geräteübergreifend wiederzuerkennen, und Push-Benachrichtigungen für die Offline-Zustellung.

Jedes SDK wird aus seiner Plattform-Registry installiert: Android aus Maven Central (ai.respondo:respondo-sdk), iOS über den Swift Package Manager aus github.com/respondo-app/sdk-ios, und Flutter aus pub.dev (respondo_sdk). Die Android- und iOS-Quellen sind öffentlich auf GitHub.