Мобильді SDK

Мобильді SDK - веб-виджеттің өз қолданбаларыңызға арналған баламасы: клиенттеріңіз қолданба ішінде сұхбаттардың толық тарихы мен push-хабарландырулары бар қолдау алады, ал операторларыңыз бұл сұхбаттарды сол кіріс жәшігінде көреді. Бұл командаңыздың операторларына арналған қолданбалар емес; олар бөлек өнім желісі.

Платформалар

Платформа	Тіл және орындау ортасы	Тарату	Күйі
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	әзірленуде
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	әзірленуде
React Native	нативті SDK-ге арналған қабықша	npm	жоспарланған (бета)
Flutter	нативті SDK-ге арналған қабықша	pub.dev	жоспарланған (бета)

Нативті SDK негізгі болып табылады; қабықшалар олардан кейін шығады. Сағат пен теледидар қолданбалары және жұмыс үстеліне арналған SDK ауқымға кірмейді; жұмыс үстелі үшін веб-виджетті пайдаланыңыз.

SDK құрамы

Мәтіндік хабарламалар, тіркемелер, дауыстық хабарламалар, суреттер мен бейнелер, анонимді және сәйкестендірілген сессиялар, тақырыптар, жеке аватар мен брендинг, 40 тіл, AI консьержі, сұхбаттар тарихы, оқылмағандар белгісі, push-хабарландырулар, терең сілтемелер, телефонның нөмір тергіші арқылы бір түртумен қоңырау шалу, фондық синхрондауы бар офлайн кезек, чатты биометриялық құлыптан босату, VoiceOver және TalkBack қолдауы, қараңғы режим. Компиляциядан кейінгі мақсатты өлшем: әр платформаға 5 MB немесе одан аз.

Қолданба ішіндегі WebRTC қоңыраулары мен клиент тарапынан экранды бөлісу кейінгі релизде қосылады. Бірлесіп шолу (cobrowse) тек вебте қолжетімді: мобильді операциялық жүйелер үшінші тараптың SDK-іне экранды бақылауға немесе басқаруға рұқсат бермейді.

SDK интерфейсі

Қолданбаның өмірлік циклінің басында бір рет инициализациялаңыз:

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

Пайдаланушы кіргеннен кейін оны сәйкестендіріңіз, ол шыққанда жүйеден шығарыңыз:

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

Интерфейсті көрсетіңіз:

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

Кері шақырулар: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Жария API iOS-та негізгі ағын үшін, Android-та фондық ағындар үшін қауіпсіз; қолданба фонға өткенде байланыстар үзіліп, алдыңғы жоспарға оралғанда қалпына келеді.

Сессиялар және сәйкестендіру

• Анонимді: keychain немесе шифрланған баптауларда сақталатын құрылғы сессиясының идентификаторы қолданба жаңартуларынан кейін де сақталады және пайдаланушыға емес, құрылғыға байланған. Ол 90 күн белсенділік болмағаннан кейін жойылады.
• Сәйкестендірілген: identify шақырылғаннан кейін сессия жоғарылатылып, бір мәнді болса, сол құрылғыдағы анонимді тарихпен біріктіріледі. Арналар арасындағы сәйкестендіру сәйкестік графының ережелері мен келісімге бағынады.
• Сенімді сәйкестендіру: бэкендіңіз пайдаланушы деректері бар токенге қол қояды; SDK оны жібереді, ал RolChat сессияны жоғарылатпас бұрын қолтаңбаны тексереді. Қол қойылмаған identify жұмыс істейді, бірақ сенім деңгейі төменірек.

Қолданбадағы жария API кілті құрылымы бойынша қауіпсіз: ол сайтпен шектелген және сұрау лимиті бар.

Push-хабарландырулар

Платформа	Тасымалдау	Сіз не бересіз
iOS	APNs	RolChat басқару тақтасындағы APNs аутентификация кілті
Android	FCM	FCM қызметтік аккаунтының JSON файлы

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

Хабарландыру мәтіні серверде пайдаланушының тіліне аударылады. Кеңейтілген хабарландырулар аватарды, хабарландырудан тікелей жауап беруді және оқылды деп белгілеуді қолдайды. SDK push рұқсатын ешқашан өздігінен сұрамайды; онбордингіңізге ыңғайлы сәтте requestPushPermission() шақырыңыз. Бас тарту setPushEnabled(false) немесе ОЖ баптаулары арқылы жасалады; екеуі де тіркеледі.

Нұсқалау және қолдау

Қатаң семантикалық нұсқалау. Бір уақытта екі негізгі нұсқа қолдау алады, негізгі релизден кейін көшуге бір жыл беріледі. Кіші релиздер ай сайын шығады; қауіпсіздік түзетулері дереу шығады; негізгі релиздер үш ай бұрын жарияланады. Ескірген немесе қолдау көрсетілмейтін SDK іске қосылғанда логқа ескерту жазады, ал басқару тақтасы оны «Интеграциялар» бөлімінде көрсетеді.

Құпиялылық

Сіз қосқаннан тыс ешқандай бақылау жоқ; келісім сұраулары платформаның нативті үлгілерін пайдаланады, ал GDPR, CCPA және LGPD бойынша деректер субъектілерінің сұраулары SDK сессияларына кез келген басқа арна сияқты қолданылады. Тіркемелер құрылғыда сығылып, қол қойылған URL-дерге жүктеледі және операторлар көрмей тұрып вирустарға тексеріледі.