Guia completo do Webchat

O chat do seu site a fundo, em 32 capítulos: instalação, aparência, idiomas e tradução com IA, pré-chat, departamentos, horários, gatilhos, IA, a caixa de entrada e a parte para desenvolvedores.

Nov 02, 2026

Este é o guia completo do Webchat do Omnifox, em 32 capítulos: criar o canal e instalá-lo num site de verdade, cada opção de aparência, o idioma do widget e a tradução bidirecional com IA, o formulário pré-chat, os departamentos, o horário, a abertura automática e os gatilhos comportamentais, a saudação com IA e o agente de IA do canal, a experiência do visitante, a caixa de entrada, a identificação segura e a API de JavaScript. O manual em PDF tem os mesmos capítulos com capturas, cada campo e cada limite.

1. O que é o Webchat

O Webchat é um botão de chat que aparece no seu site. O visitante clica, escreve, e a mensagem chega na hora à sua caixa de entrada do Omnifox, onde uma pessoa da sua equipe ou um agente de inteligência artificial atende.

Por trás desse botão há muito mais: você pode pedir dados antes de conversar, deixar o visitante escolher o departamento, cumprimentar só em certas páginas, responder fora do horário e reconhecer os clientes que já fizeram login. O Webchat está incluído em todos os planos.

2. Criar o canal

Para criá-lo vá em Configurações, Canais, e clique em Conectar novo canal. Aparecem todas as plataformas que você pode conectar; escolha Webchat.

Dê um nome ao canal, que é como você o verá dentro do Omnifox, por exemplo com o domínio do seu site. Depois, o nome do widget, que é o título que o visitante verá no chat; a cor principal da sua marca; e uma mensagem de boas-vindas.

Embaixo, em Idioma do widget, você escolhe em que idioma o visitante verá os textos do chat e em qual a sua equipe escreve; a tradução automática com IA é ativada depois, na aba Idiomas. Clique em Salvar e obter código.

3. Instalar no seu site

O Omnifox entrega o código de inserção: uma única linha. Copie com o botão. Ela vai em todas as páginas do seu site, logo antes da tag de fechamento do body.

Esta é a loja da Volcán Outdoor, ainda sem chat. O painel dela tem uma seção para adicionar código em todas as páginas; colamos a linha e salvamos. No WordPress, Shopify, Wix ou qualquer outra plataforma, procure a opção de inserir código no rodapé ou uma extensão que permita; se você usa o Google Tag Manager, também funciona como uma tag de HTML personalizado.

Recarregamos a loja e lá está o botão do chat. Voltamos ao Omnifox, clicamos em Verificar instalação, e o Omnifox confirma que detectou o widget no nosso domínio. O canal já está ativo.

4. O canal na lista

Na lista de canais, o Webchat tem o seu cartão com o status e a última verificação. Os botões são: a verificação de saúde, Editar, que abre o mesmo assistente da criação, e Código de inserção, que leva ao editor completo do widget, onde vamos passar quase todo este guia.

Você também tem o botão de Inteligência Artificial, com um ponto verde quando a IA responde neste canal, pausar o canal e excluí-lo.

Pausar é útil se você quer desligar o chat por um tempo sem perder nada: o widget deixa de aparecer e o Omnifox deixa de monitorar o canal; ao reativar, ele volta exatamente como estava. Excluir, por outro lado, apaga o canal e a configuração, e pede confirmação.

5. Código de integração e instalações

O editor do widget tem oito abas. Comecemos por Código de integração: aqui está sempre a sua linha de código para copiar de novo e, abaixo, Instalações detectadas.

O Omnifox anota em quais domínios o seu widget foi carregado e quando foi a última vez. Se você o colocou em vários sites, verá todos, com o mais recente marcado. É a forma mais rápida de confirmar que o código continua instalado.

Um detalhe importante: o código é o mesmo para sempre. Você pode mudar cores, textos, horários ou gatilhos quantas vezes quiser sem mexer de novo no seu site, porque o widget lê a configuração do Omnifox a cada carregamento de página.

6. Nome, cor, tipografia e posição

Vamos para Aparência. À esquerda, o editor de tema; à direita, a pré-visualização ao vivo, que muda a cada ajuste.

O nome do widget é o título do chat. A cor principal pinta o botão, o cabeçalho e as mensagens do visitante; o texto por cima fica branco ou preto sozinho, para sempre ser legível. Escolha a tipografia e a posição, embaixo à direita ou à esquerda.

