Ir al contenido principal
Empezar
DocumentaciónDescripción general

Soporte dentro de tu producto

Usa la misma experiencia de conversación de DobroDesk en la web y en aplicaciones móviles nativas. Empieza con una plataforma y conserva la configuración compartida de integración del widget, identidad y apariencia en todas las integraciones.

Elige tu integración

Widget web

v0.3.1

El widget del navegador para sitios y aplicaciones web.

Navegador moderno con JavaScript activado

@dobrodesk/widgetIntegrar el widget web

iOS

v0.2.0

UI nativa en Swift para aplicaciones UIKit o SwiftUI.

iOS 15.1 o posterior

Integrar iOS

Android

v0.2.0

UI nativa en Kotlin para aplicaciones con Views o Jetpack Compose.

Android API 26 o posterior

Integrar Android

Flutter

v0.2.0

Una fachada Dart tipada sobre los SDK móviles nativos.

Flutter 3.22.3 y Dart 3.4 o posteriores

dobrodesk_sdkIntegrar Flutter

React Native

v0.2.0

Un módulo y una pantalla nativos para aplicaciones React Native.

React Native de 0.76 a menos de 0.88

@dobrodesk/react-native-sdkIntegrar React Native

NativeScript

v0.2.0

APIs TypeScript tipadas respaldadas por los SDK nativos de la plataforma.

NativeScript de 8.9 a menos de 10

@dobrodesk/nativescript-sdkIntegrar NativeScript

Capacitor

v0.2.0

Un plugin nativo para proyectos Capacitor de iOS y Android.

Capacitor de 6 a menos de 9

@dobrodesk/capacitor-sdkIntegrar Capacitor

Inicio rápido del Mobile SDK

Los SDK nativos y los wrappers de frameworks siguen el mismo flujo de integración. Para el widget web, usa la guía de la plataforma web.

  1. Elige una plataforma

    Usa el SDK nativo para una aplicación Swift o Kotlin. Si usas Flutter, React Native, NativeScript o Capacitor, usa el wrapper correspondiente.

  2. Instala el paquete

    Sigue la guía de tu plataforma y fija la versión 0.2.0. Los proyectos React Native con Expo necesitan un development build; Expo Go no es compatible con este módulo nativo.

  3. Conecta el widget y la identidad

    Crea o selecciona el canal del widget de DobroDesk y su ID de integración. Tu backend firma el JWT de corta duración. No incluyas el secreto de firma en el bundle de la aplicación.

  4. Inicializa una vez

    Crea la instancia del SDK durante la configuración de la aplicación, proporciona la configuración compartida de la integración del widget y la apariencia y conserva la instancia durante la sesión.

  5. Muestra la conversación

    Abre la pantalla nativa de conversación desde tu acción de soporte. El comportamiento sigue al widget web, mientras que la navegación, el teclado y los campos siguen siendo nativos.

  6. Finaliza la sesión de la cuenta

    Usa logout con los wrappers de Flutter, React Native, NativeScript y Capacitor. Con clientes Swift o Kotlin directos, llama a resetSession(), descarta el cliente y crea uno nuevo antes de cambiar accountScope. Limpia el estado de pantalla del usuario anterior.

Vista previa de los SDK nativos

Consulta el mismo flujo de soporte con controles nativos de iOS y Android.

Pantalla de chat del SDK nativo de iOS de DobroDesk con un mensaje de soporte, compositor y navegación inferior
SDK de iOS: conversación de soporte con compositor nativo y barra de pestañas.
Pantalla de chat del SDK nativo de Android de DobroDesk con mensajes localizados del cliente y del asistente, compositor y navegación inferior
SDK de Android: conversación de soporte localizada con compositor nativo y navegación inferior.

Guías comunes

Identidad y sesiones firmadas

Crea JWT de corta duración en tu servidor y mantén los secretos fuera de la aplicación.

Apariencia y accesibilidad

Usa una marca compartida con controles nativos, movimiento reducido y ajustes del sistema.

Sin conexión y entrega

Conoce los borradores, la cola de mensajes, los reintentos y la confirmación de entrega.

Funciones opcionales

Añade notificaciones push o voz solo cuando tu aplicación las necesite.

Preguntas frecuentes del SDK móvil

Respuestas sobre versiones, sesiones, permisos y actualizaciones.

Versiones compatibles

Estos son los mínimos y rangos de frameworks compatibles con la versión 0.2.0. Revisa las notas de la versión antes de actualizar tu aplicación.

iOS
15.1 o posterior
Android
API 26 o posterior
Flutter
Flutter 3.22.3+, Dart 3.4+
React Native
0.76 a menos de 0.88
NativeScript
8.9 a menos de 10
Capacitor
6 a menos de 9
Widget web
Web widget 0.3.1

Preguntas frecuentes

¿Puedo usar el SDK sin notificaciones push ni voz?

Sí. Push y voz son funciones opcionales. El SDK de conversaciones básico no necesita sus permisos nativos ni la configuración de un proveedor.

¿Dónde debo crear el JWT?

Créalo en tu backend con el secreto de identidad específico de la integración que devuelve el control Copy identity secret del canal Widget. Devuelve a la aplicación un token de corta duración. No pongas ese secreto en el código de iOS, Android ni JavaScript.

¿Qué ocurre cuando la conexión es inestable?

El SDK mantiene el mensaje en estado pendiente hasta recibir un resultado de entrega. Puede poner el trabajo en cola sin conexión y exponer el estado para reintentarlo sin enviar duplicados silenciosamente.

¿La UI móvil es un WebView del widget web?

No. El Mobile SDK usa UI nativa de iOS y Android. Comparte la apariencia y el comportamiento de conversación con el widget web, mientras que la navegación, el teclado y la accesibilidad siguen siendo nativos.

¿Funciona en Expo Go?

No. La integración de React Native usa módulos nativos. Los proyectos Expo necesitan un development build o un proyecto nativo generado.

Abrir las preguntas técnicas del Mobile SDK

Versiones y paquetes

Mobile SDK 0.2.0 se distribuye mediante los registros de paquetes de cada plataforma y el bundle público de la versión. El bundle de Android utiliza un repositorio Maven local. La UI nativa la proporcionan los SDK de iOS y Android; los wrappers no cargan el widget web en un WebView.