Quickstart: su primera respuesta en 5 minutos
De cero a un chat en su sitio que responde con su propio contenido, con fuentes.
1. Cree un agente y dele conocimiento (2 minutos)
- Regístrese. Su workspace se crea por usted.
- Haga clic en New agent y luego en Knowledge › Add source e introduzca la URL de su sitio web. Revise las páginas encontradas, desmarque lo que no quiera y confirme. También puede subir archivos (PDF, DOCX, TXT, MD, CSV), pegar texto o añadir pares de preguntas y respuestas.
- Las respuestas empiezan a funcionar en cuanto se leen las primeras páginas. No tiene que esperar a todo el sitio.
Pruébelo antes de insertarlo: la vista previa junto a los ajustes del agente es el chat real. Pregúntele algo que su sitio responda y verá la respuesta con sus fuentes. Las respuestas de la vista previa son gratuitas.
2. Permita su dominio y publique (1 minuto)
En los Settings del agente, en Allowed domains, añada los dominios en los que puede aparecer el chat, como example.com. Use *.example.com para subdominios. El navegador se niega a mostrar el chat en cualquier otro sitio.
Después active el interruptor Live arriba a la derecha del agente.
3. Pegue una línea (1 minuto)
La pestaña Add to your website del agente le guía en cinco pasos (plantilla, aspecto, dónde, código, comprobación). El paso del código le da una línea. Añádala antes de </body> en cada página que deba mostrar el chat:
<script src="https://widget.onetype.ai/v1/embed.js" data-agent="YOUR_AGENT_ID" defer></script>Recargue su página. El lanzador aparece en la esquina. Haga clic y haga su primera pregunta. La respuesta llega poco a poco, con sus fuentes.
El loader pesa menos de 3 KB y solo carga el chat cuando un visitante pasa el ratón por encima, lo enfoca o lo abre.
4. Hágalo suyo
- Aspecto: elija una plantilla (burbuja, en línea, página de ayuda, paleta ⌘K, barra lateral de docs) y añada su logotipo, nombre y saludo.
- Comportamiento: en General, defina las instrucciones del agente, si responde solo con su conocimiento (activado de forma predeterminada) y qué ocurre cuando no lo sabe: ofrecer a una persona, recoger datos de contacto o disculparse.
5. Vaya más lejos
| Quiero… | Leer |
|---|---|
| Llevar leads y conversaciones a mis sistemas | Webhooks · REST API |
| Consultar mis docs desde Claude Code o Cursor | MCP |
| Chatear desde mi backend, sin el widget | REST API › Chat desde su backend |
Con un framework
El script de una línea funciona en cualquier sitio: HTML estático, WordPress, Webflow, temas de Shopify, React, Vue, Next.js. En aplicaciones de una sola página, cárguelo una vez en su layout raíz. El loader sigue la navegación del lado del cliente por sí mismo, así que no necesita reinicializarlo en los cambios de ruta.
El chat solo funciona en páginas servidas por https. Para probar, puede añadir localhost o 127.0.0.1 a Allowed domains; esos también funcionan con http simple.
// 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>
);
}El script de una línea funciona hoy en aplicaciones React y Vue.