Principal Conexões com canais externos (caixas de entrada) Como integrar o Web Widget do Cloud Chat em aplicativos mobile

Como integrar o Web Widget do Cloud Chat em aplicativos mobile

Última atualização em May 21, 2026

Quando usar

  • Você quer adicionar o Cloud Chat dentro de um app mobile (Flutter, React Native, iOS, Android)
  • Você não tem SDK nativo disponível ainda e quer uma solução funcional já
  • Você quer reaproveitar o Web Widget já configurado no painel do Cloud Chat

Pré-requisitos

Sobre este artigo

Atualmente, o Cloud Chat pode ser integrado em apps mobile por meio do Web Widget usando o componente WebView de cada plataforma.

Como funciona

O Web Widget do Cloud Chat é distribuído como um script JavaScript, gerado automaticamente durante a configuração de uma caixa de entrada do tipo Web Widget no painel.

Esse script pode ser incorporado em uma WebView dentro do app mobile (Flutter, React Native, Android nativo, iOS nativo). Permite que o chat seja renderizado dentro do app, com experiência próxima à do Web Widget original.

Exemplo: em React Native, embute o widget num <WebView> apontando para a URL onde o script foi inserido — garantindo a comunicação completa com o Cloud Chat.

SDKs nativos

Ainda não disponibilizamos SDKs nativos oficiais para Flutter, React Native, Android ou iOS.

Temos planos de lançar SDKs no futuro, mas sem data definida.

Enquanto isso, o uso via WebView é a única forma recomendada e suportada oficialmente.

Vantagens e limitações

Aspecto WebView
Compatibilidade Funciona em qualquer app com suporte a WebView
Esforço de implementação Baixo — basta incluir o script gerado pelo Cloud Chat
Experiência de uso Similar ao Web Widget
Limitação Menor flexibilidade de personalização e performance que um SDK nativo

Passo a passo

Etapa 1 — Criar inbox Web Widget no Cloud Chat

Crie uma nova caixa de entrada do tipo Web Widget no painel do Cloud Chat.

Etapa 2 — Copiar o script

Copie o script gerado na etapa de configuração da inbox.

Etapa 3 — Hospedar uma página HTML simples

Insira o script em uma página HTML simples hospedada pelo seu app (ou em servidor próprio).

Etapa 4 — Carregar dentro da WebView

Aponte a WebView do seu app para essa página HTML.

Etapa 5 — Testar

Valide a comunicação e a aparência do widget dentro do aplicativo.

Roadmap

Estamos avaliando o desenvolvimento de SDKs nativos para Flutter e React Native, com recursos avançados como notificações push e controle de sessão nativo. No momento, sem data definida para lançamento.

Observações