Pular para o conteúdo

Conectar Web Widget

O Web Widget é um chat embutido no seu site que conversa diretamente com a equipe pelo app.smart. É o canal mais simples de instalar — não exige aprovação de terceiros, credenciais técnicas externas ou processos de homologação. Em menos de 10 minutos, o widget pode estar capturando conversas em produção.

CenárioRecomendado?
Site institucional com visitantes ativos✅
E-commerce que quer atendimento em tempo real✅
Landing page de campanha (com chat focado em conversão)✅
Sistema interno (intranet, painel de cliente)✅
Site só estático sem visitantes recorrentes❌ Use canais sociais
  • Acesso ao código do seu site (HTML, ou plugin de CMS como WordPress, Wix, Squarespace)
  • Conhecimento básico para colar uma tag <script> antes do fechamento de </body>

  1. No painel do app.smart, acesse Config. → Caixas de Entrada → Adicionar Caixa de Entrada.
  2. Selecione Website.
  3. Preencha:
    • Nome do site (ex: “Site Principal”)
    • URL do site (ex: https://suaempresa.com.br)
    • Mensagem de boas-vindas (texto exibido quando o visitante abre o widget pela primeira vez)
    • Cor do widget (escolha que combine com sua marca)
  4. Clique em Criar caixa de entrada.

Após criar o inbox, o app.smart gera um snippet único:

<script>
(function(d,t) {
var BASE_URL="https://app.smart2.com.br";
var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
g.src=BASE_URL+"/packs/js/sdk.js";
g.defer = true;
g.async = true;
s.parentNode.insertBefore(g,s);
g.onload=function(){
window.chatwootSDK.run({
websiteToken: 'SEU_TOKEN_AQUI',
baseUrl: BASE_URL
})
}
})(document,"script");
</script>

Cole esse snippet antes do fechamento da tag </body> em todas as páginas onde o widget deve aparecer.

  1. Plugin Insert Headers and Footers (gratuito) → cole o snippet no campo “Footer”.
  2. Salve. O widget aparece automaticamente em todas as páginas.
  1. Procure por Custom Code ou Code Injection nas configurações do site.
  2. Adicione no rodapé global.
  3. Publique o site.
  1. Acesse Loja online → Temas → Ações → Editar código.
  2. Abra theme.liquid.
  3. Cole o snippet antes de </body>.
  4. Salve.
  1. Abra o site em uma aba anônima.
  2. Aguarde o widget aparecer (canto inferior direito por padrão).
  3. Clique no ícone para abrir o chat.
  4. Envie uma mensagem de teste.
  5. Verifique se a conversa aparece em Conversas no app.smart.

Após instalado, ajustes visuais ficam em Config. → Caixas de Entrada → seu inbox → aba Configurações.

OpçãoEfeito
Cor primáriaDefine cor do botão, header do chat e mensagens enviadas pelo agente
PosiçãoCanto inferior direito (padrão), inferior esquerdo, ou customizado via CSS
Avatar do widgetLogo ou ícone exibido no botão flutuante
Modo de exibição”Padrão” (botão flutuante), “Em tempo integral” (sempre aberto), “Bubble” (notificação inicial)
Cabeçalho do widgetTexto exibido no topo do chat aberto
Mensagem fora do horárioTexto exibido fora do horário comercial do inbox

Conectar Web Widget: a aba Formulário Chat Pré com os campos escolhidos

Para identificar o visitante antes da conversa começar:

  1. Aba Formulário Chat Pré da caixa — é assim que ela se chama hoje.
  2. Habilite Mostrar formulário pré-chat.
  3. Defina os campos obrigatórios:
    • Nome (recomendado)
    • Email (recomendado para email continuity)
    • Telefone (opcional)
    • Campos customizados (atributos personalizados do contato)
  4. Salve.

Quem preenche o pré-chat entrou por um formulário, então o app registra uma conversão em Marketing › Captação › Conversões — do mesmo jeito que um formulário nativo ou uma landing page.

  • Uma por conversa, no momento em que ela nasce. Reabrir uma conversa antiga não registra de novo.
  • Identificador: chat-site-<número da caixa>, por exemplo chat-site-42. É fixo — renomear a caixa não parte o evento em dois. Na primeira conversão o app já cria o apelido legível (“Chat do site — Nome da caixa”), que é o que aparece na tela de Conversões, nos relatórios e nos segmentos; você pode editá-lo quando quiser.
  • Campos: tudo o que a pessoa preencheu — nome, e-mail, telefone e os campos personalizados. É isso que a aba Mapeamento lê para promover um campo a dado do contato.
  • Origem: a mesma já registrada pelo widget (UTMs, identificadores de clique, página de entrada). Não conta duas vezes.
  • Meta: não vai, porque a caixa de chat não tem pixel associado. Se um dia precisar, é pela regra normal do identificador na tela de Conversões.

Quem abre o chat sem pré-chat — só digitando uma mensagem — não gera conversão: não houve formulário.

Conectar Web Widget: a seção de Validação de Identidade do Usuário, na aba Configurações

Se o widget está em uma área autenticada (cliente já logado), você pode identificar o usuário automaticamente:

window.$chatwoot.setUser('USER_ID_NO_SEU_SISTEMA', {
name: 'Maria Silva',
phone_number: '+5511999990000',
company_name: 'Empresa Cliente',
custom_attributes: {
plano: 'premium',
cliente_desde: '2024-01-15'
}
});

Com isso, as conversas iniciadas pelo widget ficam ligadas ao contato certo — sem duplicar cadastro e sem pedir os dados de novo.

Conectar Web Widget: o widget aberto na tela de um celular

O widget se adapta automaticamente a telas pequenas:

  • Em desktop: chat flutuante no canto
  • Em mobile: chat ocupa a tela inteira ao abrir

Sem configuração adicional. Para esconder em mobile:

if (window.innerWidth < 768) {
window.$chatwoot.toggleBubbleVisibility('hide');
}

Conectar Web Widget: o widget no site com um evento personalizado disparado

Você pode disparar eventos do seu site para o app.smart:

window.$chatwoot.setCustomAttributes({
ultimo_pedido: '12345',
valor_carrinho: 'R$ 350,00'
});
window.$chatwoot.setLabel('cliente-recorrente');

Atributo e etiqueta aparecem no painel da conversa — o agente já abre sabendo com quem fala.

Existem também deleteCustomAttribute, removeLabel, setLocale para trocar o idioma do widget, e reset para encerrar a sessão do visitante (no logout do seu site, por exemplo).

  • Sem JavaScript, sem widget. Raro, mas existe
  • Bloqueador agressivo pode derrubar o script. Vale testar com as extensões que o seu público usa
  • O visitante é anônimo até se identificar. Sem setUser e sem formulário de pré-chat, cada conversa nasce sem nome

Posso ter widgets diferentes em sites diferentes? Sim, cada site é um inbox separado. Útil para diferenciar atendimento por marca, idioma ou departamento.

O widget funciona em iframe (página dentro de outra)? Sim. O widget detecta o contexto e funciona normalmente. Para subdomínios, pode precisar de configuração de CORS — fale com o suporte.

Como saber em qual página o visitante estava ao iniciar a conversa? A URL aparece automaticamente nos atributos da conversa, na sidebar direita. Útil para entender contexto sem perguntar.

O widget mantém o histórico se o visitante voltar ao site? Sim, enquanto o visitante usar o mesmo navegador. O app.smart guarda um cookie/localStorage com o ID do contato. Em outro dispositivo ou navegador anônimo, conta como visitante novo.

Como remover o widget temporariamente sem desinstalar? Não existe interruptor para isso. O jeito é tirar o trecho de código do site — ou, se você usa gerenciador de tags, pausar a tag. Apagar a caixa de entrada também some com o widget, mas leva junto o histórico das conversas, então não serve para pausa temporária.

Posso integrar com Google Analytics ou Meta Pixel? Sim. Use os eventos do widget para disparar eventos customizados:

window.addEventListener('app.smart:on-message', () => {
gtag('event', 'chat_started', { event_category: 'engagement' });
});