DocumentationVue d'ensemble
Aucun résultat correspondant
L'assistance dans votre produit
Utilisez la même expérience de conversation DobroDesk sur le web et dans les applications mobiles natives. Commencez avec une plateforme et conservez la configuration partagée de l'intégration du widget, de l'identité et de l'apparence dans toutes les intégrations.
Choisissez votre intégration
Widget web
v0.3.1Le widget navigateur pour les sites et applications web.
Navigateur moderne avec JavaScript activé
@dobrodesk/widgetIntégrer le widget webiOS
v0.2.0Interface Swift native pour les applications UIKit ou SwiftUI.
iOS 15.1 ou version ultérieure
Intégrer iOSAndroid
v0.2.0Interface Kotlin native pour les applications Views ou Jetpack Compose.
Android API 26 ou version ultérieure
Intégrer AndroidFlutter
v0.2.0Une façade Dart typée au-dessus des SDK mobiles natifs.
Flutter 3.22.3 et Dart 3.4 ou versions ultérieures
dobrodesk_sdkIntégrer FlutterReact Native
v0.2.0Un module et un écran natifs pour les applications React Native.
React Native 0.76 à moins de 0.88
@dobrodesk/react-native-sdkIntégrer React NativeNativeScript
v0.2.0Des API TypeScript typées basées sur les SDK natifs de la plateforme.
NativeScript 8.9 à moins de 10
@dobrodesk/nativescript-sdkIntégrer NativeScriptCapacitor
v0.2.0Un plugin natif pour les projets Capacitor iOS et Android.
Capacitor 6 à moins de 9
@dobrodesk/capacitor-sdkIntégrer CapacitorDémarrage rapide du Mobile SDK
Les SDK natifs et les wrappers de frameworks suivent le même parcours d'intégration. Pour le widget web, consultez le guide de la plateforme web.
Choisissez une plateforme
Utilisez le SDK natif pour une application Swift ou Kotlin. Pour Flutter, React Native, NativeScript ou Capacitor, utilisez le wrapper correspondant.
Installez le package
Suivez le guide de votre plateforme et verrouillez la version 0.2.0. Les projets React Native avec Expo ont besoin d'un development build; Expo Go ne prend pas en charge ce module natif.
Connectez le widget et l'identité
Créez ou sélectionnez le canal du widget DobroDesk et son ID d'intégration. Votre backend signe le JWT de courte durée. Ne mettez jamais le secret de signature dans le bundle de l'application.
Initialisez une seule fois
Créez l'instance du SDK au démarrage de l'application, fournissez la configuration partagée de l'intégration du widget et de l'apparence et conservez l'instance pendant la session.
Présentez la conversation
Ouvrez l'écran de conversation natif depuis votre action d'assistance. Le comportement suit le widget web, tandis que la navigation, le clavier et les champs restent natifs.
Terminer la session du compte
Utilisez logout avec les wrappers Flutter, React Native, NativeScript et Capacitor. Avec les clients Swift ou Kotlin directs, appelez resetSession(), détruisez le client et créez-en un nouveau avant de changer accountScope. Effacez l'état d'écran de l'utilisateur précédent.
Aperçu des SDK natifs
Visualisez le même parcours d'assistance avec les contrôles natifs d'iOS et d'Android.
Guides communs
Identité et sessions signées
Créez des JWT de courte durée sur votre serveur et gardez les secrets hors de l'application.
Apparence et accessibilité
Utilisez une marque partagée avec des contrôles natifs, la réduction des mouvements et les réglages système.
Hors ligne et livraison
Découvrez les brouillons, la file de messages, les nouvelles tentatives et la confirmation de livraison.
Fonctionnalités optionnelles
Ajoutez les notifications push ou la voix uniquement si votre application en a besoin.
FAQ du SDK mobile
Réponses sur les versions, les sessions, les autorisations et les mises à jour.
Versions prises en charge
Voici les versions minimales et les plages de frameworks pour la version 0.2.0. Consultez les notes de version avant de mettre votre application à jour.
- iOS
- 15.1 ou version ultérieure
- Android
- API 26 ou version ultérieure
- Flutter
- Flutter 3.22.3+, Dart 3.4+
- React Native
- 0.76 à moins de 0.88
- NativeScript
- 8.9 à moins de 10
- Capacitor
- 6 à moins de 9
- Widget web
- Web widget 0.3.1
Questions fréquentes
Puis-je utiliser le SDK sans notifications push ni voix?
Oui. Les notifications push et la voix sont optionnelles. Le SDK de conversation de base ne nécessite ni leurs autorisations natives ni la configuration d'un fournisseur.
Où dois-je créer le JWT?
Créez-le sur votre backend avec le secret d'identité spécifique à l'intégration fourni par le contrôle Copy identity secret du canal Widget. Renvoyez à l'application un token de courte durée. Ne mettez pas ce secret dans le code iOS, Android ou JavaScript.
Que se passe-t-il lorsque le réseau est instable?
Le SDK garde le message en attente jusqu'à recevoir un résultat de livraison. Il peut mettre le travail en file hors ligne et exposer l'état nécessaire pour réessayer sans envoyer silencieusement un doublon.
L'interface mobile est-elle une WebView du widget web?
Non. Le Mobile SDK utilise une interface native iOS et Android. Il partage l'apparence et le comportement de conversation du widget web, tout en conservant une navigation, un clavier et une accessibilité natifs.
Est-ce compatible avec Expo Go?
Non. L'intégration React Native utilise des modules natifs. Les projets Expo ont besoin d'un development build ou d'un projet natif généré.
Versions et packages
Mobile SDK 0.2.0 est distribué via les registres de packages des plateformes et le bundle public de la version. Le bundle Android utilise un dépôt Maven local. L'interface native est fournie par les SDK iOS et Android; les wrappers ne chargent pas le widget web dans une WebView.