Mobiili-SDK:t

Mobiili-SDK:t ovat verkkowidgetin vastine omille sovelluksillesi: asiakkaasi saavat sovelluksen sisäistä tukea täydellä keskusteluhistorialla ja push-ilmoituksilla, ja agenttisi näkevät nämä keskustelut samassa postilaatikossa. Ne eivät ole tiimisi agenttisovelluksia; ne ovat erillinen tuotelinja.

Alustat

Alusta	Kieli ja ajoympäristö	Jakelu	Tila
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	kehitteillä
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	kehitteillä
React Native	käärii natiivit SDK:t	npm	suunnitteilla (beta)
Flutter	käärii natiivit SDK:t	pub.dev	suunnitteilla (beta)

Natiivit SDK:t ovat ensisijaisia; kääreet julkaistaan niiden jälkeen. Kello- ja TV-sovellukset sekä työpöytä-SDK:t eivät kuulu laajuuteen; käytä työpöydällä verkkowidgetiä.

Mitä SDK sisältää

Tekstiviestintä, liitteet, ääniviestit, kuvat ja videot, anonyymit ja tunnistetut istunnot, teemat, mukautettu avatar ja brändäys, 40 kieltä, AI-concierge, keskusteluhistoria, lukemattomien merkit, push-ilmoitukset, syvälinkit, soitto puhelimen numeronvalitsimen kautta, offline-jonotus taustasynkronoinnilla, chatin biometrinen avaus, VoiceOver- ja TalkBack-tuki, tumma tila. Tavoiteltu käännetty koko: enintään 5 Mt alustaa kohden.

Sovelluksen sisäiset WebRTC-puhelut ja asiakkaan näytön jakaminen tulevat myöhemmässä julkaisussa. Yhteisselaus toimii vain verkossa: mobiilikäyttöjärjestelmät eivät salli kolmannen osapuolen SDK:n tarkkailla tai ohjata näyttöä.

SDK:n rajapinta

Alusta kerran, varhain sovelluksen elinkaaressa:

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

Tunnista käyttäjä hänen kirjauduttuaan sisään ja kirjaa ulos, kun hän kirjautuu ulos:

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

Näytä käyttöliittymä:

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

Takaisinkutsut: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Julkinen API on iOS:llä turvallinen pääsäikeessä ja Androidilla taustasäikeessä; yhteydet katkeavat, kun sovellus siirtyy taustalle, ja jatkuvat, kun se palaa etualalle.

Istunnot ja identiteetti

• Anonyymi: avainnippuun tai salattuihin asetuksiin tallennettu laitteen istuntotunnus säilyy sovelluspäivitysten yli ja on sidottu laitteeseen, ei käyttäjään. Se poistetaan 90 päivän toimettomuuden jälkeen.
• Tunnistettu: identify-kutsun jälkeen istunto korotetaan ja yhdistetään saman laitteen anonyymiin historiaan, kun se on yksiselitteistä. Kanavien välinen identiteetin selvitys noudattaa identiteettigraafin sääntöjä ja suostumusta.
• Luotettu tunnistus: taustajärjestelmäsi allekirjoittaa tunnisteen käyttäjän väitteillä; SDK välittää sen, ja RolChat tarkistaa allekirjoituksen ennen istunnon korottamista. Allekirjoittamaton identify toimii, mutta sen luotettavuus on alhaisempi.

Sovelluksessa oleva julkinen API-avain on suunnitellusti turvallinen: se on rajattu sivustoon ja nopeusrajoitettu.

Push-ilmoitukset

Alusta	Siirtotapa	Sinä toimitat
iOS	APNs	APNs-todennusavaimen RolChatin hallintapaneeliin
Android	FCM	FCM-palvelutilin JSON-tiedoston

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

Ilmoitusten teksti lokalisoidaan palvelimella käyttäjän kielelle. Rikkaat ilmoitukset tukevat avataria, vastaamista suoraan ilmoituksesta ja luetuksi merkitsemistä. SDK ei koskaan pyydä push-lupaa itsestään; kutsu requestPushPermission(), kun se sopii käyttöönottopolkuusi. Kieltäytyminen tehdään kutsulla setPushEnabled(false) tai käyttöjärjestelmän asetuksista; molemmat tallennetaan.

Versiointi ja tuki

Tiukka semanttinen versiointi. Kahta pääversiota tuetaan samanaikaisesti, ja siirtymiseen on aikaa vuosi pääversion julkaisusta. Alaversiot julkaistaan kuukausittain; tietoturvakorjaukset julkaistaan välittömästi; pääversioista ilmoitetaan kolme kuukautta etukäteen. Käytöstä poistettu tai tukematon SDK kirjaa varoituksen käynnistyksen yhteydessä, ja hallintapaneeli näyttää sen Integraatiot-kohdassa.

Tietosuoja

Ei seurantaa sen lisäksi, mitä otat käyttöön; suostumusnäkymät käyttävät alustan natiiveja malleja, ja GDPR-, CCPA- ja LGPD-lainsäädännön mukaiset rekisteröityjen pyynnöt kattavat SDK-istunnot kuten minkä tahansa muun kanavan. Liitteet pakataan laitteella, ladataan allekirjoitettuihin URL-osoitteisiin ja tarkistetaan viruksilta ennen kuin agentit näkevät ne.