Mobile SDK

Разверните тот же чат поддержки с ИИ и живыми операторами, что работает у вас в вебе, внутри нативных приложений Android, iOS и Flutter. Один backend-контракт, одно поведение, три платформы.

Платформы#

Три нативных SDK разделяют одинаковую публичную поверхность API. Выберите тот, что подходит вашему приложению:

SDK	Стек	Минимум
Android	Kotlin, Jetpack Compose	minSdk 24, Kotlin 2.x
iOS	Swift, SwiftUI (без зависимостей)	iOS 15+, Swift 5.9+
Flutter	Чистый Dart, без нативных мостов	Dart 3.4+, Flutter 3.16+

Каждый SDK отрисовывает настоящий нативный чат в виде нижнего листа (bottom sheet) поверх вашего приложения — не WebView. Ваше приложение рисует точку входа (кнопку, иконку, бейдж) и открывает чат вызовом Respondo.open().

Что входит#

Мобильные SDK повторяют набор возможностей веб-виджета:

Ядро чата: ИИ-агент, живая передача живым операторам, индикаторы набора и прочтения, вложения файлов.
Лента новостей («Что нового») и чек-листы онбординга.
Опросы (NPS, CSAT и другие).
Баннеры уровня страницы и проактивные тизеры, привязанные к текущему экрану. Сообщайте текущий экран через Respondo.setCurrentScreen("screen_name") при навигации — проактивные тизеры и таргетинг уровня страницы срабатывают по нему.
Пуш-уведомления об ответах операторов и о кампаниях, с диплинками в нужный диалог.

Продуктовые туры и тултипы — это веб-только поверхности, в мобильные SDK они не переносятся.

Как это работает#

Каждый SDK — это тонкий клиент того же публичного контракта виджета, что и веб-виджет: backend переиспользуется без изменений. Обмен сообщениями идёт по REST плюс WebSocket, а доставка мягко деградирует (WebSocket, затем SSE, затем REST-поллинг) и снова поднимается вверх, как только соединение восстанавливается.

Авторизация многослойная:

visitor_id — стабильный анонимный id, который SDK генерирует и надёжно хранит на устройстве: зашифрованные Android Keystore настройки, keychain iOS, а во Flutter — приватный файл приложения в storageDirectory, который вы передаёте в init.
userHash — HMAC-подпись от вашего backend, которая привязывает диалог к реальному человеку (проверка личности).
session-token — выдаётся на каждый диалог и переотправляется в REST- и WebSocket-вызовах.

С чего начать#

Перейдите на страницу платформы, соответствующей вашему приложению — Android SDK, iOS SDK или Flutter SDK — за инструкцией по установке и рабочей инициализацией. Затем подключите Проверку личности, чтобы узнавать вошедших пользователей на разных устройствах, и Пуш-уведомления для доставки офлайн.

Каждый SDK ставится из реестра своей платформы: Android — из Maven Central (ai.respondo:respondo-sdk), iOS — через Swift Package Manager из github.com/respondo-app/sdk-ios, а Flutter — из pub.dev (respondo_sdk). Исходники Android и iOS открыты на GitHub.