Dokumentacja

Mobile SDK

Uruchom ten sam czat wsparcia łączący AI i ludzi, który działa w sieci, wewnątrz natywnych aplikacji Android, iOS i Flutter. Jeden kontrakt backendu, jedno zachowanie, trzy platformy.

Platformy#

Trzy natywne SDK współdzielą identyczną publiczną powierzchnię API. Wybierz to, które pasuje do Twojej aplikacji:

SDKStos technologicznyMinimum
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (zero zależności)iOS 15+, Swift 5.9+
FlutterCzysty Dart, brak natywnych mostówDart 3.4+, Flutter 3.16+

Każde SDK renderuje prawdziwy natywny czat jako dolny arkusz (bottom sheet) nad Twoją aplikacją — a nie WebView. Twoja aplikacja rysuje punkt wejścia (przycisk, ikonę, plakietkę) i otwiera czat wywołaniem Respondo.open().

Co wchodzi w skład#

Mobilne SDK odwzorowują zestaw funkcji widgetu webowego:

  • Rdzeń czatu: agent AI, przekazanie na żywo do operatorów, stan pisania i odczytu, załączniki plików.
  • Kanał nowości („Co nowego”) i listy kontrolne onboardingu.
  • Ankiety (NPS, CSAT i inne).
  • Banery na poziomie strony i proaktywne zajawki powiązane z bieżącym ekranem. Zgłaszaj bieżący ekran przez Respondo.setCurrentScreen("screen_name") przy nawigacji — proaktywne zajawki i targetowanie na poziomie strony dopasowują się do niego.
  • Powiadomienia push o odpowiedziach operatorów i kampaniach, z linkami głębokimi do właściwej rozmowy.
Przewodniki produktowe (product tours) i dymki podpowiedzi to powierzchnie wyłącznie webowe i nie są przenoszone do mobilnych SDK.

Jak to działa#

Każde SDK to cienki klient tego samego publicznego kontraktu widgetu co widget webowy — backend jest wykorzystywany ponownie bez zmian. Komunikaty przesyłane są przez REST oraz WebSocket, a dostarczanie płynnie schodzi na metody zapasowe (WebSocket, następnie SSE, następnie odpytywanie REST) i wraca w górę w momencie, gdy połączenie się odzyska.

Autoryzacja jest warstwowa:

  • visitor_id — stabilny anonimowy identyfikator, który SDK generuje i przechowuje bezpiecznie na urządzeniu: preferencje szyfrowane przez Android Keystore, keychain iOS, a we Flutterze prywatny plik aplikacji w storageDirectory przekazywanym do init.
  • userHash — podpis HMAC z Twojego backendu, który wiąże rozmowę z realną osobą (weryfikacja tożsamości).
  • session-token — wydawany dla każdej rozmowy i dołączany ponownie do wywołań REST i WebSocket.

Rozpocznij#

Przejdź do strony platformy pasującej do Twojej aplikacji — Android SDK, iOS SDK lub Flutter SDK — po instrukcje instalacji i działającą inicjalizację. Następnie skonfiguruj weryfikację tożsamości, aby rozpoznawać zalogowanych użytkowników na różnych urządzeniach, oraz powiadomienia push dla dostarczania w trybie offline.

Każde SDK instaluje się z rejestru swojej platformy: Android z Maven Central (ai.respondo:respondo-sdk), iOS przez Swift Package Manager z github.com/respondo-app/sdk-ios, a Flutter z pub.dev (respondo_sdk). Źródła Androida i iOS są publicznie dostępne na GitHub.