Mobilné SDK

Mobilné SDK sú obdobou webového widgetu pre vaše vlastné aplikácie: zákazníci dostanú podporu priamo v aplikácii s úplnou históriou konverzácií a push oznámeniami a vaši agenti vidia tieto konverzácie v tej istej schránke. Nejde o aplikácie pre agentov vášho tímu; tie sú samostatnou produktovou radou.

Platformy

Platforma	Jazyk a prostredie	Distribúcia	Stav
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	vo vývoji
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	vo vývoji
React Native	obal nad natívnymi SDK	npm	plánované (beta)
Flutter	obal nad natívnymi SDK	pub.dev	plánované (beta)

Natívne SDK sú rozhodujúce; obaly vychádzajú až po nich. Aplikácie pre hodinky či televízory a desktopové SDK nie sú v pláne; na desktope použite webový widget.

Čo SDK obsahuje

Textové správy, prílohy, hlasové správy, obrázky a video, anonymné a identifikované relácie, motívy, vlastný avatar a branding, 40 jazykov, AI concierge, históriu konverzácií, odznaky neprečítaných, push oznámenia, deep linky, volanie jedným ťuknutím cez telefónnu aplikáciu, front offline so synchronizáciou na pozadí, biometrické odomknutie chatu, podporu VoiceOver a TalkBack, tmavý režim. Cieľová veľkosť po kompilácii: 5 MB alebo menej na platformu.

Hovory WebRTC v aplikácii a zdieľanie obrazovky zo strany zákazníka prídu v neskoršom vydaní. Spoločné prezeranie funguje len na webe: mobilné operačné systémy nedovoľujú SDK tretej strany sledovať alebo ovládať obrazovku.

Rozhranie SDK

Inicializujte raz, skoro v životnom cykle aplikácie:

// iOS
let config = RolChatConfig(
  siteId: "site_abc123",
  apiKey: "pk_live_…",      // public key - safe to ship in the app
  region: .eu,              // eu / us
  theme: RolChatTheme(primaryColor: .blue)
)
RolChat.shared.initialize(config: config)

// Android
val config = RolChatConfig.Builder()
  .siteId("site_abc123")
  .apiKey("pk_live_…")
  .region(Region.EU)
  .theme(RolChatTheme(primaryColor = Color.Blue))
  .build()
RolChat.initialize(context, config)

Identifikujte používateľa po prihlásení a odhláste ho, keď sa odhlási:

RolChat.shared.identify(userId: "user_12345", email: "alice@example.com", name: "Alice",
                        metadata: ["tier": "gold"])
RolChat.shared.logout()   // on host-app sign-out, or the next user sees this history

Zobrazenie rozhrania:

RolChat.shared.openChat()                      // modal
RolChat.shared.openChat(conversationId: id)    // a specific conversation
RolChat.shared.openChatInline(view)            // inside your own layout
RolChat.shared.close()

Spätné volania: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Verejné API je v iOS bezpečné pre hlavné vlákno a v Androide pre vlákna na pozadí; spojenia sa prerušia, keď aplikácia prejde na pozadie, a obnovia sa po návrate do popredia.

Relácie a identita

• Anonymná: ID relácie zariadenia uložené v kľúčenke alebo šifrovaných predvoľbách prežije aktualizácie aplikácie a je viazané na zariadenie, nie na používateľa. Po 90 dňoch nečinnosti sa odstráni.
• Identifikovaná: po identify sa relácia povýši a zlúči s anonymnou históriou na tom istom zariadení, ak je to jednoznačné. Rozpoznanie identity naprieč kanálmi sa riadi pravidlami grafu identít a súhlasom.
• Dôveryhodná identifikácia: váš backend podpíše token s údajmi o používateľovi; SDK ho odovzdá a RolChat pred povýšením relácie overí podpis. Nepodpísané identify funguje, ale s nižšou dôverou.

Verejný kľúč API v aplikácii je bezpečný už z princípu: je obmedzený na web a podlieha limitom požiadaviek.

Push oznámenia

Platforma	Prenos	Čo dodáte
iOS	APNs	Overovací kľúč APNs v administrácii RolChat
Android	FCM	JSON servisného účtu FCM

RolChat.shared.setPushToken(deviceToken, type: .apns)
if RolChat.shared.handleNotification(userInfo) { return }   // consumed: a chat message

Text oznámení sa lokalizuje na serveri do jazyka používateľa. Rozšírené oznámenia podporujú avatar, odpoveď priamo z oznámenia a označenie ako prečítané. SDK nikdy samo nežiada o povolenie push; zavolajte requestPushPermission(), keď sa to hodí do vášho procesu spustenia. Odhlásenie je setPushEnabled(false) alebo nastavenia systému; obe sa zaznamenajú.

Verzovanie a podpora

Striktné sémantické verzovanie. Podporované sú súčasne dve hlavné verzie, s ročným obdobím na migráciu po vydaní hlavnej verzie. Vedľajšie vydania vychádzajú mesačne; bezpečnostné opravy okamžite; hlavné vydania sa oznamujú tri mesiace vopred. Zastarané alebo nepodporované SDK zapíše pri štarte varovanie do logu a administrácia ho ukáže v sekcii Integrácie.

Súkromie

Žiadne sledovanie nad rámec toho, čo zapnete, okná súhlasu používajú natívne vzory platformy a žiadosti dotknutých osôb podľa GDPR, CCPA a LGPD pokrývajú relácie SDK rovnako ako akýkoľvek iný kanál. Prílohy sa komprimujú v zariadení, nahrávajú na podpísané URL a kontrolujú antivírusom skôr, než ich agenti uvidia.