Disponível para o perfil: Administrador

Configure o Webchat para receber conversas de visitantes do seu site, aplicativo ou de um QR Code. As mensagens chegam em tempo real no Fullchat como atendimentos normais.

O Webchat tem duas formas de uso:

Forma de uso	Quando usar
Incorporar no site (código)	Sites próprios: você cola o código no HTML e o balão de chat aparece no canto da página.
Link direto (URL pública)	Aplicativos, QR Codes, pop-ups ou portais onde não dá para colar código: uma página de conversa pronta, aberta por um link.

Pré-requisito: É necessário ter um canal do tipo Webchat instalado e conectado antes de gerar o widget. Veja: Como conectar um canal Webchat.

Como acessar a página

No painel administrativo, acesse Configurações > Integrações > Webchat.

Como usar esta página

Configure o Webchat para receber conversas pelo seu site (código incorporado) ou por um link direto (página pública de conversa).

Incorporando no site

Selecione o canal Webchat na lista e clique em Gerar Widget.
Cole o código gerado no HTML do seu site, antes do fechamento da tag ``.
O token de autenticação garante que apenas o seu site envie mensagens. Gere um novo se o atual for comprometido: os widgets já instalados param de funcionar.

Usando o link direto

Ative Ativar link direto e copie a URL pública ou use o QR Code.
Personalize a página nas abas Aparência, Formulário inicial e Textos da página. Essas opções valem só para o link direto; o código incorporado mantém o visual padrão.
Ative Receber pelo link de convite para continuar no Webchat uma conversa que começou no WhatsApp, usando a variável {{linkWebchat}}.
Confira o resultado na Pré-visualização antes de salvar.

Status do Webchat

No topo do card Webchat, um painel indica se o serviço está operacional:

Indicador	Significado
Webchat configurado e funcionando corretamente (verde)	O serviço está ativo e pronto para uso
WebSocket (porta principal): Ativo	Conexão pela porta unificada do backend funcionando
WebSocket (porta separada - legado): Ativo	Só aparece em instalações que ainda usam `WSS_URL`; mantém widgets antigos

Aviso de migração: o WebSocket do Webchat funciona na mesma porta do backend, sem precisar de WSS_PORT e WSS_URL separados. Widgets novos já usam essa configuração. Widgets antigos e novos funcionam ao mesmo tempo; remova WSS_PORT e WSS_URL do .env quando todos os widgets forem regenerados.

Opção 1: incorporar no site (código)

Campos do card Webchat