O subtítulo é a linha pequena abaixo do nome; se você deixar vazio, aparece Costumamos responder em minutos. Salvamos a aparência, recarregamos a loja, e o chat já tem a cara da Volcán Outdoor.

7. Mensagem de boas-vindas e avatar

A mensagem de boas-vindas é a primeira coisa que o visitante vê ao abrir o chat, como se a sua equipe a escrevesse. Aparece uma vez por visitante: se ele voltar outro dia, não se repete.

O avatar do cabeçalho é a foto ou o logo redondo do cabeçalho: você faz o upload, em PNG, JPG ou WebP, e o Omnifox otimiza. E com Mostrar quem está respondendo no cabeçalho, quando alguém responde, o cabeçalho muda para a foto e o nome dessa pessoa ou do agente de IA.

Salvamos, e um visitante novo que entra na loja já vê as boas-vindas, com o logo da Volcán Outdoor no cabeçalho.

8. Tema e marca

O modo do tema pode ser claro, escuro ou automático, que segue o que o visitante escolheu no dispositivo dele. O formato das mensagens escolhe entre balões arredondados ou mais quadrados.

E o interruptor Mostrar Powered by Omnifox controla o rodapé com a nossa marca dentro do chat.

Cada aba do editor tem o seu próprio botão de salvar: se você mudar algo em Aparência e for para outra aba sem salvar, essa mudança se perde. Salve sempre antes de sair da aba.

9. O botão do chat

Agora o botão flutuante. Com Tamanho do balão você escolhe o diâmetro, de quarenta a setenta e dois pixels.

Mostrar texto ao lado do botão o transforma numa pílula com um texto ao lado do ícone, como Fale conosco. Você escolhe se o texto vai à direita ou à esquerda, se aparece no computador, no celular ou em ambos, e se o visitante pode minimizá-lo com um pequeno x.

A animação de atenção faz o botão pulsar, quicar, sacudir ou tocar de tempos em tempos. E você pode usar a foto do atendente como ícone do botão. Salvamos e olhamos o resultado na loja.

10. Idioma do widget

Na aba Idiomas você escolhe o idioma do widget: espanhol, inglês ou português. Com a detecção automática ligada, cada visitante o vê no idioma do navegador e, se não for um desses três, no que você escolheu.

Você também pode mostrar um seletor de idioma no cabeçalho do chat, para que o visitante o mude. E se o seu site tem várias versões, cada página pode forçar o idioma com o atributo data locale no código.

O idioma muda todos os textos do widget: o formulário, os botões, os avisos e a mensagem de fora do horário. O que você escreve, como as boas-vindas, aparece como está, então escreva no idioma dos seus clientes.

11. Tradução bidirecional com IA

A tradução bidirecional faz com que o visitante e o seu agente conversem cada um no seu idioma: a IA traduz as mensagens nas duas direções, em tempo real. Está disponível a partir do plano Crece.

Você escolhe o idioma do seu agente e o idioma padrão do visitante, e pode mostrar o aviso Traduzido por IA dentro do chat. Aqui você também vê o consumo de traduções do mês.

Vamos testar. Uma visitante escreve em inglês. Na caixa de entrada, a Valeria lê em português, responde em português, e a visitante recebe a resposta em inglês.

12. Formulário pré-chat

Em Pré-chat, o formulário pede dados antes de começar a conversa. Vem desligado; ao ativar, você adiciona até dez campos.

Cada campo pode ser um dado padrão do contato, como nome, e-mail ou telefone; um dos seus campos personalizados; ou outra pergunta livre, do tipo texto, área de texto, número, e-mail, telefone ou uma lista de opções. E você o marca como obrigatório se não puder ser pulado.

Os dados padrão e personalizados vão direto para a ficha do contato; as perguntas livres ficam na conversa. É assim que o visitante vê: primeiro o formulário, depois o chat.

Com o formulário desligado, o widget também se comporta bem: a conversa começa com a primeira mensagem, e o contato aparece como Visitante seguido de um código até você saber o nome dele.

13. Seletor de departamentos

O seletor de departamentos deixa o visitante escolher com qual equipe quer falar. Os departamentos são as equipes do seu espaço de trabalho: você marca quais mostrar e pode dar a cada uma um nome para o visitante, uma cor e um ícone. Você as ordena arrastando.

