Habilitar Webchat
Disponível para o perfil: Administrador
Configure o widget de Webchat para incorporar um chat ao vivo diretamente no seu site. As mensagens dos visitantes chegam em tempo real na plataforma Z-PRO como atendimentos normais.
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.
Você verá a seguinte tela
Detalhamento da página
Status do Webchat
No topo da tela, um painel de status indica se o serviço está operacional:
Webchat configurado e funcionando corretamente (verde)
O serviço está ativo e pronto para uso
WebSocket (porta principal): Ativo
Conexão via porta unificada do backend funcionando
WebSocket (porta separada - legado): Ativo
Compatibilidade com widgets antigos (WSS_URL) mantida
Aviso de migração: O WebSocket do Webchat agora funciona na mesma porta do backend, eliminando a necessidade de WSS_PORT e WSS_URL separados. Novos widgets já utilizam essa configuração automaticamente. Widgets antigos e novos funcionam simultaneamente — você pode remover WSS_PORT e WSS_URL do .env quando todos os widgets forem regenerados.
Campos da página
Token de Autenticação
Chave de segurança que valida as requisições do widget. Exibida apenas uma vez após a geração.
Ícone de renovar (↺)
Gera um novo token, invalidando o anterior. Widgets já instalados pararão de funcionar até serem atualizados com o novo código.
Canal Webchat
Selecione a sessão do tipo Webchat que receberá os atendimentos oriundos do site.
Habilitar botões de menu (#MENU)
Opcional. Quando ativo, mensagens com o formato #MENU são renderizadas como botões clicáveis no widget.
Gerar Widget
Gera o código JavaScript de incorporação com base no canal e token selecionados.
Como gerar o widget
Verifique se o painel de status exibe a mensagem em verde confirmando que o serviço está ativo.
Em Canal Webchat, selecione a sessão Webchat configurada.
Se quiser habilitar menus clicáveis, marque a opção Habilitar botões de menu (#MENU).
Clique em Gerar Widget.
Copie o código JavaScript gerado e cole no HTML do seu site, antes do fechamento da tag
</body>.
O widget aparecerá automaticamente no canto da página após a inserção do código. Teste enviando uma mensagem — ela deve chegar na plataforma Z-PRO como um novo atendimento.
Gerenciando o token de autenticação
O token garante que apenas o seu site possa enviar mensagens via widget.
Não compartilhe o token — ele autentica toda a comunicação entre o widget e o Z-PRO.
Renove o token clicando no ícone ↺ caso ele seja comprometido ou exposto.
Atenção: ao regenerar o token, todos os widgets já instalados nos sites pararão de funcionar imediatamente. Será necessário substituir o código gerado em cada site onde o widget está ativo.
Atualizado
Isto foi útil?