Canais · Atualizado em 06/10/2026
Pipe Chat não aparece no site: o que conferir
Descubra por que o Pipe Chat não aparece ou não conecta no seu site e corrija o código, os sites permitidos ou a chave.
Esta lista segue a ordem em que os problemas costumam acontecer: o código não está na página, o endereço não está liberado, a chave mudou ou o canal não está ligado ao bot. Siga do primeiro item ao último.
Quando usar
Use este guia quando o botão do chat não aparece no canto da página, quando ele aparece mas não carrega a conversa ou quando mostra Sem conexão com o chat.
Pré-requisitos
- Acesso de configuração ao fluxo na Gestão.
- Acesso ao código ou ao editor do site onde o chat deveria aparecer.
Passo a passo
- Abra o fluxo na Gestão e entre em Canais > Pipe Chat.
- Confira a aba Visão Geral. Ela deve dizer "Seu chatbot está conectado ao Pipe Chat." Se disser que o canal não está ligado, clique em Ligar a este bot; se o canal não existe, clique em Criar Pipe Chat.
- Clique em Copiar código e compare com o código que está no site. A chave (
data-key) precisa ser a mesma. - Abra Configurações e confira Sites permitidos (um por linha). O endereço onde o chat deve aparecer precisa estar na lista, com protocolo e domínio idênticos aos do navegador.
- Salve, se tiver alterado a lista, e aguarde Configuração salva.
- Recarregue a página do site em uma janela anônima.
- Se o chat continuar ausente, abra o console do navegador e procure mensagens que comecem com
[pipe-chat].
Sintomas e causas
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Nenhum botão de chat na página | O código não foi publicado nessa página | Cole o código na página e publique. |
| Console com "data-key is missing" | O atributo data-key foi apagado do código | Copie o código de novo na Visão Geral. |
| Botão aparece, janela mostra Sem conexão com o chat | Endereço do site fora da lista, ou chave antiga | Confira Sites permitidos e o código copiado. |
| Funcionava e parou | Alguém gerou nova chave | Copie o código novo e atualize todos os sites. |
| Aviso de endereços inválidos ao salvar | Linha sem http:// ou https:// | Escreva o endereço completo. |
| Visão Geral não mostra o código | O canal não está ligado ao bot | Use Ligar a este bot. |
Resultado esperado
O botão de chat aparece no canto da página. Ao abri-lo, o visitante vê o nome de exibição e a mensagem de boas-vindas, e as mensagens enviadas entram no atendimento.
Dicas para testar
Limitações
- O Pipe só confirma a instalação no site publicado; abrir o arquivo da página no seu computador, sem servidor, não conta como teste, porque não há um endereço
http://ouhttps://para liberar. - O chat não mostra o motivo técnico da falha para o visitante; para investigar, use o console do navegador.
Problemas comuns
- O botão Copiar código não funciona: selecione o texto da tela e copie manualmente.
- O chat abre, mas a mensagem fica como Não enviada: o visitante está sem conexão ou o endereço deixou de estar liberado; confira Sites permitidos.
- Há mais de um chat no site: o código só inicia uma vez por página; mantenha uma única instalação.
Próximos passos
Perguntas frequentes
O chat aparece, mas mostra Sem conexão com o chat. O que fazer?
Clique em Tentar novamente. Se continuar, confira se o endereço do site está em Sites permitidos, com o mesmo protocolo e o mesmo domínio.
O chat funcionava e parou depois de uma alteração. Por quê?
Se alguém gerou uma nova chave em Configurações, o código antigo deixou de funcionar. Copie o código novo e cole de novo no site.
Preciso cadastrar o endereço com www?
Cadastre exatamente o endereço que aparece no navegador. Com e sem www são endereços diferentes.
O chat aparece no meu computador, mas não no site publicado?
Confirme se o código foi publicado no site, e não só salvo em um ambiente de teste. A página precisa ter sido atualizada.
Esse artigo foi útil?
Obrigado pelo retorno!