Instale o widget de chat do Codewo no seu site em 2 linhas de código. Inclui captura automática de UTMs/gclid pra atribuição e customização visual (cor, posição, título).
Como funciona
O WebChat é um widget JavaScript que você cola no <body> do seu site. Pra cada visitante que abre o chat, o Codewo cria uma conversa nova no Inbox. UTMs, gclid, fbclid e referrer da URL são capturados automaticamente — você não precisa configurar nada pra isso funcionar.
Passo a passo
Em Configurações → Canais → Novo canal → WebChat:
Etapa 1 — Detalhes
- Nome do canal (interno, ex: "Chat do site").
- Status (ativo/inativo). Você pode criar o canal e deixar inativo até estar pronto pra colar o widget.
- (Opcional) Domínios permitidos — Lista de domínios onde o widget pode rodar. Vazio = qualquer site. Recomendado preencher.
Etapa 2 — Captura de dados
Habilite ou não a captura de campos antes do cliente começar a conversar (ex: pedir email, telefone, CPF). Útil pra qualificar lead. Vazio = cliente entra direto na conversa.
Etapa 3 — Aparência
- Cor tema (hex, ex:
#4F46E5) — Cor do botão e cabeçalho. - Posição — Esquerda, direita ou centralizado embaixo.
- Título do widget — Texto no topo do chat (ex: "Atendimento Codewo").
- Placeholder — Texto cinza no campo de mensagem ("Digite sua mensagem...").
Etapa 4 — Equipe
Escolha qual equipe recebe as conversas.
Etapa 5 — Instalação
Depois de salvar, o Codewo abre um diálogo com 2 linhas de código pra colar no <body> do seu site, idealmente antes do </body> de fechamento:
<script>window.CODEWO_SECRET='...'</script>
<script src="https://seu-dominio.com.br/widget/widget.js"></script>
Cole, publique o site, abra em outra aba — o widget aparece.
O que é capturado automaticamente
Toda vez que um visitante abre o chat, o Codewo captura:
- UTMs —
utm_source,utm_medium,utm_campaign,utm_term,utm_content - IDs de anúncio —
gclid(Google),fbclid(Facebook/Instagram),srsltid(Google Shopping) - Referrer — De qual site o visitante veio (Google, link direto, etc.)
- URL completa da página onde abriu o chat
Esses dados viram touchpoints do contato pra relatórios de atribuição. Veja Atribuição multi-touch.
Pegadinhas comuns
- Widget não aparece após colar. Verifique se o domínio do site está na lista de "Domínios permitidos" do canal. Se você marcou só
meusite.com.bre abriu emwww.meusite.com.br, são domínios diferentes — adicione os dois ou deixe a lista vazia. - Cache de CDN/navegador. Depois de mudar cor ou título, pode precisar limpar cache do navegador (Ctrl+F5) ou esperar CDN propagar.
- HTTPS é obrigatório. Widget só roda em sites com HTTPS. Em HTTP, o navegador bloqueia o script.
- Captura de email/CPF sem validação de unicidade. Se o cliente preencher o formulário 2x com o mesmo email, podem ser criados 2 contatos separados. Combinar com workflow de "merge" se isso for problema.
- Trocar o "widget token" invalida instalações antigas. Se você regenerar o token (em Configurações → Canal → Avançado), todos os sites com o snippet antigo param de funcionar. Atualize o snippet em todos os lugares antes.
- Visitante anônimo até preencher dados. Antes de o cliente digitar nome/email, ele é só "Visitante #X". Histórico da sessão fica no Codewo, mas vincular a contato real depende de captura ou identificação posterior.
Boas práticas
- Configure domínios permitidos — Sem isso, qualquer site pode tecnicamente usar seu widget (sem ganhar acesso ao Inbox, mas consumindo seu canal).
- Cor da marca, não cor aleatória — Widget cinza ou desalinhado com o site parece spam.
- Combine com chatbot/agente IA — WebChat é canal perfeito pra IA responder primeiro e escalar pra humano só quando precisar.
- Coloque em landing pages — UTMs ricos capturados no chat = relatório de conversão limpo.
- Não esconda o widget no rodapé inalcançável — Se ninguém vê o botão, ninguém abre o chat.