Campo / Opção	Descrição
Token de Autenticação	Chave de segurança que valida as requisições do widget.
Ícone de renovar (↺)	Gera um novo token, invalidando o anterior. Widgets já instalados param de funcionar até serem atualizados com o novo código.
Canal Webchat	Sessão do tipo Webchat que receberá os atendimentos.
Habilitar botões de menu (#MENU)	Opcional. Mensagens no formato `#MENU` aparecem como botões clicáveis no chat.
Gerar Widget	Gera o código JavaScript de incorporação com base no canal e no token selecionados.

Como gerar o widget

Confira se o painel de status está verde.
Em Canal Webchat, selecione a sessão Webchat.
Se quiser menus clicáveis, marque Habilitar botões de menu (#MENU).
Clique em Gerar Widget.
Copie o código gerado e cole no HTML do seu site, antes do fechamento da tag ``.

O balão de chat aparece no canto da página assim que o código é inserido. Teste enviando uma mensagem: ela deve chegar no Fullchat como um novo atendimento.

O widget incorporado usa sempre o visual padrão. As personalizações das abas Aparência, Formulário inicial e Textos da página valem apenas para o link direto.

Gerenciando o token de autenticação

O token garante que apenas o seu site envie mensagens pelo widget.

Não compartilhe o token: ele autentica toda a comunicação entre o widget e o Fullchat.
Renove o token pelo ícone ↺ se ele for comprometido ou exposto.

Atenção: ao regenerar o token, todos os widgets já instalados param de funcionar na hora. Será preciso substituir o código em cada site onde o widget está ativo.

Opção 2: link direto (URL pública)

O link direto abre uma página de conversa pronta, sem precisar colar código. Serve para abrir dentro de um aplicativo (WebView), botão de atendimento no app, QR Code impresso ou janela de conversa em portais.

Como ativar

No card Link direto (URL pública), ligue Ativar link direto. Desligado, o link não funciona.
Em URL pública, clique em Copiar link para usar o endereço onde quiser.
Para material impresso ou tela, use o QR Code exibido logo abaixo: a pessoa aponta a câmera do celular e a conversa abre.

Preenchendo os dados do contato pela URL

Você pode acrescentar parâmetros opcionais à URL para preencher os dados do contato automaticamente na primeira mensagem:

?nome=&telefone=&email=&origem=

Como a conversa se comporta

Histórico por dispositivo: ao fechar e reabrir a página no mesmo dispositivo, o histórico continua. A continuidade entre dispositivos diferentes depende de a identificação chegar assinada.
Anexos e áudio em apps Android: o aplicativo precisa permitir a seleção de arquivos e o uso do microfone. No iOS funciona nativamente.
Mensagens não lidas: a página avisa o aplicativo pelo evento zchat:unread, o que permite exibir um selo de notificação no app.

Personalizando a página do link direto

Logo abaixo do card Webchat ficam três abas. Depois de ajustar cada uma, clique em Salvar; o visitante só vê as mudanças depois de salvar.

Aba Aparência

Campo	Descrição
Título	Nome exibido no topo da conversa.
Cor principal	Cor do cabeçalho e dos botões (seletor de cor ou código hexadecimal, ex: `#2196F3`).
URL do logotipo	Endereço da imagem do logotipo, ou escolha pela galeria (ícone ao lado).
Mensagem de boas-vindas	Primeiro balão exibido ao abrir a página. Não cria mensagem no atendimento.
Texto do campo de digitação	Texto de exemplo exibido no campo onde o visitante escreve.

Aba Formulário inicial

Pede dados do visitante antes de iniciar a conversa.

Só funciona no link direto. O formulário aparece apenas para quem abre a conversa pela URL pública ou pelo QR Code. O widget instalado no site não exibe o formulário. Para usar, mantenha o link direto ativado.

Campo	Descrição
Solicitar dados antes de iniciar	Liga ou desliga o formulário.
Campos exibidos	Quais campos aparecem: Nome, E-mail, Telefone e CPF.
Campos obrigatórios	Quais desses campos o visitante precisa preencher para iniciar.
Texto de consentimento (privacidade)	Quando preenchido, exibe uma caixa de aceite antes de iniciar a conversa.
URL da política de privacidade	Link para a sua política de privacidade.

Aba Textos da página

Substitui os textos padrão da página pública. É útil para atender em outro idioma. Campo vazio mantém o texto padrão.

Campos: Botão iniciar conversa, Título do formulário inicial, Estado: conectando, Estado: reconectando, Estado: indisponível, Botão tentar novamente e Botão enviar.

Continuando uma conversa do WhatsApp no Webchat (link de convite)

Com Receber pelo link de convite ligado, o cliente que abre o link enviado pelo WhatsApp continua a conversa no Webchat como o mesmo contato.

Só a mensagem do convite é cobrada pelo WhatsApp Oficial, como as outras mensagens da API. O que o cliente conversar depois, no Webchat, não é cobrado.

Configurando o texto do convite

Em Texto do convite, escreva a mensagem e use {{linkWebchat}} onde o link deve aparecer. Sem a variável, o link vai no fim do texto. Em branco, vale o texto padrão mostrado no campo, no idioma da empresa. Clique em Salvar texto.

Enviando o convite pelo atendimento

Num atendimento do WhatsApp Oficial:

Na barra de ações do atendimento, clique no ícone Enviar convite do WebChat (seta saindo da caixa).
Confira a mensagem na janela que abre. O texto vem de Configurações > Integrações > Webchat e o link é gerado no envio.
Clique em Enviar convite.

Antes de enviar:

O link vale 24 horas e só para o primeiro navegador que abrir.
O atendimento do WhatsApp continua aberto: encerre quando o cliente passar para o Webchat.
O Webchat não avisa o cliente com a página fechada. Resposta dada depois que ele sair só é vista se ele voltar ao link.

Enviando o convite por fluxo ou mensagem rápida

Clique em Copiar variável e use {{linkWebchat}} no texto do fluxo ou da mensagem rápida. Ela vira o link da conversa ao ser enviada.

Pré-visualização

O card Pré-visualização mostra como a página do link direto fica para o visitante:

Modo	O que mostra
Rascunho	Suas alterações na hora, antes de salvar.
Publicada	A própria página pública do canal, como o visitante vê agora.

Resumo

Quero…	Onde
Colocar o chat no meu site	Gerar Widget e colar o código antes de ``
Abrir o chat por link, app ou QR Code	Ativar link direto e copiar a URL ou o QR Code
Mudar cor, título, logo e boas-vindas	Aba Aparência (só link direto)
Pedir nome, e-mail, telefone ou CPF antes	Aba Formulário inicial (só link direto)
Traduzir os textos da página	Aba Textos da página (só link direto)
Levar a conversa do WhatsApp para o Webchat	Receber pelo link de convite ligado + ícone Enviar convite do WebChat no atendimento, ou `{{linkWebchat}}` no fluxo

Possíveis erros e soluções

Problema	Solução
O link direto não abre	Confira se Ativar link direto está ligado.
Mudei cor/título/textos e o balão do site continua igual	Esperado: as personalizações valem só para o link direto. O widget incorporado usa o visual padrão.
O formulário inicial não aparece no site	Esperado: o formulário só aparece no link direto e no QR Code.
Alterei a aparência e o visitante não vê	Clique em Salvar. Confira em Pré-visualização > Publicada.
No app Android, anexo ou áudio não funciona	O aplicativo precisa liberar a seleção de arquivos e o uso do microfone no WebView.
O widget do site parou de funcionar	O token foi regenerado. Gere o widget de novo e substitua o código no site.
O convite chega sem o link no lugar certo	Inclua `{{linkWebchat}}` no Texto do convite onde o link deve aparecer.
O cliente abriu o link do convite e não entrou na conversa	O link vale 24 horas e só para o primeiro navegador que abrir. Envie um novo convite.
O cliente não viu a resposta dada no Webchat	O Webchat não avisa com a página fechada. Ele vê ao voltar ao link; se precisar, avise pelo WhatsApp.
O atendimento do WhatsApp ficou aberto após o convite	Esperado: enviar o convite não encerra o atendimento. Encerre-o quando o cliente passar para o Webchat.

Habilitar Webchat