Documentação

Mobile SDK

Disponibilize o mesmo chat de suporte com IA e atendentes humanos que já roda na web dentro dos seus apps nativos Android, iOS e Flutter. Um único contrato de backend, um comportamento, três plataformas.

Plataformas#

Três SDKs nativos compartilham uma superfície de API pública idêntica. Escolha o que corresponde ao seu app:

SDKStackMínimo
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (zero dependências)iOS 15+, Swift 5.9+
FlutterDart puro, sem pontes nativasDart 3.4+, Flutter 3.16+

Cada SDK renderiza um chat nativo real como um bottom sheet sobre o seu app — e não uma WebView. O seu app desenha o ponto de entrada (um botão, um ícone, um badge) e abre o chat com Respondo.open().

O que está incluído#

Os SDKs móveis reproduzem o conjunto de funcionalidades do widget web:

  • Núcleo do chat: agente de IA, transferência ao vivo para atendentes humanos, estado de escrita e de leitura, anexos de arquivos.
  • Feed de novidades ("O que há de novo") e checklists de onboarding.
  • Pesquisas (NPS, CSAT e mais).
  • Banners no nível da página e teasers proativos associados à tela atual. Informe a tela atual com Respondo.setCurrentScreen("screen_name") na navegação — os teasers proativos e a segmentação no nível da página correspondem a ela.
  • Notificações push para respostas de atendentes e campanhas, com deep links para a conversa certa.
Os tours de produto e os tooltips são superfícies exclusivas da web e não são transpostos para os SDKs móveis.

Como funciona#

Cada SDK é um cliente leve para o mesmo contrato público de widget que o widget web — o backend é reutilizado sem alterações. As mensagens trafegam por REST mais um WebSocket, e a entrega degrada de forma graciosa (WebSocket, depois SSE, depois polling REST) e volta a subir assim que a conexão se restabelece.

A autorização é feita por camadas:

  • visitor_id — um id anônimo estável que o SDK gera e salva com segurança no dispositivo: preferências cifradas pelo Keystore no Android, o keychain no iOS, e no Flutter um arquivo privado do app no storageDirectory que você passa ao init.
  • userHash — uma assinatura HMAC do seu backend que associa uma conversa a uma pessoa real (verificação de identidade).
  • session-token — emitido por conversa e reenviado nas chamadas REST e WebSocket.

Começar#

Vá à página da plataforma que corresponde ao seu app — Android SDK, iOS SDK ou Flutter SDK — para a instalação e uma init funcional. Depois configure a Verificação de identidade para reconhecer usuários autenticados em vários dispositivos, e as Notificações push para entrega offline.

Cada SDK é instalado a partir do repositório da sua plataforma: Android a partir do Maven Central (ai.respondo:respondo-sdk), iOS via Swift Package Manager a partir de github.com/respondo-app/sdk-ios, e Flutter a partir do pub.dev (respondo_sdk). O código-fonte de Android e iOS é público no GitHub.