Skip to main content
O Widget Web é o canal mais rápido para colocar um agente em produção. Basta colar um snippet JavaScript no HTML do site — sem conta Business, sem aprovação de terceiros, sem configuração de webhook manual.

​
Passo a passo de criação

1

Abra Canais no dashboard

No menu lateral, acesse Canais → Adicionar canal e selecione Widget Web.
2

Nomeie a integração

Defina um nome interno (ex.: “Site Principal”, “Blog EN”) que identifique este widget nos filtros da Inbox.
3

Escolha o agente

Selecione o agente de IA que vai atender as conversas deste widget.
4

Personalize a aparência

Ajuste cor primária, cor de destaque, posição do botão (bottom-right ou bottom-left), mensagem de boas-vindas, nome do assistente, avatar e tema (auto, light ou dark).
5

Copie o snippet

A Timely.ai gera o código com o data-agent-id da sua integração. Cole-o antes do </body> em todas as páginas onde o chat deve aparecer.
6

(Opcional) Configure domínios permitidos

Restrinja em quais domínios o widget pode ser carregado para evitar uso não autorizado.

​
Notas de personalização

  • Atributos definidos diretamente no snippet sobrescrevem as configurações do dashboard — útil para múltiplas variações em páginas diferentes.
  • O widget suporta modo embeddable: adicione data-embedded="true" e data-target="#id-do-container" para renderizá-lo dentro de um <div> em vez do botão flutuante.
  • Para suporte a voz, o site deve usar HTTPS e o agente precisa ter voz configurada em Agentes → [agente] → Voz.
  • O cache do script embed.js é de 5 minutos — mudanças de configuração podem levar esse tempo para refletir no site.
Seção do snippetDescrição
data-agent-idID da integração Widget — obrigatório
data-themeTema visual: auto, light ou dark (padrão: auto)
data-positionPosição do botão flutuante: bottom-right ou bottom-left
O widget usa sessionStorage para manter a sessão enquanto a aba estiver aberta. Ao fechar e reabrir o navegador, uma nova sessão começa — o histórico anterior fica disponível para o atendente na Inbox.
<script src="https://widget.timelyai.com.br/embed.js"
        data-agent-id="agent_abc123"
        data-theme="auto"
        async></script>