Документація

Mobile SDK

Запустіть той самий чат підтримки з AI та живими операторами, який працює у вас у вебі, всередині нативних застосунків Android, iOS і Flutter. Один бекенд-контракт, одна поведінка, три платформи.

Платформи#

Три нативні SDK мають ідентичну публічну поверхню API. Оберіть той, що підходить вашому застосунку:

SDKСтекМінімум
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (без залежностей)iOS 15+, Swift 5.9+
FlutterЧистий Dart, без нативних мостівDart 3.4+, Flutter 3.16+

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

Що включено#

Мобільні SDK дзеркалять набір можливостей вебвіджета:

  • Ядро чату: AI-агент, передавання розмови живому оператору наживо, стани набору й прочитання, вкладені файли.
  • Стрічка новин («Що нового») і чек-листи онбордингу.
  • Опитування (NPS, CSAT тощо).
  • Банери рівня сторінки й проактивні тизери, прив’язані до поточного екрана. Повідомляйте поточний екран через Respondo.setCurrentScreen("screen_name") під час навігації — проактивні тизери й таргетинг рівня сторінки зіставляються з ним.
  • Push-сповіщення про відповіді операторів і кампанії, з глибокими посиланнями (deep link) до потрібної розмови.
Продуктові тури й підказки — це поверхні лише для вебу, вони не переносяться в мобільні SDK.

Як це працює#

Кожен SDK — це тонкий клієнт до того самого публічного контракту віджета, що й вебвіджет — бекенд перевикористовується без змін. Обмін повідомленнями йде через REST плюс WebSocket, а доставка плавно деградує (WebSocket, потім SSE, потім REST-полінг) і повертається на вищий рівень тієї ж миті, щойно з’єднання відновлюється.

Авторизація багатошарова:

  • visitor_id — стабільний анонімний ідентифікатор, який SDK генерує й надійно зберігає на пристрої: зашифровані через Android Keystore preferences, keychain iOS, а на Flutter — приватний файл застосунку в storageDirectory, який ви передаєте в init.
  • userHash — HMAC-підпис від вашого бекенду, що прив’язує розмову до реальної людини (верифікація особи).
  • session-token — видається на кожну розмову й повторно передається у REST- та WebSocket-викликах.

Початок роботи#

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

Кожен 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.