Pular para o conteúdo principal
Começar
DocumentaçãoVisão geral

Suporte dentro do seu produto

Use a mesma experiência de conversa do DobroDesk na web e em apps móveis nativos. Comece com uma plataforma e mantenha a configuração compartilhada da integração do widget, identidade e aparência em todas as integrações.

Escolha sua integração

Widget web

v0.3.1

O widget do navegador para sites e aplicações web.

Navegador moderno com JavaScript ativado

@dobrodesk/widgetIntegrar o widget web

iOS

v0.2.0

UI nativa em Swift para apps UIKit ou SwiftUI.

iOS 15.1 ou posterior

Integrar iOS

Android

v0.2.0

UI nativa em Kotlin para apps com Views ou Jetpack Compose.

Android API 26 ou posterior

Integrar Android

Flutter

v0.2.0

Uma fachada Dart tipada sobre os SDKs móveis nativos.

Flutter 3.22.3 e Dart 3.4 ou posteriores

dobrodesk_sdkIntegrar Flutter

React Native

v0.2.0

Um módulo e uma tela nativos para apps 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 apoiadas pelos SDKs nativos da plataforma.

NativeScript de 8.9 a menos de 10

@dobrodesk/nativescript-sdkIntegrar NativeScript

Capacitor

v0.2.0

Um plugin nativo para projetos Capacitor no iOS e Android.

Capacitor de 6 a menos de 9

@dobrodesk/capacitor-sdkIntegrar Capacitor

Início rápido do Mobile SDK

Os SDKs nativos e os wrappers de frameworks seguem o mesmo fluxo de integração. Para o widget web, use o guia da plataforma web.

  1. Escolha uma plataforma

    Use o SDK nativo para um app Swift ou Kotlin. Para Flutter, React Native, NativeScript ou Capacitor, use o wrapper correspondente.

  2. Instale o pacote

    Siga o guia da plataforma e fixe a versão 0.2.0. Projetos React Native com Expo precisam de um development build; o Expo Go não é compatível com este módulo nativo.

  3. Conecte o widget e a identidade

    Crie ou selecione o canal do widget do DobroDesk e seu ID de integração. O seu backend assina o JWT de curta duração. Nunca coloque o segredo de assinatura no bundle do app.

  4. Inicialize uma vez

    Crie a instância do SDK durante a configuração do app, forneça a configuração compartilhada da integração do widget e da aparência e mantenha a instância durante a sessão.

  5. Mostre a conversa

    Abra a tela nativa de conversa a partir da ação de suporte. O comportamento acompanha o widget web, enquanto navegação, teclado e campos de entrada continuam nativos.

  6. Encerre a sessão da conta

    Use logout com os wrappers Flutter, React Native, NativeScript e Capacitor. Com clientes Swift ou Kotlin diretos, chame resetSession(), descarte o cliente e crie um novo antes de alterar accountScope. Limpe o estado da tela do usuário anterior.

Prévia dos SDKs nativos

Veja o mesmo fluxo de suporte com controles nativos do iOS e do Android.

Tela de conversa do SDK nativo do iOS da DobroDesk com uma mensagem do cliente, campo de entrada e navegação inferior
Prévia nativa do iOS com textos personalizados em português, mensagem do cliente localizada, entrada nativa e barra de abas.
Tela de conversa do SDK nativo do Android da DobroDesk com uma mensagem do cliente localizada, campo de entrada e navegação inferior
Prévia nativa do Android com textos personalizados em português, mensagem do cliente localizada, entrada nativa e navegação inferior.

Guias comuns

Identidade e sessões assinadas

Crie JWTs de curta duração no seu servidor e mantenha os segredos fora do app.

Aparência e acessibilidade

Use a marca compartilhada com controles nativos, redução de movimento e configurações do sistema.

Offline e entrega

Entenda rascunhos, fila de mensagens, novas tentativas e confirmação de entrega.

Recursos opcionais

Adicione notificações push ou voz apenas quando o seu app precisar delas.

FAQ do SDK móvel

Respostas sobre versões, sessões, permissões e atualizações.

Versões compatíveis

Estas são as versões mínimas e os intervalos de frameworks para a versão 0.2.0. Consulte as notas da versão antes de atualizar o app.

iOS
15.1 ou posterior
Android
API 26 ou 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

Perguntas frequentes

Posso usar o SDK sem notificações push ou voz?

Sim. Push e voz são recursos opcionais. O SDK básico de conversas não precisa dessas permissões nativas nem da configuração de um provedor.

Onde devo criar o JWT?

Crie-o no seu backend usando o segredo de identidade específico da integração fornecido pelo controle Copy identity secret do canal Widget. Devolva ao app um token de curta duração. Não coloque esse segredo no código iOS, Android ou JavaScript.

O que acontece quando a conexão fica instável?

O SDK mantém a mensagem em estado pendente até receber o resultado da entrega. Ele pode colocar o trabalho em fila offline e expor o estado para uma nova tentativa sem enviar duplicatas silenciosamente.

A UI móvel é uma WebView do widget web?

Não. O Mobile SDK usa UI nativa de iOS e Android. Ele compartilha a aparência e o comportamento de conversa do widget web, mantendo navegação, teclado e acessibilidade nativos.

Funciona no Expo Go?

Não. A integração React Native usa módulos nativos. Projetos Expo precisam de um development build ou de um projeto nativo gerado.

Abrir o FAQ técnico do Mobile SDK

Versões e pacotes

O Mobile SDK 0.2.0 é distribuído pelos registros de pacotes das plataformas e pelo bundle público da versão. O bundle do Android usa um repositório Maven local. A UI nativa é implementada pelos SDKs de iOS e Android; os wrappers não carregam o widget web em uma WebView.