InícioDocumentação

Widget Customization

Faça o widget de chat combinar com a sua marca e comportar-se exatamente como você deseja. Toda a personalização ocorre no seu dashboard — as alterações são aplicadas ao seu site automaticamente, sem tocar no código de embed.

Você encontrará as configurações em Painel → Chatbots → selecione seu chatbot:

  • A aba Widget controla a aparência (posição, cores, tamanho, textos)
  • A aba Comportamento controla como o widget interage com os visitantes

Clique em Salvar Alterações no topo da página para aplicar suas edições.

Widget Tab: Appearance

Position

Escolha onde o widget aparece no seu website:

PositionDescription
Inferior DireitoBolha de chat flutuante no canto inferior direito (padrão)
Inferior EsquerdoBolha de chat flutuante no canto inferior esquerdo
Em linha (Incorporado)O widget é incorporado diretamente na página em vez de flutuar

Com a posição Inline, o chat é incorporado no local onde o script de embed é colocado e fica sempre aberto — sem bolha, sem botão de fechar. Ideal para páginas dedicadas a chat ou suporte. Veja Widget Embedding para mais detalhes.

Color Theme

Primeiro escolha o Modo da janela de chat:

ModeDescription
EscuroFundo escuro com texto claro
ClaroFundo branco com texto escuro (padrão)

Em seguida, escolha um dos três presets de cor — cada um se aplica ao modo selecionado:

PresetDescription
PadrãoO esquema de cores padrão do ChatReact
MarcaAs cores da sua empresa em Company Settings
PersonalizadoEscolha suas próprias cores

O preset Marca está disponível apenas depois que as cores da marca forem definidas. Vá em Company Settings para extrair cores do seu site.

Com Personalizado selecionado, você pode definir quatro cores base:

  • Primária — bolha, gradiente do cabeçalho, botões e mensagens do visitante
  • Secundária — segunda cor do gradiente do cabeçalho
  • Histórico — fundo da janela de chat
  • Texto — cor do texto das mensagens

Bordas, campos de entrada e mensagens do bot se adaptam automaticamente a claro ou escuro, com base na cor de fundo — então um fundo claro personalizado funciona como o modo Claro. Mudar o modo reinicia a cor de fundo e do texto (e quaisquer sobrescritas de cor de mensagens do bot) para os padrões desse modo.

Advanced Color Settings

Precisa de mais controle? Com o preset Personalizado selecionado, expanda Configurações avançadas de cores para sobrescrever as cores calculadas automaticamente:

  • Mensagens dos visitantes — cor de fundo e do texto das bolhas de mensagem do visitante
  • Mensagens do bot — cor de fundo e do texto das bolhas de mensagem do bot
  • Cor do texto do cabeçalho — cor do título e subtítulo no cabeçalho do widget

Tudo o que você deixar intacto é calculado automaticamente para garantir bom contraste. Cada sobrescrita tem um botão Redefinir para automático para retornar à cor calculada.

Size & Style

SettingRangeDefault
Raio da borda0–32 px24 px
Largura300–500 px380 px
Altura400–700 px600 px

Em telas móveis pequenas, o widget muda automaticamente para um layout de largura total, independentemente dessas dimensões.

Logo

Ative Usar logotipo da empresa no cabeçalho do widget para mostrar o logotipo da sua empresa no cabeçalho do chat. O logotipo em si é enviado em Company Settings — recomendado: quadrado, pelo menos 200×200 px (JPG, PNG, GIF, WebP ou SVG, máx. 5 MB).

Essa opção está disponível no plano Professional e superiores, e em todos os planos Agency.

Header Title, Subtitle & Bubble Text

FieldDescriptionDefault
Título do cabeçalhoTítulo exibido no cabeçalho da janela de chat"Chat with us"
Subtítulo do cabeçalhoLinha menor abaixo do título"We typically reply within minutes"
Texto da bolhaTexto exibido ao lado da bolha de chat quando o widget está fechadoNone

Se você nunca definir um título ou subtítulo, o widget usa o texto padrão embutido mostrado acima ("Chat with us" / "We typically reply within minutes") para todo visitante, independentemente do idioma. Uma vez que você defina seu próprio título ou subtítulo, esse texto exato é mostrado a todos os visitantes também — nada é traduzido automaticamente conforme o idioma do navegador do visitante. Para mostrar texto diferente a visitantes em outro idioma, adicione uma tradução para esse idioma no cartão Widget Translations abaixo.

