Como criar um Widget ou Página de Conversa
Adicione atendimento ao seu site ou compartilhe uma página pública de chat.
Os Widgets permitem criar experiências públicas sem conectar uma rede social. A tela oferece os tipos Chat, Página de Conversa, Barra superior, Modal, Caixa inferior e Mensagem. Atualmente, apenas Chat e Página de Conversa possuem o fluxo completo de conversa com clientes documentado abaixo.
Escolha o formato
- Chat: botão flutuante incorporado ao site por um script da Klyro.
- Página de Conversa: página completa acessada por um link público, sem instalação no site.
Como criar
- Acesse Administração → Widgets e selecione Novo widget.
- Escolha Chat ou Página de Conversa.
- Defina título, subtítulo, campos iniciais e o departamento responsável.
- Configure aparência, cores, posição e conteúdo exibido antes e durante o atendimento.
- Salve e faça um teste como visitante.
Campos principais
- Tipo: Chat, Página de Conversa, Barra superior, Modal, Caixa inferior ou Mensagem.
- Título e subtítulo: textos apresentados ao visitante.
- Domínio permitido: host autorizado a carregar o Chat incorporado.
- Departamento: seleção opcional ou obrigatória antes do atendimento.
- Assunto: campo que pode ser solicitado no formulário inicial.
- Comportamento público: estimativa de espera, som, digitação, visibilidade offline, desktop e mobile, emoji, upload, avaliação e transcrição.
Aparência do Chat
- Largura e altura no desktop: entre 200 e 1.200 pixels.
- Largura minimizada: entre 40 e 400 pixels.
- Altura minimizada: entre 40 e 200 pixels.
- Posição: configurações separadas para desktop e mobile.
- Cores: cabeçalho, texto do cabeçalho, texto e mensagem do atendente, texto e mensagem do visitante.
A aparência oferece visualização ao vivo e restauração das cores da marca.
Conteúdo do Chat
Escolha a visualização inicial e personalize os estados online, ausente, offline e pré-chat. Os cartões de cabeçalho e corpo podem ser ordenados, ativados, editados ou excluídos.
- Tipos de cartão: título, texto, imagem, formulário, pesquisa na Base de Conhecimento e chat.
- Campos de formulário: nome, e-mail, departamento, assunto, telefone, texto, área de texto, número e data.
- Limites: até dez campos por formulário e títulos de até 60 caracteres.
- Restrições: formulários são usados apenas no pré-chat ou offline; há um formulário por estado e nome/e-mail do offline não podem ser removidos nem tornados opcionais.
Publicação do Chat
Copie o script de incorporação gerado pela Klyro e instale-o antes do fechamento de </body> no site. Quando usar restrição de domínio, informe somente o host, sem protocolo ou caminho.
Publicação da Página de Conversa
Copie o endereço público do widget e compartilhe-o onde o cliente deve iniciar o atendimento. Esse formato não depende da instalação do script nem da restrição de domínio do chat incorporado.
Comportamento fora do horário
Fora do horário de atendimento, o widget pode apresentar o fluxo offline configurado. Valide esse comportamento e a seleção de departamento antes da publicação.
Limites importantes
- Mensagens do visitante aceitam até 2.000 caracteres.
- Arquivos enviados pelo visitante aceitam até 10 MB.
- Conversas concluídas ou arquivadas ficam disponíveis apenas para leitura.