Instalação do Widget

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

Copie o script do widget

Configurações → Widget & SDK

Na página Configurações → Widget & SDK, copie o snippet exibido na seção de integração. Não existe uma rota separada chamada “Integração”; tudo é configurado na mesma tela do widget.

Snippet do Widget

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>

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.

Teste em modo anônimo

Evite cache

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

Personalização

Na mesma página Configurações → Widget & SDK, você encontra as seções de aparência e integração. A personalização visual do widget é feita ali mesmo, sem navegar para uma rota separada.

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