For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/create/webchat/enable-webchat.md.
  • Português

      • Ative o WebChat na sua página

      Publique o canal de WebChat e cole o Código de incorporação antes do </body> da página onde o chat deve aparecer. São duas etapas: publicar o canal e incorporar o código. Qualquer membro do workspace pode fazer isso — não há papel específico exigido.

      Antes de começar

      • O WebChat está em liberação gradual. Se você não vê a área WebChat em Criar, sua conta ainda não recebeu o recurso.
      • Você precisa conseguir editar o HTML da página de destino (colar código antes do </body>).

      Passos

      1. Abra Criar → WebChat e clique em Novo canal. Escolha um template e confirme em Criar canal.

      2. No editor do canal, ajuste o Fluxo do bot (aba Editor) e a aparência (aba Design). No centro da aba Editor, alterne entre Fluxo (o mapa das etapas — clique em um nó para editá-lo) e Prévia (o chat funcionando, como o visitante vai ver). Veja Prévia do chat.

      3. Clique em Publicar. Isso salva o canal já com o status Ativo — o link e o widget só funcionam com o canal publicado. Se você tentar sair do editor com mudanças não salvas, um aviso pergunta se quer Continuar editando ou Sair sem salvar.

      4. Abra a aba Compartilhamento e, em Código de incorporação, clique em Copiar código. O snippet tem esta forma:

        <div data-cx-livechat="SEU_CHANNEL_ID"></div>
