Canais · Atualizado em 06/10/2026
Como instalar o Pipe Chat no site
Crie o Pipe Chat, libere os sites permitidos, copie o código de instalação e coloque o chat nas páginas do seu site.
O Pipe Chat é o chat do Pipe para páginas web. O visitante abre uma janela no canto da tela, escreve, e a conversa chega ao atendimento do bot ao qual o canal está ligado. A instalação tem três etapas: criar o canal, definir quais sites podem usá-lo e colar o código no site.
Quando usar
Use o Pipe Chat quando quiser atender visitantes direto do seu site, sem depender de outro aplicativo de mensagens. A Loja Girassol, por exemplo, coloca o chat nas páginas de produto para responder dúvidas de tamanho e prazo.
Pré-requisitos
- Acesso de configuração ao fluxo (bot) que receberá as conversas.
- Permissão para inserir um trecho de código nas páginas do seu site.
- O endereço completo de cada site que usará o chat, com
https://.
Passo a passo
- Abra o fluxo na Gestão e entre em Canais > Pipe Chat.
- Se o canal ainda não existe, clique em Criar Pipe Chat. Se ele já existe para a conta mas não está ligado a este bot, a página mostra "O Pipe Chat existe, mas ainda não está ligado a este bot." e o botão Ligar a este bot.
- Abra a aba Configurações.
- Em Sites permitidos (um por linha), escreva o endereço de cada site, por exemplo
https://www.lojagirassol.example. - Se quiser, altere o Nome de exibição e a Mensagem de boas-vindas.
- Clique em Salvar e aguarde a mensagem Configuração salva.
- Volte à aba Visão Geral e clique em Copiar código.
- Cole o código nas páginas do seu site onde o chat deve aparecer.
- Publique o site e abra a página publicada em uma janela anônima para conferir se o botão do chat aparece no canto da tela.
Campos da aba Configurações
| Campo | Limite | Para que serve |
|---|---|---|
| Sites permitidos (um por linha) | Um endereço por linha, com http:// ou https:// | Só os sites desta lista podem abrir o chat. |
| Nome de exibição | 40 caracteres | Aparece no topo da janela do chat. |
| Mensagem de boas-vindas | 200 caracteres | Texto inicial mostrado ao visitante. |
| Gerar nova chave | Botão | Troca a chave do chat e desativa a atual. |
O Pipe guarda cada endereço apenas como protocolo, domínio e porta. Se você escrever https://www.lojagirassol.example/produtos, ele fica https://www.lojagirassol.example. Linhas que não são endereços válidos aparecem em Endereços inválidos e impedem o salvamento.
Como o código funciona
O código é uma linha com a chave do canal. Ela carrega o chat de forma assíncrona e não bloqueia o carregamento da página. O chat fica isolado do visual do seu site, então os estilos da página não o alteram. No computador ele abre como uma janela no canto; em telas com menos de 480 pixels de largura ocupa a tela toda.
Resultado esperado
A aba Visão Geral mostra "Seu chatbot está conectado ao Pipe Chat." e o código de instalação. No site, aparece um botão de chat; ao abri-lo, o visitante vê o nome de exibição e a mensagem de boas-vindas, escreve em Digite sua mensagem e a conversa entra no atendimento.
Boas práticas
- Cadastre também o endereço de homologação, se houver, e confira cada site em janela anônima.
- Use uma mensagem de boas-vindas curta, que diga o que a equipe resolve ("Oi, aqui é a Loja Girassol. Como podemos ajudar?").
- Gere uma nova chave apenas se suspeitar que o código foi copiado por quem não deveria; depois, atualize todos os sites.
Limitações
- As opções de receber arquivos e de personalizar cores ainda não existem no Pipe Chat.
- Gerar nova chave não é reversível: a chave antiga deixa de funcionar.
Problemas comuns
- O botão Copiar código falha: a página mostra "Não foi possível copiar. Selecione o código e copie manualmente." Selecione o texto na tela e copie.
- O chat não aparece no site: confira se o endereço do site está em Sites permitidos e siga o guia de verificações do Pipe Chat.
- Aparece "Sem conexão com o chat.": use Tentar novamente no chat; se persistir, confira a lista de sites permitidos.
Próximos passos
Perguntas frequentes
Onde encontro o código de instalação?
Em Canais > Pipe Chat, na aba Visão Geral, depois de criar o canal ou ligá-lo ao bot. O botão Copiar código copia o trecho pronto.
Preciso editar meu site?
Sim. Cole o código nas páginas em que o chat deve aparecer. Quem edita o site precisa ter permissão para inserir esse trecho.
Por que preciso informar os sites permitidos?
Porque só os endereços da lista podem abrir o chat. Cada site que usar o chat precisa estar na lista de origens do canal.
Posso mudar o nome que aparece no topo do chat?
Sim, em Configurações, no campo Nome de exibição, com até 40 caracteres.
O que acontece se eu gerar uma nova chave?
A chave atual deixa de funcionar nos sites onde o código já foi colado. Será preciso copiar o código novo e colá-lo de novo.
Esse artigo foi útil?
Obrigado pelo retorno!