Widget do website
O widget do OneTwoAgent coloca um agente de suporte com IA no seu website e dentro da sua app: chat e Voice no idioma do cliente, capturas de ecrã e ficheiros, e transferência para a sua equipa na mesma caixa de entrada. Pode personalizá-lo com a sua marca sem CSS.
O que este artigo cobre
- O que os clientes podem fazer no widget: chat, Voice, capturas de ecrã e ficheiros, no seu próprio idioma.
- Como personalizar o design e o comportamento do widget.
- Como instalar o widget no seu website.
- Como aplicar definições de segurança, como domínios permitidos e páginas excluídas.
Está a criar um SaaS ou uma aplicação com autenticação?
Execute npx -y @onetwoagent/cli@latest init --browser no seu projeto e depois diga ao seu agente de programação "Integrate OneTwoAgent". Consulte Ligar o OneTwoAgent à sua app para reconhecer clientes com sessão iniciada e dar ao agente dados de conta em tempo real a partir do seu backend.
O que os clientes podem fazer no widget
O agente de suporte com IA responde a todas as conversas do widget com base na sua base de conhecimento. Para clientes com sessão iniciada, usa também os dados de conta que o seu backend autoriza.
- Conversar no seu próprio idioma: o agente responde no idioma em que o cliente escrever.
- Talk (Voice): os clientes podem falar com o agente. A fala é detetada automaticamente e o Voice responde em voz alta em 40+ idiomas; onde a resposta falada não é suportada, a conversa continua em texto. Os minutos de Voice estão incluídos nos planos pagos.
- Enviar capturas de ecrã e ficheiros: imagens, capturas de ecrã e fotografias, bem como ficheiros PDF, DOC, DOCX e TXT até 8 MB. As imagens são lidas com visão computacional; os documentos PDF e Word são analisados, incluindo tabelas.
- Colar links: o agente lê a página indicada como contexto para essa conversa. Os links dos clientes são contexto, não conhecimento aprovado por si.
- Falar com uma pessoa: quando o agente não consegue verificar uma resposta, passa a conversa à sua equipa em vez de adivinhar, e qualquer membro da equipa pode assumi-la a partir da caixa de entrada.