<script async src="https://SEU_GATEWAY/sdk/livechat.js"></script>

        Copie sempre o código real da aba — o channelId e o endereço já vêm preenchidos.

      5. Cole o código antes do </body> nas páginas onde o chat deve aparecer.

      6. (Opcional) Em Domínios permitidos (CORS), informe uma origem por linha (ex.: https://meusite.com). Campo vazio = qualquer site pode incorporar.

      Prefere não incorporar em um site? Use o Link público (tela cheia), na mesma aba Compartilhamento: clique em Copiar link. Ele abre o chat em tela cheia e também exige o canal publicado.

      Chat em tela cheia dentro do seu site

      Com o Modo de exibição em Tela cheia (aba Design), o Código de incorporação muda: o chat passa a ocupar só a área da <div>, no lugar da página onde você colar o código, em vez de cobrir o site inteiro.

      <div data-cx-livechat="SEU_CHANNEL_ID" data-cx-mode="embed" style="height: 640px"></div>
<script async src="https://SEU_GATEWAY/sdk/livechat.js"></script>
      • Cole o código no lugar onde o chat deve aparecer (não precisa ser antes do </body>).
      • Ajuste a altura no style da <div>. A largura acompanha o espaço onde ela está. Sem altura definida, o chat usa 600px.
      • Nesse modo não há botão flutuante nem botão de fechar: o chat já aparece aberto.

      Personalize o endereço da tela cheia

      Na aba Compartilhamento, o card Endereço da tela cheia define como o link do chat aparece. As mudanças valem depois que você salvar ou publicar.

      1. Em Link personalizado, digite o final do link (ex.: atendimento). O Link público (tela cheia) passa a usar esse nome no lugar do código do canal. O link antigo, com o código, continua funcionando.
      2. (Opcional) Em Domínio próprio, escolha um domínio conectado da sua conta. O chat passa a abrir também em https://seu-dominio/<caminho>.
      3. Em Caminho no domínio, digite o caminho (ex.: fale-conosco). Vazio = usa o Link personalizado (ou o código do canal).

      Use só letras, números, hífen (-) e sublinhado (_). Mensagens que podem aparecer ao salvar:

      • Este link já está em uso. Escolha outro. — outro canal já usa esse Link personalizado.
      • Este link não pode ter o formato de um ID. Escolha outro. — o nome parece um código de canal.
      • Este caminho já está em uso neste domínio. Escolha outro. — outro canal seu já usa esse caminho no mesmo domínio.

      Se o domínio aparecer como não conectado, o endereço só funciona depois que a conexão terminar. A página no domínio próprio é aceita mesmo com a lista Domínios permitidos (CORS) preenchida.

      Prévia do chat

      A Prévia (aba Editor) e a área central da aba Design mostram o widget de verdade — o mesmo que roda no seu site —, já com as alterações que você ainda não salvou.

      • Alterne entre Balão (o botão flutuante no canto de uma página de exemplo, que abre a janela do chat) e Tela cheia (o chat ocupando a página inteira, igual ao Link público). A prévia começa no Modo de exibição escolhido na aba Design.
      • Você pode percorrer o fluxo como um visitante: preencher a captura, clicar nas opções e digitar respostas. Nada é enviado nem gravado — nenhuma conversa ou contato é criado. Numa etapa de IA, a prévia segue pelo caminho de fallback, sem classificar a resposta.
      • Se um SDR de IA atende a conta do canal (em Meus agentes), o card SDR de IA neste canal aparece acima das etapas, com o nome do agente e como ele responde. A prévia não simula o agente: ele só responde no chat publicado, depois que o Fluxo do bot termina.
      • Cada alteração no editor reinicia a conversa da prévia. Use Reiniciar conversa para começar de novo quando quiser.
      • Na aba Design o balão começa fechado, mostrando o botão flutuante com tooltip, badge e animação; clique nele para abrir a conversa. Na aba Editor a conversa já abre.
      • O chat aparece com as cores do seu canal, igual para o visitante, nos temas claro e escuro da plataforma. Só a página de exemplo em volta acompanha o seu tema.

      O widget é montado pelo Browser SDK da ClickMax. Para os atributos aceitos pela <div data-cx-livechat>, veja a referência do Browser SDK.

      Aviso de consentimento (LGPD)

      Com Consentimento (LGPD) ligado (aba Design), o chat mostra uma caixa de autorização acima da área de resposta, com o texto e o link de privacidade que você definir. O visitante só avança depois de marcá-la.

      Assim que a caixa é marcada, o aviso sai da tela e não volta mais nessa conversa — as perguntas e as opções de resposta ficam livres, sem nada por cima. Se o visitante recarregar a página ou voltar depois no mesmo navegador, o aceite continua valendo e o aviso não aparece de novo. Se você mudar o texto ou o link de privacidade, o aviso volta a aparecer para todos aceitarem o termo novo.

      Quando a conversa chega à equipe

      Enquanto o visitante percorre o Fluxo do bot, a conversa fica fora da caixa de entrada do Chat ao Vivo. Ela entra na fila quando:

      • o fluxo chega a uma etapa Atendente ou ao destino → Falar com atendente. Com Atribuir a preenchido na etapa, a conversa vai direto para essa pessoa;
      • o fluxo termina por outro caminho (Encerrar ou o fim das etapas) e o visitante escreve uma mensagem.

      O visitante vê um aviso no chat quando a conversa vai para a fila ("Você foi transferido para a nossa equipe…") e quando alguém da equipe entra nela ("Um atendente entrou na conversa."). Vale também quando quem passa a conversa para a equipe é o SDR de IA.

      Em canal sem Fluxo do bot, a conversa entra na fila já na primeira mensagem do visitante, mesmo com Mensagem de boas-vindas.

      Relacionados

      Se não funcionou

      • O chat em tela cheia cobre o site inteiro: copie o código de novo com o Modo de exibição em Tela cheia — ele precisa ter data-cx-mode="embed" na <div>.
      • O widget não aparece na página: confirme que o canal está Publicado e que o domínio da página está na lista Domínios permitidos (CORS) (ou deixe-a vazia). Veja outras perguntas.
      • Não vejo a área WebChat: o recurso ainda não foi liberado para a sua conta — veja Sem permissão.
      • O chat carrega mas dá erro ao enviar mensagem: consulte os códigos de erro.