Se a seleção for obrigatória, o visitante não pode pulá-la; se não, aparece Continuar sem escolher. Vem depois do formulário: primeiro os dados, depois o departamento e então o chat.

O visitante escolhe Suporte pós-venda, escreve, e a conversa entra atribuída a essa equipe, distribuída conforme a estratégia da equipe. Aqui ficou com o Diego.

Se você ainda não tem equipes, o seletor avisa: crie-as primeiro em Configurações, Equipes, com os integrantes e a forma de distribuir.

14. Horário de atendimento e fora do horário

Em Disponibilidade você define o seu horário: o fuso horário e, para cada dia, se atende e de que hora a que hora. Também aceita horários que atravessam a meia-noite. Se você não ativar nenhum dia, o chat aparece sempre disponível.

Fora desse horário, o visitante vê a sua mensagem de ausência. E se você ativar Capturar nome e e-mail, ele deixa os dados antes de escrever, assim nenhum contato se perde mesmo sem ninguém conectado.

Para ver, digamos que hoje já fechamos. Na loja, o chat avisa que estamos fora do horário e pede nome e e-mail. A conversa chega do mesmo jeito à caixa de entrada, para responder no dia seguinte.

15. Som e notificações do visitante

No topo da mesma aba estão os avisos para o visitante. Reproduzir um som toca quando a sua equipe responde e o chat está minimizado ou a aba está em segundo plano.

E as notificações do navegador fazem o título da aba piscar e, se o visitante permitir, mostram um aviso na área de trabalho. Além disso, o botão do chat mostra um contador vermelho com as mensagens não lidas.

Se o visitante fechou o chat e o seu agente responde, o chat se abre sozinho com a mensagem nova, para que ele não perca. Vamos testar: o visitante pergunta algo e minimiza o chat; a Valeria responde pela caixa de entrada, e na loja o chat se abre sozinho, com a resposta dela.

16. Abertura automática

A aba Gatilhos começa com quatro comportamentos prontos, todos desligados por padrão. Abrir automaticamente após um atraso abre o chat sozinho depois de alguns segundos. O balão de saudação proativa mostra uma mensagem ao lado do botão, em espanhol, inglês e português, sem abrir o chat.

Abrir automaticamente nestas páginas abre só nos caminhos que você escrever, um por linha, como o carrinho. E Abrir ao detectar intenção de saída abre quando o cursor vai para cima, prestes a fechar a aba; isso só acontece no computador.

Duas regras para não incomodar: se o visitante fechar o chat, ele não reabre sozinho por trinta segundos, e no celular nunca abre sozinho. Ativamos a abertura no carrinho e conferimos.

17. Balão proativo e foto do atendente

Em Aparência, o bloco Balão proativo e atenção decide como essas saudações aparecem. Você coloca a foto e o nome de um atendente, e o ponto verde de online, para que a saudação pareça de uma pessoa de verdade.

Você escolhe a animação de entrada, se os balões se empilham ou se substituem um ao outro, e um som sutil ao aparecer.

A foto do atendente também pode substituir o ícone do botão, como vimos antes. Se você não enviar uma foto aqui, é usado o avatar do cabeçalho.

18. Gatilhos: o primeiro passo a passo

Abaixo ficam os gatilhos comportamentais: regras que você monta. Cada uma tem um Quando, com uma ou várias condições, e um Então, com a ação. Vamos criar uma: quando alguém está há dez segundos olhando a página de barracas.

Adicionamos a condição A URL contém barracas, e outra de tempo na página: dez segundos. Com a lógica Todas as condições, as duas precisam ser cumpridas.

A ação: mostrar um balão de saudação, dividido numa sequência de duas mensagens. E quando o visitante abrir o chat, iniciamos uma conversa com a Vela, a nossa agente de IA, com o objetivo de ajudá-lo a escolher a barraca.

Salvamos e vamos para a loja. Entramos em barracas, esperamos, e aparecem os dois balões. Ao abrir o chat, a Vela já está digitando, e sabe em que página o visitante está.

19. Todas as condições e a lógica E/OU

Estas são todas as condições: tempo na página, quanto rolou a página, em porcentagem ou em pixels, intenção de saída, o endereço da página, inatividade, o dispositivo, seja computador, celular ou tablet, e O visitante abre o chat.