- Mais detalhes: Voz, ficheiros e capturas de ecrã e Conversas e intervenção da equipa.
1. Abrir as definições do Widget
Vá a Channels -> Widget. Se o widget ainda não estiver ativado, ative-o primeiro.
- Pré-visualização em direto de Home, Chat e Talk, em desktop e mobile.
- Definições de design e comportamento.
- Código de instalação.
2. Personalizar o widget
Adapte o widget ao seu produto sem escrever CSS. Cada alteração aparece na pré-visualização em direto enquanto edita.
- Superfícies: Home, Chat e Talk (Voice). Escolha qual delas abre primeiro.
- Tema: claro ou escuro.
- Cores: cabeçalho, balões do assistente e do cliente, fundo do chat, campo de texto, botão de envio, launcher, botões e botão de fechar.
- Tipografia: 45 Google Fonts (sans-serif, serif e monospace), definidas separadamente para o cabeçalho, as mensagens do assistente, as mensagens do cliente, o campo de texto e o launcher, cada uma com o seu próprio tamanho.
- Mensagens: 6 formas de balão, opcionalmente aplicadas aos dois lados, e uma escolha de ícone de envio.
- Cabeçalho: nome do assistente, linha de estado e um avatar ou logótipo opcional.
- Launcher: 15 ícones, texto opcional (só o ícone em mobile, se preferir) e 13 animações do launcher.
- Ecrã inicial: título, uma linha curta acima dele, um botão principal, até 3 links, uma esfera animada e estilos de fundo como mesh, halo, rays, glow, stars, dots, grain e halftone, com controlos de tonalidade, intensidade e movimento.
- Talk: voz, mensagem de boas-vindas falada e textura da esfera.
- Textos e comportamento: mensagem de boas-vindas, placeholder do campo de texto, carregamento de ficheiros ativado ou desativado, modo compacto, domínios permitidos e páginas permitidas ou excluídas.
- Mantenha-o simples: as cores da sua marca, um nome claro e uma mensagem de boas-vindas curta costumam funcionar melhor.
- Cada opção em detalhe: Personalizar o widget.
3. Instalar o widget no seu website
Instalação padrão (recomendada).
- 1Copie o script do widget em Channels -> Widget -> Install code
- 2Adicione-o ao seu website para que carregue em todas as páginas.
- 3Melhor local: dentro de <head>, antes de </head>.
- 4Se <head> não estiver disponível, coloque-o antes de </body> (funciona, mas pode carregar um pouco mais devagar).
- Depois de instalar e publicar, o widget deverá aparecer no seu site em produção.
4. Instalar em plataformas populares
- Shopify: Online Store>Themes>Edit code -> layout/theme.liquid -> cole antes de </head> -> Save
- Wix Opção A: Settings -> Custom Code -> Add New Tool -> cole o código -> Load on all pages -> coloque em Head -> Save e publique.
- Wix Opção B: adicione o script na área global de scripts/plugins do site e garanta que carrega em todas as páginas.
- Webflow: Project Settings>Custom Code>cole em Head Code -> Save e publique.
- WordPress: use um plugin de scripts no header (secção Header) ou cole em header.php antes de </head>.
- Sites com código próprio: coloque o script no template HTML global dentro de <head> ou antes de </body>.
Ou envie isto ao seu programador
5. Definições de segurança e controlo
Definições recomendadas para um comportamento mais seguro e mais limpo.
- Domínios permitidos: evita que o código do widget seja reutilizado em websites não relacionados.
- Exemplos de domínios: yourdomain.com, www.yourdomain.com, shop.yourdomain.com.
- Páginas excluídas: esconda o widget onde ele não for relevante.
- Exclusões comuns: checkout, confirmação de encomenda, conta/login, privacidade e páginas técnicas.
- Exemplos de caminho: /checkout, /account, /thank-you.
- Comece de forma simples: ative o widget em todo o lado e exclua apenas as páginas que realmente não quer.
6. Como funcionam as conversas do widget
- Todas as conversas do widget aparecem em Conversations, na mesma caixa de entrada que o WhatsApp, o Instagram e o Telegram.
- O agente de suporte com IA responde com base na sua base de conhecimento e, para clientes com sessão iniciada, nos dados de conta autorizados, sempre no idioma do cliente.
- Qualquer membro da equipa pode assumir a conversa e responder diretamente. Enquanto um membro da equipa trata da conversa, a IA fica em silêncio; clique em Resume AI para a devolver à IA.
- No widget, o cliente vê "{name} joined the conversation" quando um membro da equipa responde e "Assistant resumed" quando a IA volta a responder.
- Detalhes: Conversas e intervenção da equipa.
Resolução de problemas
- Widget não aparece: confirme que o script está no site em produção (não apenas na pré-visualização), publique as alterações e verifique os domínios permitidos se estiverem ativos.
- O widget aparece apenas em algumas páginas: verifique as regras de páginas excluídas e confirme que o script está instalado globalmente.
- As mensagens não entram: confirme que está a usar a conta de negócio correta da OneTwoAgent e que o widget está ativado em Channels -> Widget.
Guias relacionados
Continue com os próximos passos de configuração para canais, reservas, agenda ou automação.
Tema, cores, fontes, launcher, tela Home, Voice e regras de páginas.
CLI + coding agent setup, live account data, support views and the manual integration architecture.
Central de ajuda, website, Google Drive, ficheiros e notas, sempre sincronizados.
Perguntas frequentes
Posso instalar o widget sem uma integração personalizada completa?
Sim. A configuração normal é um único script do widget no seu website, além das definições de design e comportamento dentro do dashboard.
O widget funciona em mobile e em desktop?
Sim. O widget foi pensado para visitantes de desktop e mobile, com as conversas na mesma caixa de entrada.
Em que idiomas responde o widget?
No idioma do cliente. O agente responde no idioma em que o cliente escrever. Em Voice, a fala é detetada automaticamente e o Voice responde em voz alta em 40+ idiomas; onde a resposta falada não é suportada, a conversa continua em texto. Os 10 idiomas do dashboard apenas definem a interface da sua equipa.
Os clientes podem enviar capturas de ecrã ou ficheiros?
Sim. Os clientes podem anexar imagens, capturas de ecrã e fotografias, bem como ficheiros PDF, DOC, DOCX e TXT até 8 MB. O agente lê-os e responde com base neles. Pode desativar os carregamentos nas definições do Widget.
Como reconheço clientes com sessão iniciada e mantenho o histórico das conversas entre visitas?
Consulte Ligar o OneTwoAgent à sua app. O guia aborda a CLI do OneTwoAgent, a integração com o seu agente de programação e a integração manual do lado do servidor para aplicações com sistema de login próprio.