Zum Hauptinhalt springen
Loslegen
DokumentationÜbersicht

Support direkt in Ihrem Produkt

Nutzen Sie dieselbe DobroDesk-Unterhaltung im Web und in nativen mobilen Apps. Beginnen Sie mit einer Plattform und behalten Sie die gemeinsame Widget-, Identitäts- und Erscheinungsbild-Konfiguration über alle Integrationen hinweg bei.

Integration auswählen

Web-Widget

v0.3.1

Das Browser-Widget für Websites und Webanwendungen.

Moderner Browser mit aktiviertem JavaScript

@dobrodesk/widgetWeb-Widget integrieren

iOS

v0.2.0

Native Swift-Oberfläche für UIKit- oder SwiftUI-Apps.

iOS 15.1 oder höher

iOS integrieren

Android

v0.2.0

Native Kotlin-Oberfläche für Views- oder Jetpack-Compose-Apps.

Android API 26 oder höher

Android integrieren

Flutter

v0.2.0

Eine typisierte Dart-Fassade über den nativen mobilen SDKs.

Flutter 3.22.3 und Dart 3.4 oder höher

dobrodesk_sdkFlutter integrieren

React Native

v0.2.0

Ein natives Modul und ein nativer Screen für React-Native-Apps.

React Native 0.76 bis unter 0.88

@dobrodesk/react-native-sdkReact Native integrieren

NativeScript

v0.2.0

Typisierte TypeScript-APIs auf Basis der nativen Plattform-SDKs.

NativeScript 8.9 bis unter 10

@dobrodesk/nativescript-sdkNativeScript integrieren

Capacitor

v0.2.0

Ein natives Plugin für Capacitor-Projekte auf iOS und Android.

Capacitor 6 bis unter 9

@dobrodesk/capacitor-sdkCapacitor integrieren

Schnellstart für das Mobile SDK

Native SDKs und Framework-Wrapper folgen demselben Integrationsablauf. Verwenden Sie für das Web-Widget die Anleitung zur Webplattform.

  1. Plattform auswählen

    Verwenden Sie das native SDK für eine Swift- oder Kotlin-App. Für Flutter, React Native, NativeScript oder Capacitor verwenden Sie den passenden Wrapper.

  2. Paket installieren

    Folgen Sie der Plattformanleitung und pinnen Sie die Paketversion 0.2.0. Expo-Projekte mit React Native benötigen einen Development Build; Expo Go wird für dieses native Modul nicht unterstützt.

  3. Widget und Identität verbinden

    Erstellen oder wählen Sie den DobroDesk-Widget-Kanal und seine Integrations-ID. Ihr Backend signiert das kurzlebige JWT. Das Signier-Geheimnis darf nie im App-Bundle liegen.

  4. Einmal initialisieren

    Erstellen Sie die SDK-Instanz beim App-Start, übergeben Sie gemeinsame Widget- und Erscheinungsbild-Einstellungen und behalten Sie die Instanz während der Sitzung.

  5. Unterhaltung anzeigen

    Öffnen Sie den nativen Unterhaltungsscreen über Ihre Support-Aktion. Das Verhalten folgt dem Web-Widget, während Navigation, Tastatur und Eingabefelder nativ bleiben.

  6. Die Kontositzung beenden

    Verwenden Sie logout für die Wrapper Flutter, React Native, NativeScript und Capacitor. Bei direkten Swift- oder Kotlin-Clients rufen Sie resetSession() auf, verwerfen Sie den Client und erstellen Sie vor der Änderung von accountScope einen neuen. Löschen Sie den Bildschirmzustand des vorherigen Benutzers.

Vorschau der nativen SDKs

Sehen Sie denselben Support-Ablauf mit nativen Steuerelementen für iOS und Android.

Nativer iOS-SDK-Chat von DobroDesk mit Supportnachricht, Eingabefeld und unterer Navigation
iOS SDK: Support-Konversation mit nativer Eingabe und Tab-Leiste.
Nativer Android-SDK-Chat von DobroDesk mit lokalisierten Nachrichten von Kunde und Assistent, Eingabefeld und unterer Navigation
Android SDK: lokalisierte Support-Konversation mit nativer Eingabe und unterer Navigation.

Gemeinsame Anleitungen

Identität und signierte Sitzungen

Erstellen Sie kurzlebige JWTs auf Ihrem Server und halten Sie Geheimnisse aus der App heraus.

Erscheinungsbild und Barrierefreiheit

Verwenden Sie gemeinsames Branding mit nativen Controls, reduzierter Bewegung und Systemeinstellungen.

Offline und Zustellung

Verstehen Sie Entwürfe, Nachrichtenwarteschlange, Wiederholungen und Zustellbestätigung.

Optionale Funktionen

Fügen Sie Push-Benachrichtigungen oder Sprache nur hinzu, wenn Ihre App sie benötigt.

FAQ zum Mobile SDK

Antworten zu Versionen, Sitzungen, Berechtigungen und Updates.

Unterstützte Versionen

Dies sind die Mindestversionen und Framework-Bereiche für Release 0.2.0. Prüfen Sie vor einem Update Ihrer App die Release Notes.

iOS
15.1 oder höher
Android
API 26 oder höher
Flutter
Flutter 3.22.3+, Dart 3.4+
React Native
0.76 bis unter 0.88
NativeScript
8.9 bis unter 10
Capacitor
6 bis unter 9
Web-Widget
Web widget 0.3.1

Häufige Fragen

Kann ich das SDK ohne Push-Benachrichtigungen oder Sprache verwenden?

Ja. Push und Sprache sind optionale Funktionen. Das grundlegende Unterhaltungs-SDK benötigt dafür keine Berechtigungen oder Provider-Konfiguration.

Wo erstelle ich das JWT?

Erstellen Sie es auf Ihrem Backend mit dem integrationsspezifischen Identitätsgeheimnis aus der Schaltfläche Copy identity secret des Widget-Kanals. Geben Sie der App ein kurzlebiges Token zurück. Dieses Geheimnis gehört nicht in iOS-, Android- oder JavaScript-Code.

Was passiert bei einer instabilen Verbindung?

Das SDK hält eine Nachricht im ausstehenden Zustand, bis es ein Zustellergebnis erhält. Es kann Arbeit offline in die Warteschlange stellen und einen Wiederholungsstatus liefern, ohne unbemerkt Duplikate zu senden.

Ist die mobile Oberfläche eine WebView des Web-Widgets?

Nein. Das Mobile SDK verwendet native iOS- und Android-Oberflächen. Erscheinungsbild und Gesprächsverhalten entsprechen dem Web-Widget, Navigation, Tastatur und Barrierefreiheit bleiben nativ.

Funktioniert es in Expo Go?

Nein. Die React-Native-Integration verwendet native Module. Expo-Projekte benötigen einen Development Build oder ein erzeugtes natives Projekt.

Technische Mobile-SDK-FAQ öffnen

Versionen und Pakete

Mobile SDK 0.2.0 wird über Plattform-Registries und das öffentliche Release-Bundle verteilt. Das Android-Release-Bundle verwendet ein lokales Maven-Repository. Die native Oberfläche wird von den iOS- und Android-SDKs bereitgestellt; Wrapper laden das Web-Widget nicht in einer WebView.