Comece grátis

Quickstart: sua primeira resposta em 5 minutos

Do zero a um chat no seu site que responde com base no seu próprio conteúdo, com fontes.

1. Crie um agente e dê conhecimento a ele (2 minutos)

  1. Cadastre-se. Seu workspace é criado para você.
  2. Clique em New agent, depois em Knowledge › Add source e informe a URL do seu site. Confira as páginas encontradas, desmarque o que não quiser e confirme. Você também pode enviar arquivos (PDF, DOCX, TXT, MD, CSV), colar texto ou adicionar pares de perguntas e respostas.
  3. As respostas começam a funcionar assim que as primeiras páginas são lidas. Você não precisa esperar o site inteiro.

Teste antes de incorporar: a prévia ao lado das configurações do agente é o chat de verdade. Pergunte algo que o seu site responde e você verá a resposta com as fontes. As respostas na prévia são gratuitas.

2. Permita seu domínio e entre no ar (1 minuto)

Nas Settings do agente, em Allowed domains, adicione os domínios em que o chat pode aparecer, como example.com. Use *.example.com para subdomínios. O navegador se recusa a mostrar o chat em qualquer outro lugar.

Depois ative a chave Live no canto superior direito do agente.

3. Cole uma linha (1 minuto)

A aba Add to your website do agente guia você por cinco passos (modelo, aparência, onde, código, verificação). O passo do código dá a você uma linha. Adicione-a antes de </body> em todas as páginas que devem mostrar o chat:

<script src="https://widget.onetype.ai/v1/embed.js" data-agent="YOUR_AGENT_ID" defer></script>

Recarregue sua página. O launcher aparece no canto. Clique nele e faça sua primeira pergunta. A resposta chega aos poucos, com as fontes.

O loader tem menos de 3 KB e só carrega o chat quando um visitante passa o mouse, foca ou o abre.

4. Deixe com a sua cara

  • Aparência: escolha um modelo (bubble, inline, página de ajuda, paleta ⌘K, barra lateral de docs) e adicione seu logo, nome e saudação.
  • Comportamento: em General, defina as instruções do agente, se ele responde só com o seu conhecimento (ativado por padrão) e o que acontece quando ele não sabe: oferecer uma pessoa, coletar dados de contato ou pedir desculpas.

5. Vá além

Quero…Ler
Levar leads e conversas para os meus sistemasWebhooks · REST API
Consultar minhas docs pelo Claude Code ou CursorMCP
Conversar a partir do meu backend, sem o widgetREST API › Chat a partir do seu backend

Usando um framework

O script de uma linha funciona em qualquer site: HTML estático, WordPress, Webflow, temas Shopify, React, Vue, Next.js. Em apps de página única, carregue-o uma vez no seu layout raiz. O loader acompanha a navegação do lado do cliente sozinho, então você não precisa reinicializá-lo a cada mudança de rota.

O chat só funciona em páginas servidas por https. Para testar, você pode adicionar localhost ou 127.0.0.1 em Allowed domains; esses também funcionam em http simples.

// Next.js (app/layout.tsx)
import Script from "next/script";

export default function RootLayout({ children }: { children: React.ReactNode })
{
    return (
        <html lang="en">
            <body>
                {children}
                <Script src="https://widget.onetype.ai/v1/embed.js" data-agent="YOUR_AGENT_ID" strategy="afterInteractive" />
            </body>
        </html>
    );
}

O script de uma linha funciona hoje em apps React e Vue.