Mobilní SDK

Mobilní SDK jsou obdobou webového widgetu pro vaše vlastní aplikace: zákazníci dostanou podporu přímo v aplikaci s úplnou historií konverzací a push oznámeními a vaši agenti vidí tyto konverzace ve stejné schránce. Nejde o aplikace pro agenty vašeho týmu; ty jsou samostatnou produktovou řadou.

Platformy

Platforma	Jazyk a prostředí	Distribuce	Stav
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	ve vývoji
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	ve vývoji
React Native	obal nad nativními SDK	npm	plánováno (beta)
Flutter	obal nad nativními SDK	pub.dev	plánováno (beta)

Nativní SDK jsou rozhodující; obaly vycházejí až po nich. Aplikace pro hodinky či televize a desktopová SDK nejsou v plánu; na desktopu použijte webový widget.

Co SDK obsahuje

Textové zprávy, přílohy, hlasové zprávy, obrázky a video, anonymní a identifikované relace, motivy, vlastní avatar a branding, 40 jazyků, AI concierge, historii konverzací, odznaky nepřečtených, push oznámení, deep linky, volání jedním klepnutím přes telefonní aplikaci, frontu offline se synchronizací na pozadí, biometrické odemčení chatu, podporu VoiceOver a TalkBack, tmavý režim. Cílová velikost po kompilaci: 5 MB nebo méně na platformu.

Hovory WebRTC v aplikaci a sdílení obrazovky ze strany zákazníka přijdou v pozdějším vydání. Společné prohlížení funguje jen na webu: mobilní operační systémy nedovolují SDK třetí strany sledovat nebo ovládat obrazovku.

Rozhraní SDK

Inicializujte jednou, brzy v životním cyklu aplikace:

// 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 uživatele po přihlášení a odhlaste ho, když se odhlásí:

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

Zobrazení rozhraní:

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

Zpětná volání: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Veřejné API je v iOS bezpečné pro hlavní vlákno a v Androidu pro vlákna na pozadí; spojení se přeruší, když aplikace přejde na pozadí, a obnoví se po návratu do popředí.

Relace a identita

• Anonymní: ID relace zařízení uložené v klíčence nebo šifrovaných předvolbách přežije aktualizace aplikace a je vázané na zařízení, ne na uživatele. Po 90 dnech nečinnosti se odstraní.
• Identifikovaná: po identify se relace povýší a sloučí s anonymní historií na stejném zařízení, pokud je to jednoznačné. Rozpoznání identity napříč kanály se řídí pravidly grafu identit a souhlasem.
• Důvěryhodná identifikace: váš backend podepíše token s údaji o uživateli; SDK ho předá a RolChat před povýšením relace ověří podpis. Nepodepsané identify funguje, ale s nižší důvěrou.

Veřejný klíč API v aplikaci je bezpečný už z principu: je omezený na web a podléhá limitům požadavků.

Push oznámení

Platforma	Přenos	Co dodáte
iOS	APNs	Ověřovací klíč APNs v administraci 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í se lokalizuje na serveru do jazyka uživatele. Rozšířená oznámení podporují avatar, odpověď přímo z oznámení a označení jako přečtené. SDK nikdy samo nežádá o povolení push; zavolejte requestPushPermission(), až se to hodí do vašeho procesu zprovoznění. Odhlášení je setPushEnabled(false) nebo nastavení systému; obojí se zaznamená.

Verzování a podpora

Striktní sémantické verzování. Podporovány jsou současně dvě hlavní verze, s ročním obdobím na migraci po vydání hlavní verze. Vedlejší vydání vycházejí měsíčně; bezpečnostní opravy okamžitě; hlavní vydání se oznamují tři měsíce předem. Zastaralé nebo nepodporované SDK zapíše při startu varování do logu a administrace ho ukáže v sekci Integrace.

Soukromí

Žádné sledování nad rámec toho, co zapnete, okna souhlasu používají nativní vzory platformy a žádosti subjektů údajů podle GDPR, CCPA a LGPD pokrývají relace SDK stejně jako jakýkoli jiný kanál. Přílohy se komprimují v zařízení, nahrávají na podepsané URL a kontrolují antivirem, než je agenti uvidí.