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:
| SDK | Stack | Mínimo |
|---|---|---|
| Android | Kotlin, Jetpack Compose | minSdk 24, Kotlin 2.x |
| iOS | Swift, SwiftUI (zero dependências) | iOS 15+, Swift 5.9+ |
| Flutter | Dart puro, sem pontes nativas | Dart 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.
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
storageDirectoryque 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.
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.