SDK mobile
O SDK coloca o chat de atendimento da Atalia dentro do app da sua empresa, no Android e no iOS. O cliente conversa com o mesmo atendimento do site: atendentes, agentes de IA e fluxos, com botões, listas, carrossel, cobrança Pix, anexos, câmera, nota de voz e avaliação do atendimento.
O SDK é código aberto (licença MIT): github.com/Atalia-IA/atalia-mobile-sdk.
Como funciona
A tela do chat é o próprio webchat da Atalia, aberto num WebView. Por isso todo recurso novo do chat chega ao seu app sem você atualizar o SDK. A parte nativa do SDK cuida do que um WebView sozinho não faz:
| O SDK cuida de | Como |
|---|---|
| Sessão do cliente | Guarda no Keychain (iOS) ou cifrada pelo Android Keystore. O histórico continua lá quando o app fecha. |
| Usuário logado | Liga o cliente ao usuário do seu app, para ele ver o histórico em qualquer aparelho. |
| Arquivos | Abre câmera, galeria e microfone, e baixa documentos com o nome certo. |
| Links | Abre fora do app: navegador, discador, WhatsApp. |
| Não lidas | Conta as mensagens não lidas sem abrir o chat, para você mostrar no seu menu. |
| Notificações push | Registra o aparelho na Atalia e abre a conversa certa no toque. |
| Botão flutuante | Opcional, com a aparência do botão do site. |
Cores, nome do atendimento, horário e formulário inicial ficam no painel da Atalia, no canal de webchat. A mesma configuração vale para o site e para o app.
Requisitos e pacotes
| Plataforma | Requisito | Pacote |
|---|---|---|
| Android | Android 7.0 (API 24) ou mais novo | ai.atalia:chat:0.4.0, no Maven Central |
| iOS | iOS 15 ou mais novo | Swift Package Manager: https://github.com/Atalia-IA/atalia-mobile-sdk |
| React Native e Expo | Expo ou React Native com módulos do Expo, em development build (testado com Expo SDK 58). Ver a página | @atalia-ia/react-native-chat, no npm |
Esta documentação é da versão 0.4.0. Até a 1.0, a API ainda pode mudar entre versões: o CHANGELOG diz o que mudou em cada uma.
Antes de começar
Você vai precisar, no painel da Atalia:
- Do token do canal de webchat. Em Configurações › Canais, abra o canal de webchat em Editar canal: é o campo Token do widget, na aba Instalação. É o mesmo canal do site, se você já usa o webchat lá.
- Do segredo de identificação, se o app tem login. É ele que o seu backend usa para provar quem é o usuário. Veja Identificar o usuário logado.
- Da seção "App mobile e notificações push" do canal, para as notificações. Ela fica na aba Instalação de todo canal de webchat.
O token do canal pode ir no app: ele só abre o chat daquele canal, como no site, onde já aparece no código da página. Mas o botão de regenerar o token, no painel, troca o endereço do chat: o app publicado com o token antigo para de abrir o chat até sair uma versão nova. O que nunca vai no app é o segredo de identificação.
Próximos passos
- Começando: instalar, configurar e abrir o chat.
- React Native e Expo: o mesmo SDK pelo JavaScript.
- Identificar o usuário logado.
- Notificações push.
- Botão flutuante.
- Referência completa: Android, iOS e React Native.