Neste artigo

WebChat: chat ao vivo no seu site

Crie o canal WebChat, escolha o formulário e a aparência, cole o código no site e atenda os visitantes pela Caixa de Entrada, com a origem de cada um registrada.

Atualizado em 08 de outubro de 2026

O WebChat é o chat ao vivo do Codewo para o seu site: uma janela no canto da página onde o visitante conversa com a sua equipe sem sair dali. Cada conversa chega na Caixa de Entrada como as dos outros canais, e a origem do visitante (campanha, anúncio, site de onde veio) fica registrada no contato.

Como funciona

Você cria o canal WebChat, copia um código e cola no site. O código mostra o balão do chat. O visitante clica, preenche o formulário (se você pedir dados) e começa a conversar. A sua equipe responde pela Caixa de Entrada, e a resposta aparece na hora na janela do visitante.

A origem do visitante é capturada sozinha: você não precisa configurar nada para isso (detalhes mais abaixo).

Passo a passo

Cenário: uma escola de idiomas quer atender quem visita a página de matrículas.

Em Configurações → Canais, clique em Adicionar Canal. O assistente tem quatro etapas.

Etapa 1 — Canal

Escolha WebChat.

Etapa 2 — Detalhes

  • Nome do Canal (obrigatório): nome interno. Exemplo: "Chat do site".
  • Canal Ativo: ligado, o canal funciona assim que for criado. Você pode deixar desligado até colar o código no site.
  • Domínios Permitidos (Opcional): os sites onde o chat pode aparecer. Digite o domínio e clique em Adicionar. Vazio, qualquer site pode usar o seu código. Recomendamos preencher (veja as pegadinhas).

Etapa 3 — Formulário

Escolha quais campos o visitante preenche antes de conversar: Nome Completo, CPF ou CNPJ, E-mail e Celular ou Telefone. Em cada campo visível, a chave Campo obrigatório diz se ele pode ficar em branco. Ao escolher o WebChat, nome, e-mail e telefone já vêm visíveis, e só o nome vem obrigatório.

Etapa 4 — Aparência

  • Mensagem de Boas-vindas: o primeiro texto que o visitante vê.
  • Cor do Tema (obrigatório): a cor do balão e do cabeçalho do chat. Use a cor da sua marca.
  • Posição (obrigatório): Inferior Direita ou Inferior Esquerda.
  • Título do Widget (obrigatório): o texto no topo da janela. Exemplo: "Fale com a secretaria".
  • Placeholder (obrigatório): o texto cinza do campo de mensagem. Exemplo: "Digite sua dúvida...".

Nas etapas Formulário e Aparência, o Preview ao vivo ao lado mostra como o chat vai ficar. No fim, clique em Criar Canal.

Instalar no site

O código fica no menu do canal:

  1. Em Configurações → Canais, abra o menu do cartão do WebChat (três pontos) e clique em Código de Integração.
  2. Clique em Copiar.
  3. Cole o código antes de </body> em todas as páginas onde o chat deve aparecer. Em construtores de site e lojas virtuais, procure a opção de scripts no rodapé ou de código personalizado.
  4. Publique o site e abra-o numa nova aba: o balão aparece.

Para mudar nome, domínios, formulário ou aparência depois, use Configurar, no mesmo menu. A mudança vale na próxima vez que a página do site for carregada.

O que é capturado automaticamente

Quando o visitante abre uma conversa nova, o Codewo registra no contato:

  • UTMs: utm_source, utm_medium, utm_campaign, utm_term e utm_content;
  • Identificadores de clique do Google Ads (gclid, gbraid, wbraid) e da Meta (fbclid);
  • Cookies de anúncio que o site já tem, do Google Ads, do pixel da Meta e do Google Analytics;
  • O site de onde a pessoa veio e o endereço da página em que a conversa começou.

Esses dados são lidos na página em que o visitante começa a conversa. Depois da primeira conversa, a origem fica guardada no navegador dele por 30 dias: se ele voltar nesse prazo por outro caminho, sem UTM, a origem guardada vai junto. Página com o parâmetro srsltid no endereço é marcada como Google Shopping. Sem nenhum sinal, a conversa entra como Direto.

