Crie uma integração

SDKs de chat para dispositivos móveis

Adicione o chat de suporte do Sonny ao seu app iOS, Android ou React Native voltado para clientes. Os clientes falam com a sua equipe de dentro do app, usando a caixa de entrada do Sonny que você já tem.

Procurando o app que sua equipe de suporte usa para responder? Instale o app do Sonny para agentes.

Escolha seu SDK

Conecte seu app

  1. Em um ambiente Sonny com suporte a dispositivos móveis, abra Canais → Chat ao vivo → Apps móveis. Um proprietário ou administrador cria uma chave de app para cada plataforma e bundle ID ou application ID.
  2. Instale o SDK seguindo o README do repositório. Configure-o com o ID do seu site e a chave pública de app daquele build. O React Native precisa de chaves de app separadas para iOS e Android.
  3. Mostre o chat como uma conversa em tela cheia ou incorpore-o ao seu app. Mantenha apenas uma tela de chat ativa por vez.
  4. Para clientes logados, crie um JWT de identidade no seu servidor e passe-o para o SDK. Chame reset() no logout para iniciar uma nova sessão de visitante.

As chaves de app são identificadores públicos. Os segredos de assinatura de identidade e as chaves dos provedores de notificação ficam no seu servidor ou nas configurações protegidas do Sonny.

Notificações push

Seu app cuida da permissão de notificações e da obtenção do token. O SDK aceita um token APNs no iOS ou um token FCM no Android e trata os toques nas notificações do Sonny. A entrega exige credenciais do seu próprio app: uma chave de assinatura APNs e os IDs de equipe/chave da Apple, ou uma conta de serviço FCM do seu projeto Firebase. As credenciais do app do Sonny para agentes pertencem a outro app. A entrega de push continua em validação durante esta prévia.

  1. Envie as credenciais do provedor do seu app em Apps móveis. Para APNs, use o ambiente sandbox ou de produção correspondente ao seu build.
  2. Abra o app, permita as notificações e passe o token para o SDK. Atualize a lista de dispositivos nas configurações e selecione seu dispositivo de teste pelo horário de registro.
  3. Coloque o app em segundo plano e selecione Enviar push de teste. Confira se o dispositivo recebeu. O status nas configurações mostra se o provedor aceitou ou um código de erro seguro; a aceitação por si só não confirma a chegada.
  4. Para testar conversas, envie uma resposta de um agente ou da IA enquanto o visitante está desconectado. Uma notificação de resposta abre a conversa quando o seu app repassa o toque para handlePush. A notificação de teste genérica não abre nenhuma conversa.

Relate um problema ou contribua

Abra uma issue no repositório do SDK que você usa. Inclua a versão ou o commit, as versões do seu sistema operacional e framework e uma pequena reprodução. Cada repositório aceita pull requests e traz orientações para contribuição e para relatar problemas de segurança. Não coloque dados de clientes, JWTs de identidade, tokens de dispositivo nem chaves privadas em issues públicas.

Documentos relacionados