Puedes crear un chatbot web de Agentkit sin programar una aplicación. Añade páginas o archivos aprobados, elige cómo debe responder el agente, pruébalo en el Playground y luego copia las dos etiquetas script generadas en el área de código de tu sitio. El último paso es una prueba en la página publicada. Que aparezca una burbuja de chat en el editor no demuestra que los visitantes puedan usarla.
Necesitas una cuenta de Agentkit, contenido que tengas permiso para usar y permiso para añadir código personalizado a tu sitio web. Si el plan de tu sitio o tu rol no pueden publicar scripts, un iframe en línea puede ser una opción donde se permitan las inserciones. Revisa las reglas de tu sitio antes de empezar.
1. Empieza con una pregunta y su respuesta aprobada
Elige tres preguntas que los visitantes hagan de verdad. Incluye una pregunta rutinaria, una cuya respuesta dependa de una política vigente y una que tus fuentes no respondan. Anota la respuesta aprobada o la vía de contacto humano para cada una. Esta pequeña clave de respuestas te da algo concreto que comprobar después.
Por ejemplo, una tienda podría preguntar: «¿Cuándo puedo devolver un artículo rebajado?». Usa su política de devoluciones vigente como fuente de la respuesta. Si la política no cubre los artículos rebajados, la respuesta aceptable es decir que no puede confirmar la regla y dirigir al visitante a la tienda. El ejemplo es un patrón de prueba, no una afirmación sobre la política de ninguna tienda.
2. Crea el agente y añade fuentes
Crea una cuenta, abre el panel y elige Add AI agent. El asistente de configuración te guía por Link, Sources, Design y AI. Puedes darle la URL de tu sitio o añadir fuentes manualmente. En Sources, selecciona las pocas páginas que contienen tus respuestas aprobadas. Añade un archivo, un fragmento de texto o un par de pregunta y respuesta solo cuando aporte una respuesta que esas páginas no tienen. La guía de fuentes explica los tipos de fuente disponibles.
Revisa lo que incluyó el rastreador. Una URL de sitio no garantiza que todas las páginas sean utilizables, actuales o aprobadas. Evita añadir versiones de políticas duplicadas o contradictorias. Cuando cambie una política, actualiza la fuente afectada y vuelve a probar su pregunta. El reentrenamiento automático de pago actualiza las URL de sitio web ya indexadas; no descubre todas las páginas nuevas ni reemplaza los archivos subidos por ti. La guía de fuentes de sitio web explica ese límite.
3. Configura el diseño y las reglas de respuesta
En Design, define un nombre reconocible, un color y un mensaje de apertura. Dile a los visitantes qué puede responder el agente. En AI, elige entre los modelos que se ofrecen actualmente en tu cuenta y escribe instrucciones breves sobre alcance e incertidumbre. Los nombres de los modelos y el acceso por plan cambian, así que usa el selector de tu espacio de trabajo en lugar de una lista estática de un artículo.
Una instrucción útil es: «Responde preguntas sobre nuestra política de devoluciones publicada usando las fuentes proporcionadas. Si falta un detalle o las fuentes se contradicen, di que no puedes confirmarlo y dirige al visitante a [vía de soporte]». Sustituye el texto entre corchetes por una vía que tu equipo realmente supervise. Las instrucciones guían el comportamiento; no pueden convertir en cierto un material fuente que falta o se contradice.
Termina el asistente y abre el Playground. Haz tus tres preguntas y luego una pregunta de seguimiento que cambie un detalle importante. Compara cada respuesta con tu clave de respuestas escrita. Corrige la fuente o las instrucciones y repite la prueba si una respuesta es incorrecta. Si el agente ofrece captura de leads o una acción, prueba su destino real antes de activarlo para los visitantes; una promesa en la conversación por sí sola no es una transferencia completada.
4. Instala el código de widget generado
Abre la página Channels → Website embed del agente, selecciona Chat widget y activa el canal. Copia el código completo generado para tu agente. Contiene una etiqueta corta de arranque de la cola de comandos seguida de una etiqueta de carga asíncrona con tu ID de agente y la URL de widget configurada. Pega ambas etiquetas juntas en el campo de código del pie de página de tu sitio o en la plantilla HTML compartida, antes de </body>. Publica el sitio. No copies un ID ni una URL de script de un artículo de ejemplo.
Si quieres un panel de chat dentro de una sección de la página en lugar de una burbuja flotante, activa Iframe en la misma página Website embed y usa el código iframe que genera. Para la colocación en plataformas, sigue la guía vigente del widget JavaScript, React y Next.js, WordPress, Webflow o Framer. Añade el código del widget una vez por página renderizada.
5. Comprueba la página pública
Abre la URL publicada en una ventana nueva del navegador, también en un teléfono. Lleva este breve registro de aceptación:
| Comprobación | Resultado esperado | Si falla |
|---|---|---|
| Código fuente de la página | Las dos etiquetas de widget generadas aparecen una vez | Revisa el permiso de colocación de código del sitio, el paso de publicación y la caché. |
| El chat se abre | La burbuja se abre y acepta un mensaje | Comprueba que Chat widget esté activado y que el script cargue. |
| Pregunta conocida | La respuesta coincide con la fuente aprobada | Corrige la fuente o las instrucciones y vuelve a probar. |
| Pregunta desconocida | El agente evita inventar una política y ofrece la vía de contacto real | Añade una vía de escalado explícita y prueba de nuevo. |
| Transferencia a humano | El enlace de contacto, el formulario o la acción llega al destino previsto | Corrige el destino antes del lanzamiento. |
Si el widget aparece en el Playground pero no en el dominio público, revisa las restricciones de dominio además del código generado. Si la burbuja se abre pero no puede responder, revisa el procesamiento de fuentes y tu cuota de mensajes. Registra la URL de prueba, la pregunta, la respuesta observada y la fecha para poder repetir la misma comprobación tras actualizar una fuente.
Un lanzamiento sin código sigue necesitando responsabilidad sobre las fuentes y revisión de las respuestas. Empieza con un conjunto reducido de preguntas, publica e inspecciona conversaciones reales en busca de huecos. Si quieres probar este flujo de trabajo, crea una cuenta de Agentkit y prueba el widget publicado antes de dirigir visitantes a él.