Para o endereço você tem quatro operadores: contém, é exatamente, começa com e não contém. Por exemplo, só a página inicial é o caminho barra com É exatamente. E com Qualquer condição, basta que uma se cumpra. Cada gatilho aceita até dez condições, e você pode ter trinta gatilhos.

Inatividade se cumpre quando o visitante para de mover o mouse, rolar ou digitar durante os segundos que você indicar, a partir de cinco. E O visitante abre o chat serve para ações que só devem acontecer quando a pessoa já mostrou interesse.

20. Todas as ações, frequência e ocultar

No Então você pode abrir o widget, mostrar um balão, ocultar o widget, enviar uma mensagem automática e depois atribuir a conversa, iniciar uma conversa com IA, atribuir a uma pessoa, uma equipe ou um agente de IA, executar um fluxo de trabalho, ou mostrar o seletor de departamentos ou o formulário.

A frequência decide a cada quanto se repete: uma vez por sessão, a cada carregamento de página, toda vez que se cumprir, uma vez por dia, ou uma única vez por visitante. E Ocultar bolhas automaticamente as retira depois de alguns segundos se ninguém tocar.

As ações do servidor, como enviar uma mensagem, atribuir ou executar um fluxo, acontecem uma única vez por conversa, mesmo que o visitante recarregue. E em Mostrar um balão você pode adicionar, em Quando o visitante abrir o chat, várias ações que rodam em ordem.

21. Saudação contextual com IA

Na aba IA está a saudação contextual: quando o visitante abre o chat, a IA lê a página em que ele está e escreve uma boas-vindas sob medida. Você não precisa criar nenhum agente: ela usa o motor da plataforma.

O tempo de espera decide a cada quanto ela cumprimenta a mesma pessoa; uma vez por sessão é o recomendado, porque cada saudação consome IA. Ativamos e abrimos o chat na página de envios: a saudação fala justamente de envios. Se o visitante responder, essa saudação fica guardada na conversa.

Se você tiver a saudação com IA e também um gatilho que inicia uma conversa com IA ao abrir o chat, o visitante receberia duas saudações: use uma das duas em cada página.

22. O agente de IA do canal

Para que um agente de IA responda às mensagens, vá à tela de Inteligência Artificial do canal. Escolha o agente, aqui a Vela, e a estratégia de resposta: Desativado, Sempre, ou Só conversas novas.

A partir de agora a Vela responde. Um visitante pergunta sobre o envio para Cuenca e a Vela responde com os dados reais da loja. Quando ele pede para falar com uma pessoa para comprar, a Vela passa a conversa para a equipe de Vendas: na caixa de entrada ela chega atribuída, com um resumo da IA, e a Vela fica em pausa para que uma pessoa responda. Como criar e treinar o agente está no guia completo de Agentes de IA.

Com Sempre, a Vela responde enquanto a conversa estiver com ela; assim que uma pessoa a assume ou a transfere para uma equipe, a Vela para de responder. Com Só conversas novas, ela assume as que começam a partir desse momento e deixa em paz as que já existiam.

23. O que o visitante pode fazer

Do lado do visitante, o chat tem tudo o que ele espera de um aplicativo de mensagens moderno. Com o clipe ele anexa fotos, PDF, áudio ou vídeo, de até vinte megas; as imagens aparecem em miniatura e se ampliam com um clique.

Tem o seu próprio painel de emojis e, com o microfone, grava uma nota de voz de até três minutos. Os links ficam clicáveis, e as suas mensagens podem ter negrito e listas.

Enquanto o seu agente digita, o visitante vê o aviso de digitando, e o seu agente também vê quando o visitante digita. E cada mensagem marca quando foi entregue e quando foi lida.

24. Atender pela caixa de entrada

Na caixa de entrada, as conversas do Webchat levam o ícone do chat web. O ponto verde indica que o visitante está online agora, com o site aberto.

No painel do contato, Visitante web mostra a página de onde ele escreveu, de onde veio, as páginas de onde escreveu e o navegador e o dispositivo. E se ele preencheu o formulário, as respostas estão em Pré-chat.

Você responde como em qualquer canal: com respostas rápidas, como barra envio, notas internas para a sua equipe, ou atribuindo a um colega. Tudo chega ao visitante na hora.

Se o visitante fechar a aba, o ponto se apaga e o cabeçalho mostra quando ele foi visto pela última vez. A sua resposta chega do mesmo jeito: ele a verá assim que voltar ao seu site naquele navegador.

