Customização

O Simple Agent foi projetado para ser invisível — o widget deve parecer que faz parte do seu produto, não uma ferramenta de terceiro colada no site.

Aparência do widget

Acesse o painel do agent → aba Aparência para configurar:

Cor principal

A cor do botão bubble e dos elementos de destaque no chat. O sistema extrai automaticamente a cor primária do seu site, mas você pode trocar por qualquer hex.

Boas práticas:

• Use a cor de maior contraste da sua paleta
• Evite cores muito claras em fundos claros (o WCAG mínimo é 4.5:1)
• A cor também é aplicada ao avatar, borda do widget e loading dots

Avatar

• Gerado automaticamente: favicon do site (padrão)
• Upload: PNG/JPG/SVG, mínimo 64×64px
• Iniciais: se não tiver imagem, exibe as iniciais do nome do agent (fallback)

Nome do agent

Aparece no header do widget. Pode ser o nome real (Suporte Simple Agent), um personagem (Luna) ou neutro (Assistente).

Mensagem de boas-vindas

A primeira mensagem que o usuário vê ao abrir o widget.

Padrão: "Olá! Como posso ajudar?"

Você pode personalizar para algo mais específico:

• "Olá! Sou a Luna, especialista em produtos XYZ. Como posso ajudar?"
• "Bem-vindo! Pergunte qualquer coisa sobre nossos planos."

Placeholder do input

O texto que aparece no campo de digitação antes do usuário escrever.

Padrão: "Digite sua mensagem..."

---

Tom de voz

Na aba Comportamento, você configura o tom de voz com 3 presets:

Preset	Estilo	Melhor para
Formal	Respeitoso, técnico, sem gírias	B2B, jurídico, financeiro, médico
Equilibrado	Cordial, claro, profissional mas humano	E-commerce, SaaS, suporte geral
Descontraído	Casual, direto, coloquial sem exagero	Apps jovens, marcas lifestyle, edtech

O preset é um prefixo no system prompt. Você pode adicionar instruções extras no campo Instruções adicionais.

---

Mensagem de fallback (out-of-scope)

Quando o agent não sabe responder — seja porque a pergunta não está nas fontes, ou porque o FCS score está baixo — ele exibe a mensagem de fallback.

Padrão: "Não tenho informações suficientes para responder isso. Posso conectá-lo à nossa equipe?"

Customize para algo mais natural para a sua marca.

Opções de fallback:

• Handoff humano: exibe botão de contato (email, WhatsApp, Intercom)
• Resposta padrão: texto customizado
• Silêncio informado: agent diz "Não sei" e pede para reformular

---

Comportamento de abertura

Opção	Descrição
Bubble (padrão)	Botão no canto, usuário clica para abrir
Auto-open	Abre automaticamente após X segundos
Re-engagement	Abre com mensagem após X segundos de inatividade
Inline	Embutido na página, sem bubble (via API JS)

Recomendação: Evite auto-open < 10 segundos. Usuários que ainda estão lendo a página ficam irritados com modais inesperados. 30–45 segundos tem a melhor taxa de engajamento sem irritar.

---

Posição e z-index

<!-- Posição customizada via CSS (advanced) -->
<style>
  #cbk-bubble {
    bottom: 80px !important; /* por cima de um cookie banner */
    right: 24px !important;
    z-index: 9999 !important;
  }
</style>

O widget usa Shadow DOM — o CSS interno não vaza para fora, e o CSS externo não afeta o interior. Para customizar o interior, use as variáveis CSS expostas via data-theme:

<script
  src="https://simple-agent.me/widget/loader.js"
  data-agent-id="SEU-AGENT-ID"
  data-theme='{"--af-accent":"#a3e635","--af-bg":"#09090b","--af-text":"#f4f4f5"}'
  async
></script>

---

White-label (plano Growth+)

Para remover completamente a marca Simple Agent:

1. Acesse Configurações → Branding
2. Ative Remover "Powered by Simple Agent"
3. Adicione seu logo (aparece no header do widget no lugar do avatar padrão)

Disponível a partir do plano Growth ($149/mês). White-label completo com custom domain no plano Agency ($399/mês).