Mobilieji SDK

Mobilieji SDK yra žiniatinklio valdiklio atitikmuo jūsų programėlėms: jūsų klientai gauna pagalbą programėlėje su visa pokalbių istorija ir tiesioginiais pranešimais, o jūsų agentai tuos pokalbius mato toje pačioje gautųjų dėžutėje. Tai nėra agentų programėlės jūsų komandai; jos yra atskira produktų linija.

Platformos

Platforma	Kalba ir vykdymo aplinka	Platinimas	Būsena
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	kuriama
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	kuriama
React Native	apgaubia natūralius SDK	npm	planuojama (beta)
Flutter	apgaubia natūralius SDK	pub.dev	planuojama (beta)

Natūralūs SDK yra pagrindiniai; apgaubai išleidžiami po jų. Laikrodžių ar televizorių programėlės ir darbalaukio SDK nenumatyti; darbalaukiui naudokite žiniatinklio valdiklį.

Ką apima SDK

Teksto žinutės, priedai, balso žinutės, paveikslėliai ir vaizdo įrašai, anoniminės ir atpažintos sesijos, temos, pasirinktinis avataras ir prekės ženklas, 40 kalbų, AI konsjeržas, pokalbių istorija, neperskaitytų ženkleliai, tiesioginiai pranešimai, gilios nuorodos, skambinimas vienu spustelėjimu per telefono rinkiklį, eilė neprisijungus su sinchronizavimu fone, biometrinis pokalbio atrakinimas, VoiceOver ir TalkBack palaikymas, tamsusis režimas. Tikslinis sukompiliuotas dydis: 5 MB ar mažiau kiekvienai platformai.

WebRTC skambučiai programėlėje ir kliento ekrano bendrinimas bus vėlesniame leidime. Bendras naršymas veikia tik žiniatinklyje: mobiliosios operacinės sistemos neleidžia trečiosios šalies SDK stebėti ar valdyti ekrano.

SDK sąsaja

Inicijuokite vieną kartą, ankstyvame programėlės gyvavimo ciklo etape:

// 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)

Atpažinkite naudotoją jam prisijungus ir atjunkite, kai jis atsijungia:

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

Parodykite sąsają:

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

Atgaliniai iškvietimai: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Vieša API yra saugi pagrindinėje gijoje iOS ir foninėse gijose Android; ryšiai nutrūksta, kai programėlė pereina į foną, ir atsinaujina grįžus į priekinį planą.

Sesijos ir tapatybė

• Anoniminė: įrenginio sesijos ID, saugomas keychain arba šifruotose nuostatose, išlieka atnaujinus programėlę ir yra susietas su įrenginiu, o ne naudotoju. Jis išvalomas po 90 dienų neveiklumo.
• Atpažinta: po identify sesija paaukštinama ir, kai tai vienareikšmiška, sujungiama su anonimine istorija tame pačiame įrenginyje. Tapatybės nustatymas skirtinguose kanaluose vyksta pagal tapatybių grafo taisykles ir sutikimą.
• Patikimas atpažinimas: jūsų serveris pasirašo žetoną su naudotojo teiginiais; SDK jį perduoda, o RolChat patikrina parašą prieš paaukštindamas sesiją. Nepasirašytas identify veikia, bet yra mažiau patikimas.

Viešas API raktas programėlėje saugus iš principo: jis apribotas svetaine, o užklausų skaičius ribojamas.

Tiesioginiai pranešimai

Platforma	Perdavimas	Jūs pateikiate
iOS	APNs	APNs autentifikavimo raktą RolChat skydelyje
Android	FCM	FCM paslaugos paskyros JSON

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

Pranešimų tekstas lokalizuojamas serveryje pagal naudotojo lokalę. Raiškieji pranešimai palaiko avatarą, atsakymą iš pranešimo ir žymėjimą kaip perskaitytą. SDK niekada pats neprašo leidimo siųsti tiesioginius pranešimus; iškvieskite requestPushPermission(), kai tai tinka jūsų įvedimo procesui. Atsisakoma su setPushEnabled(false) arba OS nustatymuose; abu atvejai registruojami.

Versijos ir palaikymas

Griežtas semantinis versijavimas. Vienu metu palaikomos dvi pagrindinės versijos, o po pagrindinio leidimo migracijai skiriami metai. Smulkūs leidimai kas mėnesį; saugumo pataisos išleidžiamos iškart; apie pagrindinius leidimus pranešama prieš tris mėnesius. Nebepalaikomas SDK paleidžiant įrašo įspėjimą, o skydelis jį rodo skiltyje Integracijos.

Privatumas

Jokio sekimo, išskyrus tai, ką įjungiate, sutikimo sąsajos naudoja natūralius platformos šablonus, o GDPR, CCPA ir LGPD duomenų subjektų prašymai apima SDK sesijas kaip ir bet kurį kitą kanalą. Priedai suspaudžiami įrenginyje, įkeliami į pasirašytus URL ir patikrinami dėl virusų, prieš juos pamatant agentams.