25. Resolver, pesquisa e transcrição

Quando o caso termina, você marca a conversa como resolvida. O visitante vê o aviso de que a conversa foi resolvida e, se a sua pesquisa de satisfação estiver ativa, avalia o atendimento ali mesmo, com estrelas e um comentário.

A avaliação chega à conversa e aos seus relatórios. Se a transcrição por e-mail estiver ativa, o visitante pode pedir uma cópia do chat no e-mail dele. E com Iniciar nova conversa ele começa outra quando quiser.

26. O visitante que volta

O Webchat lembra do visitante naquele navegador. Se ele recarregar, mudar de página ou voltar mais tarde, vê a conversa como a deixou.

Se escrever de novo pouco depois de ser resolvida, a mesma conversa se reabre, e na sua caixa de entrada continua sendo o mesmo contato, com todo o histórico.

Por isso, quando um cliente compartilha o computador ou troca de conta no seu site, convém chamar Omnifox ponto logout ao sair da sessão: o widget esquece o visitante anterior e o próximo começa do zero.

27. No celular

No celular, o chat abre em tela cheia e se ajusta ao teclado. Embaixo tem um botão grande, Voltar ao site, para que ninguém fique preso se abriu sem querer; o botão de voltar do telefone também funciona.

O texto ao lado do botão pode aparecer só no celular ou só no computador, e no celular o chat nunca abre sozinho: os balões aparecem, e o visitante decide se toca neles.

A pré-visualização do editor mostra o chat do computador, então, depois de mudanças grandes, abra também pelo seu telefone para ver como fica.

28. Identificação segura de usuários

Se o seu site tem clientes que fazem login, a aba Identificação de usuários permite reconhecê-los de forma segura. O seu servidor assina o identificador do usuário com esta chave secreta, e a sua página passa ao widget esse identificador, a assinatura e os dados dele.

Aqui estão os exemplos em PHP, Node e Python, e a chamada Omnifox ponto identify. A chave nunca vai no navegador e, se você a regenerar, as assinaturas anteriores deixam de valer na hora.

Na loja, a Martina faz login e abre a conta dela; o site a identifica com a assinatura. Ela escreve, e na caixa de entrada a conversa chega no nome de Martina Gómez, com o e-mail, unida à ficha de cliente mesmo que ela troque de computador.

29. API de JavaScript e atributos

Para desenvolvedores, o widget tem uma pequena API. Omnifox ponto open abre o chat, close fecha, toggle alterna, isOpen diz se está aberto, e logout apaga a sessão do visitante, por exemplo quando o seu cliente sai da conta.

Na loja, o botão Falar com um atendente abre o chat com Omnifox ponto open. E o código de inserção aceita atributos para mudar, numa página, a cor, a posição, o nome, a saudação, o idioma ou um balão personalizado.

Além disso, o widget envia eventos para o seu Google Analytics ou Tag Manager: carregou, abriu, começou uma conversa e enviou uma mensagem. Assim você mede quantas vendas começam no chat.

Uma dica: como o código carrega de forma assíncrona, se você chamar a API assim que a página carrega, espere o evento load do navegador, ou use a fila de comandos que a aba Identificação mostra.

30. Co-browse

As conversas do Webchat também têm o botão de Co-browse, para ver a tela do visitante e guiá-lo dentro do seu site, com a permissão dele. É um complemento e tem o seu próprio guia completo na central de ajuda.

31. Boas práticas

Algumas boas práticas: use uma saudação curta e concreta, e dispare-a só onde ajuda, como no carrinho ou nas páginas de preços. Não peça no formulário mais dados do que o necessário. Defina o seu horário e uma mensagem de ausência honesta.

Conecte um agente de IA para responder na hora e transferir para uma pessoa o que importa. E confira de vez em quando Instalações detectadas, para saber onde está o seu chat.

32. Solução de problemas

Se o chat não aparece, verifique se o código está em todas as páginas, se o canal não está pausado, e teste numa janela anônima, sem extensões que bloqueiem scripts. Se uma mudança não aparece, recarregue a página: o widget lê a sua configuração a cada carregamento.

Se o formulário ou os departamentos não aparecem de novo, é de propósito: o widget não pergunta duas vezes a quem já tem uma conversa aberta. Teste em modo anônimo. E se a nota de voz não grava, o visitante precisa permitir o microfone no navegador.

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp