Базовий SDK чату не запитує дозволів. Вибрані хости окремо вмикають APNs, FCM або нативні голосові розмови.
Явно виберіть можливість
Чат і нативний віджет є базовими можливостями. Mobile SDK 0.4.0 додає опційну голосову розмову для прямих дзвінків WebRTC із фахівцем і передачі від ШІ фахівцю. На iOS хост підключає окремий продукт `DobroDeskVoiceConversation`. На Android додає `com.dobrodesk:dobrodesk-voice:0.4.0` із локального Maven-репозиторію бандла. Наявний шлях `DobroDeskVoice` лише для ШІ залишається окремим. Усі чотири framework-обгортки надають `client.attachNativeConversationVoice()` після встановлення хостом опційної нативної фабрики. Власний або headless-хост може передати `DobroDeskVoiceConversationPort` через `attachConversationVoice(port)`.
Залишайте voice і push опційними. Хост оголошує дозвіл на мікрофон, надає Android-запитувач runtime-дозволу та встановлює нативну voice-фабрику. SDK запитує доступ до мікрофона лише після вибору користувачем голосової дії. Дзвінок завершується, коли віджет приховано або застосунок залишає передній план. Згода на використання ШІ та згода на запис дзвінка є різними. SDK для відвідувачів не здійснює телефонні дзвінки PSTN, не включає інтеграцію з CallKit і не підтримує дзвінки у фоні.
// Register the extracted bundle's native/maven directory in host settings first.
dependencies {
implementation("com.dobrodesk:dobrodesk-voice:0.4.0") // optional
// implementation("com.dobrodesk:dobrodesk-push:0.4.0") // optional
}Виберіть, хто доставляє push
У Налаштування > Канали > Мобільні push виберіть вимкнений режим, якщо застосунку не потрібні сповіщення підтримки. Виберіть зовнішню доставку, якщо push уже надсилає ваш бекенд, або керовану доставку, якщо це має робити DobroDesk через APNs чи FCM. Ключі провайдера в DobroDesk потрібні лише для керованої доставки. Зміна режиму зберігає наявні ключі та не надає дозвіл на сповіщення на пристрої. Вимкнений режим зупиняє доставку через DobroDesk. Ваш бекенд сам керує своїми сповіщеннями та відмовою від них, а наявні підписки webhook залишаються активними.
Для доставки через ваш застосунок реєструйте токени пристроїв на своєму автентифікованому бекенді та підпишіть його на підписаний webhook message.created. Перевіряйте підпис і workspaceId. За data.direction, data.visibility та data.authorKind приймайте лише публічні вихідні відповіді й усувайте дублікати за id події.
Подія містить data.conversationId, data.messageId і data.customerId. У ній немає ID інтеграції, контексту акаунта, ID сесії чи тексту повідомлення. Перед вибором токена визначайте акаунт, інтеграцію, сесію та розмову через власну автентифіковану прив'язку реєстрації. Збігу клієнта в межах усієї робочої області недостатньо. Надсилайте загальне сповіщення без тексту відповіді.
Використовуйте опублікований типізований event hook клієнта (`client.events` у Flutter або `client.subscribe(...)` у JavaScript-обгортках), коли застосунок і нативний клієнт активні. Обробляйте `snapshot` у власному in-app UI розмови.
Hook надсилає `snapshot` після запуску або відновлення сесії клієнта чи після явного виклику `client.refresh()` або `client.waitForAssistant()`. Хост-застосунок сам обробляє callback APNs або FCM від DobroDesk і вирішує, чи викликати `client.refresh()`, чи оновити власний UI. Для фонової доставки через власний застосунок використовуйте підписаний webhook `message.created`.
Це сигнал оновлення активного UI, а не безперервний realtime watcher або подія unread. Він не планує локальні сповіщення та не запитує дозвіл на сповіщення.
Callback усередині застосунку не отримає майбутню відповідь після його зупинки. Нехай бекенд доставляє сповіщення через APNs чи FCM. Не залишайте фоновий polling.
Мобільний SDK має додатковий push facade. Підʼєднайте платформний PushPort через `client.attachPush(...)` і передайте додатковий registration adapter, коли реєстрацією керує DobroDesk. Перед `requestPermissionAndRegister()` встановіть автентифікований контекст. Facade перевіряє область вхідного payload і передає лише відповідні події `payload`. Для події з перевіреною областю хост може викликати `client.refresh()` і використати отриманий `snapshot` для активного UI. Facade не додає Firebase, не планує локальні сповіщення та не запускає фонові повторні спроби. Нативним дозволом, хуками доступу до токена пристрою й відкриттям сповіщень керує застосунок. Доставка залежить від вибраного режиму Вимкнено, Застосунок або Керований.
Залишайте реєстрацію push поза базовим SDK
Реєструйте device token через автентифікований потік провайдера й прив'язуйте його до перевіреного акаунта або сесії DobroDesk. Оновлюйте токени, видаляйте їх під час logout і доручайте серверу відкидати недійсні токени провайдера. Обмежуйте payload сповіщення документованими ідентифікаторами. Не додавайте до push текст відповіді, повідомлення клієнта або облікові дані.
Базовий клієнт не імпортує Firebase і не створює реєстрацію APNs або FCM. Хост, якому push не потрібен, не має запитувати дозвіл на сповіщення або включати додатковий артефакт.
Явно керуйте дозволом на voice та очищенням
Встановіть опційну нативну voice-фабрику під час налаштування хоста. На iOS використовуйте `DobroDeskOptionalVoiceWidget.install(realtimeOrigin:)` після підключення `DobroDeskVoiceConversation`. На Android викликайте `installOptionalVoiceFactory(webSocketOrigin:permissionRequester:)`. Хост iOS додає `NSMicrophoneUsageDescription`. Хост Android оголошує `android.permission.RECORD_AUDIO` і надає запитувач дозволу, прив'язаний до Activity.
Віджет запитує дозвіл на мікрофон лише після вибору дії голосового ШІ або розмови з фахівцем. Підписана сесія визначає, які дії доступні. Дзвінки з фахівцем можуть бути доступними, навіть коли голосовий ШІ вимкнений. Якщо збережена політика запису вимагає вибору, отримайте згоду клієнта до початку дзвінка. Віджет завершує дзвінок, коли його приховано або застосунок переходить у фон. Фонових дзвінків немає.
Звільняйте підключену voice-фасаду під час logout або заміни обгортки. Відпишіться від подій розмови й ігноруйте запізнілі callback після close, reset або зміни акаунта. Якщо нативна можливість недоступна чи дозвіл відхилено, поясніть стан і залиште чат доступним.
Під'єднуйте voice лише після нативного налаштування
Після встановлення хостом опційної нативної фабрики викликайте `attachNativeConversationVoice()` у клієнті Flutter, React Native, NativeScript або Capacitor. Метод повертає нативну voice-фасаду розмови для прямих дзвінків із фахівцем і передачі від ШІ фахівцю. Власний або headless-хост може передати `DobroDeskVoiceConversationPort` через `attachConversationVoice(port)`. Залишайте `attachVoice(port)` для наявної voice-можливості лише для ШІ.
Фасада розмови надає `startHumanCall(options)`, `requestHumanHandoff(options)`, методи скасування й повтору, `endHumanCall()`, посторінкову історію дзвінків і завантаження транскриптів. Якщо збережена політика запису вимагає вибору, `DobroDeskHumanVoiceOptions.recordingConsent` має відповідати явному рішенню клієнта. Під час використання вбудованих voice-кнопок це рішення отримує нативний віджет.
const voice = await client.attachNativeConversationVoice();
const unsubscribe = voice.subscribeConversation(onConversationVoiceEvent);
// On logout or host teardown:
unsubscribe();
await voice.dispose();