Widget de Chatbot
Implante um assistente de chat IA em qualquer site que responda perguntas a partir das suas coleções de documentos. Um código de incorporação, sem necessidade de programação.
Como Funciona
- Você cria um widget no aqoon e o vincula a uma chave de API
- A chave de API controla quais coleções o chatbot pode pesquisar
-
Você cola uma tag
<script>no seu site - Visitantes fazem perguntas → aqoon pesquisa seus documentos → Claude gera uma resposta
A interface do chat roda dentro de um iframe do domínio do aqoon. Todas as chamadas da API são same-origin — nenhuma configuração de CORS necessária no seu site.
Criando um Widget
- Clique em Chatbot na barra lateral
- Clique em Novo Widget
- Digite um nome (exibido no cabeçalho do chat, ex.: "Bot de Suporte")
- Selecione uma chave de API — isso determina quais coleções o chatbot pode pesquisar
- Opcionalmente defina domínios permitidos (um por linha) para restringir onde o widget pode ser incorporado
- Clique em Salvar
Use uma chave de API restrita (não acesso total) se quiser que o chatbot pesquise apenas coleções específicas. Crie a chave em Chaves de API primeiro, depois selecione-a ao criar o widget.
Incorporando no Seu Site
Após criar um widget, copie o código de incorporação da página de detalhes do widget e cole antes da tag de fechamento </body>:
<script src="https://aqoon.ai/widget/wgt_abc123def456.js"></script>Um balão de chat aparece no canto da sua página. Clicar nele abre a janela do chat.
Configuração
Edite seu widget para personalizar sua aparência e comportamento:
Aparência
| Configuração | Descrição |
|---|---|
| Cor do tema | Cor de destaque do cabeçalho e botões |
| Modo do tema | Claro ou escuro |
| Tamanho do widget | Padrão, compacto ou página inteira |
| Posição | Canto inferior direito ou esquerdo |
| URL do avatar | Imagem de avatar do bot no cabeçalho |
| Subtítulo | Texto abaixo do título no cabeçalho |
Comportamento
| Configuração | Descrição |
|---|---|
| Mensagem de boas-vindas | Primeira mensagem exibida quando o chat abre |
| Sugestões | Botões de sugestão clicáveis (um por linha) |
| Texto do campo de entrada | Texto placeholder no campo de mensagem |
| Abertura automática | Widget abre automaticamente ao carregar a página |
| Contato de fallback | Informações de contato que o bot sugere quando não consegue responder |
| Instruções personalizadas | Instruções adicionais do prompt (ex.: "Sempre responda em português") |
Captura de Leads
Ative Exigir captura de leads nas configurações do widget. Os visitantes devem inserir seu nome e informações de contato antes de conversar. Esses dados aparecem na lista de conversas no seu painel.
Visualizando Conversas
- Vá para Chatbot → clique no seu widget
- A tabela de Conversas mostra todas as sessões de chat
- Clique em uma conversa para ver a transcrição completa com markdown renderizado
Cada sessão mostra: nome do visitante, contagem de mensagens, status (ativo/encerrado), avaliação por estrelas e timestamps.
Avaliação e Encerramento
Os usuários podem encerrar uma conversa:
- Digitando uma palavra de encerramento (obrigado, thank you, tchau, até mais, etc.) — a tela de avaliação aparece automaticamente após a resposta
- Clicando no botão × no cabeçalho do chat
A tela de avaliação pede de 1–5 estrelas e um feedback de texto opcional.
Limites e Controle de Custos
| Configuração | Padrão | Descrição |
|---|---|---|
| Limite diário de mensagens | 100 | Máximo de mensagens por dia para todos os visitantes |
| Limite mensal de mensagens | 3,000 | Máximo de mensagens por mês |
| Máximo de tokens por resposta | 1,024 | Controla o comprimento da resposta e o custo do LLM |
| Trechos de contexto | 5 | Resultados de busca enviados à IA por pergunta |
| Retenção de conversas | 30 dias | Por quanto tempo as mensagens são armazenadas (0 = não armazenar) |
Quando os limites diários ou mensais são excedidos, o widget pausa automaticamente e exibe "Este assistente está indisponível no momento." Você pode retomá-lo manualmente pelo painel.
Segurança
- Bloqueio de domínio — Apenas domínios permitidos podem incorporar o widget. Requisições de outras origens são rejeitadas.
- Limite de taxa — 5 mensagens por minuto e 50 por dia por endereço IP, além dos limites de orçamento do widget.
- CAPTCHA Turnstile — Integração opcional com Cloudflare Turnstile para proteção contra bots. Adicione sua chave do site nas configurações do widget.
- Honeypot — Campo de formulário oculto que captura bots automatizados.
- Proteção contra injeção de prompt — As mensagens dos usuários são isoladas separadamente do prompt do sistema. O contexto dos documentos usa delimitadores XML.
- Sanitização de saída — As respostas da IA são limpas antes da renderização para prevenir XSS.
- Anonimização de IP — Os endereços IP dos visitantes são anonimizados automaticamente após 7 dias.
Enviar
Quando um widget está associado a um agente com o Interpretador de Código ativado, os visitantes podem anexar ficheiros às suas mensagens. Isto permite que o agente leia e analise os documentos carregados diretamente na conversa.
Formatos suportados: PDF e DOCX. Tamanho máximo do ficheiro: 20 MB por ficheiro.
Um botão com um clipe aparece na barra de introdução de mensagens quando o carregamento de ficheiros está disponível. O visitante clica nele para escolher um ficheiro, aguarda que o carregamento termine e depois envia a sua mensagem. O agente recebe tanto a mensagem como o ficheiro.
O carregamento de ficheiros só está disponível quando o widget está associado a um agente Ativo com a ferramenta Interpretador de Código ativada. Não aparece em widgets padrão apenas de RAG.
Para ativar o carregamento de ficheiros: abra o agente associado ao seu widget, ative o Interpretador de Código na secção Ferramentas e republique o agente.