Como o subtítulo do cabeçalho funciona: Enquanto você não configurar um subtítulo, o widget mostra o texto padrão acima, e o formulário de configurações pré-preenche esse padrão para que você possa ver e editar o que os visitantes recebem. Para ocultar completamente o subtítulo, limpe o campo e salve — um subtítulo intencionalmente vazio permanece oculto.

O texto da bolha aparece como um pequeno rótulo ao lado da bolha de chat fechada (por exemplo, "Got questions?"). Deixe em branco para mostrar apenas a bolha redonda.

Widget Translations

Se seu chatbot suporta múltiplos idiomas, um cartão Traduções do Widget aparece abaixo das configurações de aparência. Lá você pode traduzir a mensagem de boas-vindas, a mensagem de fallback, o título do cabeçalho, o subtítulo do cabeçalho e o texto da bolha para cada idioma habilitado — insira traduções manualmente ou use o botão de tradução por IA embutido para traduzir um único campo ou todos os campos de uma vez.

As mensagens de boas-vindas e fallback são configuradas na aba Persona das configurações do seu chatbot.

Live Preview

A coluna direita da aba Widget mostra uma Pré-visualização ao vivo do seu widget que é atualizada conforme você altera as configurações. É interativa: feche a janela de chat com o X para ver a bolha fechada (incluindo seu texto de bolha), e clique na bolha para abri-la novamente.

Behavior Tab: Interaction

Behavior Settings

SettingDescriptionDefault
Saudação proativaO bot saúda os visitantes automaticamente após um atraso (1–10 segundos)On, 3 s
Abrir automaticamenteO widget abre automaticamente para visitantes após um atraso (1–15 segundos)Off, 5 s
Som ativadoReproduzir sons para notificaçõesOn
Indicador de digitaçãoMostrar uma animação enquanto o bot está digitandoOn
Formulário pré-chatCapturar informações do visitante antes do início do chatOff
Mostrar no celularExibir o widget em dispositivos móveisOn

Maximum Message Length

Limite quantos caracteres os visitantes podem inserir por mensagem (100–10.000 caracteres, padrão 2.000). Isso ajuda a prevenir uso excessivo por entradas muito longas. Limpar o campo ou usar Remover limite remove seu limite personalizado; o serviço ainda aplica seu comprimento máximo de mensagem aceito.

Pre-Chat Form

Quando o formulário pré-chat está habilitado, os visitantes preenchem um formulário curto antes da conversa começar. Você configura os campos:

  • Tipos de campo: Text, Email, Phone, Textarea
  • Cada campo tem um Rótulo, um placeholder opcional, e um toggle Obrigatório
  • Reordene os campos com os botões mover para cima/baixo, ou remova-os

Se seu chatbot suporta múltiplos idiomas, uma seção de traduções aparece abaixo do editor de campos. Insira traduções para cada idioma manualmente, ou clique em Traduzir com IA para traduzir automaticamente todos os rótulos e placeholders.

Live Chat

A aba Behavior também contém o cartão Configurações do Chat ao Vivo. Habilite live chat para permitir que visitantes conversem com seus agentes humanos, e escolha um modo:

ModeDescription
Apenas EncaminhamentoLive chat somente quando o bot não consegue ajudar
IndependenteVisitantes podem conversar diretamente com agentes
AmbosHandoff e chat ao vivo direto disponíveis

Live Chat está disponível no plano Professional e superiores, e em todos os planos Agency. Veja Live Chat para como gerenciar conversas recebidas.

Branding

Em planos que incluem white-label, um cartão Branding aparece na parte inferior da aba Behavior. O branding do ChatReact fica oculto por padrão nesses planos — ative Show "Powered by ChatReact" se desejar exibi-lo no rodapé do widget.

Learning Phase

Enquanto um novo chatbot está em sua fase de aprendizado, você pode controlar quão cautelosamente ele responde — Cautious, Balanced (recomendado), ou Confident — na aba Confiança da mesma página de configurações. Essa aba aparece em planos que incluem o Improvement Agent. Veja o guia Improvement Agent para detalhes.


Next Steps