O que cada origem significa está em Origem dos leads: relatórios de Atribuição e Jornada do Cliente.

Atendendo pela Caixa de Entrada

  • A conversa do WebChat aparece na Caixa de Entrada como qualquer outra, com o nome do canal.
  • Você pode editar uma mensagem enviada em até 15 minutos e apagar em até 48 horas. A mudança aparece para o visitante.
  • Nota interna nunca aparece para o visitante.
  • O visitante pode enviar arquivos e pode encerrar a conversa pela opção Encerrar conversa, no menu da janela do chat.
  • Se o visitante volta pelo mesmo navegador em até 30 dias, o Codewo o reconhece e a conversa continua no mesmo contato. Em outro navegador ou aparelho, ele começa do zero.
  • Para reservar o chat do site a uma equipe ou a algumas pessoas, use Quem atende, no menu do canal (veja Atendimento exclusivo por canal).

Atendente virtual no WebChat

Se a sua empresa usa a Atendente virtual, ela pode responder no WebChat, com base na Base de Conhecimento e nos Trabalhos ligados. Nesse canal, por segurança, ela não consulta pedidos nem propostas, não monta orçamento e não põe o lead no funil: o visitante digita no formulário o telefone que quiser, e o Codewo não tem como confirmar quem ele é. Esses pedidos ficam com a sua equipe.

Pegadinhas comuns

  • O chat não aparece depois de colar o código.
    • Confira os Domínios Permitidos. Cadastrar meusite.com.br libera também www.meusite.com.br, mas cadastrar www.meusite.com.br não libera meusite.com.br. Para subdomínios (loja.meusite.com.br), cadastre *.meusite.com.br.
    • Confira se o canal está ativo.
    • Com a assinatura da empresa suspensa, o chat deixa de funcionar no site.
  • A UTM se perde quando o visitante navega antes de começar a conversa. Se ele chega com UTM na página do anúncio e começa a conversa em outra página do site, a UTM não vai junto, e a origem costuma aparecer como Referral (o seu próprio site). O botão dos Widgets do Site guarda a UTM desde a página de entrada; o WebChat, não.
  • Mudou a cor ou o título e nada aconteceu? Recarregue a página do site. Se o site usa um plugin ou serviço de cache, pode ser preciso limpar esse cache também.
  • Telefone ou e-mail de um contato que já existe. Se o visitante informa o telefone ou o e-mail de alguém já cadastrado, a conversa entra nesse contato, junto do histórico dele. Como o visitante digita o que quiser, confirme quem ele é antes de passar dados de pedido ou de cadastro pelo chat.
  • Visitante sem nome. Se o nome não for pedido, o contato aparece como "Visitante" até alguém completar o cadastro.
  • O código muda cada vez que você abre Código de Integração. É normal: todas as versões funcionam. Editar o canal também não muda o código já publicado.
  • O código não expira, e a tela não tem botão para trocá-lo. O que controla onde ele funciona é a lista de Domínios Permitidos.
  • O WebChat não entra nos Widgets do Site. Se o site também usa o botão com vários canais, instale os dois códigos e deixe um balão de cada lado.

Boas práticas

  • Preencha os Domínios Permitidos. Sem eles, qualquer site pode exibir o seu chat.
  • Peça só o necessário no formulário. Cada campo obrigatório a mais faz alguém desistir. O telefone costuma bastar para retomar o contato depois.
  • Use a cor da marca e um título que diga quem responde ("Fale com a secretaria").
  • Instale o chat nas páginas que recebem anúncio. A origem é lida na página em que o visitante começa a conversa, e é nas páginas de anúncio que as UTMs chegam.
  • Combine com a Atendente virtual para responder na hora as dúvidas comuns e passar à equipe o que precisa de uma pessoa.
  • Deixe o balão à vista e sem cobrir outro botão do site.

Veja também

Este artigo foi útil?

Continue lendo