Widget de Chat
8 min de leituraAtualizado em 2026-01-19

Instalação do Widget

Como adicionar o widget ao seu site

O widget permite que seus visitantes iniciem conversas diretamente pelo site. A instalação é simples e pode ser feita em minutos.

Requisitos

  • Plano ativo com acesso ao Widget
  • Domínio do site configurado
  • Acesso ao HTML ou gerenciador de tags

Instalação via Google Tag Manager

Se você usa GTM, a instalação é ainda mais rápida. Basta adicionar o script como tag HTML personalizada.

Instalação passo a passo

1

Copie o script do widget

Configurações → Widget → Integração

Snippet do Widget v3.0.0
1<script>
2 window.WhatsAppWidgetQ = window.WhatsAppWidgetQ || [];
3 window.WhatsAppWidgetQ.push(["init", {
4 token: "wgt_xxx", // Token gerado no painel
5 baseUrl: "https://cloudwhats.app.br"
6 }]);
7
8 (function(d, t) {
9 var g = d.createElement(t);
10 var s = d.getElementsByTagName(t)[0];
11 g.src = "https://cloudwhats.app.br/widget.js";
12 g.async = true;
13 s.parentNode.insertBefore(g, s);
14 })(document, "script");
15</script>
2

Cole antes de </body>

No seu site ou CMS

Recomendamos inserir o script no final do HTML para não impactar o carregamento da página.

3

Teste em modo anônimo

Evite cache

Abra o site em janela anônima e valide se o widget aparece.

Personalização

No painel em Configurações → Widget → Aparência, você pode personalizar:

  • Posição — inferior-direito ou inferior-esquerdo
  • Cores — primária, secundária, cabeçalho, fundo, texto, bolhas
  • Tipografia — System, Inter, Roboto, Open Sans, Poppins, Nunito
  • Bordas — arredondamento de 0px a 24px
  • Animações — abertura/fechamento com transições suaves (automático)

Também é possível sobrescrever via JavaScript. Consulte a documentação do SDK para mais detalhes.

Combine cores do widget com a identidade visual da sua marca para aumentar a conversão.

Solução de problemas

Widget não aparece?

  • Verifique se o domínio está autorizado
  • Confirme se o script foi colado apenas uma vez
  • Limpe o cache do navegador

Este artigo foi útil?