Перейти до основного вмісту
Почати
ДокументаціяОгляд

Підтримка всередині вашого продукту

Використовуйте однаковий досвід розмов DobroDesk у вебі та нативних мобільних застосунках. Почніть з однієї платформи й збережіть спільні налаштування інтеграції віджета, ідентичності та вигляду для всіх інтеграцій.

Оберіть спосіб інтеграції

Вебвіджет

v0.3.1

Браузерний віджет для сайтів і вебзастосунків.

Сучасний браузер із увімкненим JavaScript

@dobrodesk/widgetІнтегрувати вебвіджет

iOS

v0.2.0

Нативний Swift UI для застосунків на UIKit або SwiftUI.

iOS 15.1 або новіша

Інтегрувати iOS

Android

v0.2.0

Нативний Kotlin UI для застосунків на Views або Jetpack Compose.

Android API 26 або новіша

Інтегрувати Android

Flutter

v0.2.0

Типізований Dart-фасад над нативними мобільними SDK.

Flutter 3.22.3 і Dart 3.4 або новіші

dobrodesk_sdkІнтегрувати Flutter

React Native

v0.2.0

Нативний модуль і екран для застосунків React Native.

React Native від 0.76 до версій нижче 0.88

@dobrodesk/react-native-sdkІнтегрувати React Native

NativeScript

v0.2.0

Типізований TypeScript API на основі нативних SDK платформи.

NativeScript від 8.9 до версій нижче 10

@dobrodesk/nativescript-sdkІнтегрувати NativeScript

Capacitor

v0.2.0

Нативний плагін для проєктів Capacitor на iOS та Android.

Capacitor від 6 до версій нижче 9

@dobrodesk/capacitor-sdkІнтегрувати Capacitor

Швидкий старт Mobile SDK

Нативні SDK та обгортки фреймворків мають однаковий процес інтеграції. Для вебвіджета скористайтеся гайдом вебплатформи.

  1. Оберіть платформу

    Використовуйте нативний SDK для Swift або Kotlin. Для Flutter, React Native, NativeScript чи Capacitor використовуйте відповідну обгортку.

  2. Встановіть пакет

    Виконайте інструкцію платформи й зафіксуйте версію пакета 0.2.0. Для React Native в Expo потрібен development build; Expo Go не підтримує цей нативний модуль.

  3. Підключіть віджет та ідентичність

    Створіть або виберіть канал віджета DobroDesk і його Integration ID. Ваш бекенд підписує короткоживучий JWT. Не додавайте signing secret до бандла застосунку.

  4. Ініціалізуйте один раз

    Створіть екземпляр SDK під час запуску застосунку, передайте спільні налаштування інтеграції віджета та вигляду й використовуйте цей екземпляр протягом сесії.

  5. Покажіть розмову

    Відкрийте нативний екран розмови з дії підтримки. Поведінка відповідає вебвіджету, а навігація, клавіатура та поля введення залишаються нативними.

  6. Завершуйте сесію користувача

    Використовуйте logout для обгорток Flutter, React Native, NativeScript і Capacitor. Для прямих Swift або Kotlin-клієнтів викличте resetSession(), видаліть клієнт і створіть новий перед зміною accountScope. Очистьте стан екрана, що належить попередньому користувачеві.

Перегляд нативних SDK

Подивіться, як один і той самий сценарій підтримки виглядає з нативними елементами iOS та Android.

Екран чату нативного iOS SDK DobroDesk із повідомленням підтримки, полем введення та нижньою навігацією
iOS SDK: розмова з підтримкою, нативне поле введення та нижня панель вкладок.
Екран чату нативного Android SDK DobroDesk з локалізованими повідомленнями клієнта й асистента, нативним полем введення та нижньою навігацією
Android SDK: локалізована розмова з підтримкою, нативне поле введення та нижня навігація.

Спільні інструкції

Ідентичність і підписані сесії

Створюйте короткоживучі JWT на сервері й не зберігайте секрет у застосунку.

Вигляд і доступність

Використовуйте спільний бренд із нативними контролами, reduced motion і системними налаштуваннями.

Офлайн і доставка

Дізнайтеся про чернетки, чергу повідомлень, повтори та підтвердження доставки.

Додаткові можливості

Додавайте push-сповіщення або голос лише тоді, коли вони потрібні застосунку.

FAQ мобільного SDK

Відповіді про версії, сесії, дозволи та оновлення.

Підтримувані версії

Це мінімальні версії та діапазони фреймворків для релізу 0.2.0. Перед оновленням застосунку перевіряйте release notes.

iOS
15.1 або новіша
Android
API 26 або новіша
Flutter
Flutter 3.22.3+, Dart 3.4+
React Native
від 0.76 до версій нижче 0.88
NativeScript
від 8.9 до версій нижче 10
Capacitor
від 6 до версій нижче 9
Вебвіджет
Web widget 0.3.1

Поширені запитання

Чи можна використовувати SDK без push-сповіщень або голосу?

Так. Push і voice є додатковими можливостями. Базовий SDK розмови не потребує їхніх системних дозволів або налаштування провайдера.

Де створювати JWT?

Створюйте його на бекенді за допомогою integration-specific identity secret, який повертає кнопка Copy identity secret у каналі Widget. Повертайте застосунку короткоживучий токен. Не додавайте цей секрет до iOS, Android або JavaScript-коду.

Що відбувається при нестабільному інтернеті?

SDK зберігає повідомлення в стані очікування, доки не отримає результат доставки. Він може поставити роботу в чергу офлайн і повідомити стан для повтору без непомітного дублювання.

Чи є мобільний UI WebView вебвіджета?

Ні. Mobile SDK використовує нативний UI iOS та Android. Він поділяє вигляд і поведінку розмов із вебвіджетом, але зберігає нативну навігацію, клавіатуру та доступність.

Чи працює SDK в Expo Go?

Ні. Інтеграція React Native використовує нативні модулі. Для Expo потрібен development build або згенерований нативний проєкт.

Відкрити технічний FAQ мобільного SDK

Версії та пакети

Mobile SDK 0.2.0 поширюється через пакетні реєстри платформ і публічний release bundle. Android bundle використовує локальний Maven-репозиторій. Нативний UI реалізовано нативними SDK iOS та Android; обгортки не завантажують вебвіджет у WebView.