Documentação

Publicação

Incorpore seu agente em qualquer site com o widget JavaScript ou iframe.

Faça o deploy do seu agente para o seu site para que os visitantes possam interagir com ele. Escolha entre um widget de chat flutuante ou incorporação de página inteira via iframe.

Opções de Incorporação

Widget de Chat (Recomendado)

Um balão de chat flutuante que se expande em uma janela de chat. Funciona em qualquer site.

Incorporação via Iframe

Incorpore a interface de chat completa em uma seção da página. Útil para páginas de suporte dedicadas.

Adicionando o Widget de Chat

  1. Vá até a aba Publicar do seu agente
  2. Copie o trecho de JavaScript
  3. Cole no HTML do seu site antes de </body>:
<script
  src="https://your-domain.com/widget.js"
  data-chatbot-id="your-chatbot-id"
  async
></script>
  1. Atualize seu site - o balão de chat aparece!

O widget aparece como um botão flutuante (geralmente no canto inferior direito). Os visitantes clicam para abrir o chat.

Guias Específicos por Plataforma

Para instruções detalhadas em plataformas específicas:

Personalização do Widget

Personalize a aparência na aba Design:

Cores

  • Cor primária (balão de chat, cabeçalho)
  • Cores de destaque
  • Tema Claro/Escuro

Posição

  • Inferior direito (padrão)
  • Inferior esquerdo
  • Posicionamento personalizado via CSS

Branding

  • Mensagem de boas-vindas
  • Título do chat
  • Mensagens sugeridas
  • Remover o branding "Powered by" (planos Standard/Pro)

Configurações de Visibilidade

Controle quem pode acessar seu agente:

ConfiguraçãoDescrição
PúblicoQualquer pessoa pode usar o widget incorporado
PrivadoAcessível somente no Playground do painel

Configure em Configurações > Segurança > Visibilidade.

Restrições de Domínio

Limite quais sites podem incorporar seu agente:

  1. Vá até Configurações > Segurança
  2. Encontre Domínios Permitidos
  3. Adicione os domínios que podem incorporar seu widget

Quando configurado, o widget só carrega em domínios aprovados. Isso evita o uso não autorizado do seu agente.

Verificando Sua Incorporação

Depois de adicionar o código:

  1. Visite seu site em um navegador
  2. Procure pelo balão de chat
  3. Clique para abrir o chat
  4. Envie uma mensagem de teste
  5. Verifique se a resposta está correta

Solução de Problemas

Widget não aparece:

  • Verifique se o código de incorporação está antes de </body>
  • Verifique se o ID do agente está correto
  • Limpe o cache do navegador
  • Verifique o console do navegador em busca de erros

Widget na posição errada:

  • Ajuste a posição nas configurações de Design
  • Verifique se há conflitos de CSS

Chat não responde:

  • Certifique-se de ter conteúdo de treinamento
  • Verifique o limite de mensagens do seu plano
  • Teste primeiro no Playground

Checklist para Entrar no Ar

Antes de anunciar seu agente:

  1. [ ] Teste no Playground com perguntas comuns
  2. [ ] Verifique se o conteúdo de treinamento está completo
  3. [ ] Personalize a aparência para combinar com sua marca
  4. [ ] Configure restrições de domínio (opcional)
  5. [ ] Configure a limitação de taxa para evitar abusos
  6. [ ] Revise as configurações de visibilidade

Próximos Passos