Primeros pasos
En la próxima versión, las páginas incluidas se comparten entre los proyectos de un propietario; hasta el lanzamiento, el dashboard público puede seguir mostrando los límites anteriores por chatbot.
Construya un chatbot útil antes de incorporarlo a su sitio. La secuencia principal es crear → añadir contenido → revisar → probar → personalizar → integrar.
1. Cree una cuenta y un proyecto
Inicie sesión en el dashboard de ChattyBox, seleccione New Chatbot y asigne un nombre y, opcionalmente, una URL pública. El proyecto se abre en Content; crearlo no inicia un rastreo.
Consulte precios para conocer los límites actuales de proyectos, páginas y uso.
2. Configure la fuente de contenido
En Settings, guarde la Website URL en General Settings y, por separado, el modo, máximo de páginas y calendario en Scraping Configuration. Los filtros de inclusión/exclusión y la profundidad están disponibles mediante configuración como código, no en el dashboard.
Ejecute Scrape Now. ChattyBox obtiene HTML público y pone el contenido cambiado en cola para indexación; no renderiza JavaScript ni aplica robots.txt. El tiempo depende del descubrimiento, las páginas y los embeddings.
Use Añadir y actualizar contenido cuando necesite orientación sobre sitemaps, URL manuales, rastreo, contenido multilingüe o nuevos rastreos.
3. Revise el contenido indexado
Vuelva a Content y compare las páginas reales con las esperadas. Revise los avisos de contenido parcial y el trabajo de embeddings: un rastreo completado no prueba que se haya indexado todo.
4. Pruebe la calidad de las respuestas
Abra Test Chat y haga preguntas representativas que utilizarán los visitantes reales. Compruebe que las respuestas:
- utilicen la documentación indexada en lugar de suposiciones sin respaldo;
- enlacen a páginas de origen útiles;
- gestionen la información que falte con el respaldo previsto;
- funcionen con los idiomas y términos importantes.
Mejore el contenido o la selección y vuelva a rastrear cuando el enfriamiento lo permita (Free: semanal; pago: diario). Test Chat consume mensajes y contribuye a Logs, Analytics y Content Gaps. No lance solo porque el primer rastreo terminó.
5. Ajuste la experiencia
Use Persona para instrucciones complementarias; no sustituye la respuesta forzada cuando no hay contexto, que se configura por separado como assistant.fallbackMessage mediante configuración como código. En Embed, guarde título, bienvenida, colores, icono, posición e idioma del widget.
Estas decisiones se toman después de probar el contenido, para que la configuración visual no oculte problemas de recuperación o documentación.
6. Elija una integración
| Objetivo | Siguiente paso |
|---|---|
| Montar la interfaz gestionada de ChattyBox desde el código de la aplicación | SDK de JavaScript |
| Crear y mantener su propia interfaz | SDK headless de JavaScript |
| Permitir que un asistente de programación con IA integre el paquete npm | Integración asistida por IA |
| Gestionar la configuración del proyecto desde Git y CI | CLI y despliegue de configuración |
| Usar la interfaz gestionada sin npm ni un paso de compilación | Script del widget alojado |
| Añadir el widget gestionado a WordPress sin editar el tema | Plugin de WordPress |
| Añadir el widget gestionado a Drupal 10 u 11 con Composer | Módulo de Drupal |
Las integraciones para navegador necesitan una clave pública de API del widget. De forma predeterminada, las claves públicas funcionan en producción, en vistas previas, staging y localhost. Para reforzar opcionalmente la seguridad en profundidad, abra Public Keys > Edit origins, active Restrict this key to specific origins y añada cada origen de navegador permitido. Las restricciones de origen coinciden exactamente por esquema, nombre de host y puerto (por ejemplo, https://example.com y http://localhost:3000 son orígenes distintos). Vuelva a Embed para seleccionar la clave y copiar el fragmento generado y la URL de la API.
Las claves públicas del widget están diseñadas para aparecer en el código del navegador. Los tokens de despliegue de configuración y otras credenciales de administración son privadas y nunca deben añadirse a un sitio web.
7. Valide antes del lanzamiento
Instale primero la integración seleccionada en un sitio de vista previa o staging. Pruebe el origen desplegado, la navegación entre rutas, las citas, el comportamiento de respaldo, el diseño móvil y la consola del navegador antes de publicar ampliamente.
Complete la checklist de lanzamiento y use Logs en cualquier plan o Analytics y Content Gaps en Pro/Business.
Rutas, límites y bloqueo
Abra un proyecto en /chatbot/<projectId>: las pestañas usan ?tab=content, test, logs, analytics, gaps, prompts, keys, embed y settings. Analytics muestra hasta 5.000 interacciones de los últimos 30 días; no es una medida de exactitud ni un informe exclusivo de visitantes.
Config-as-code lock es irreversible: bloquea cambios de configuración y operaciones manuales de contenido, aunque algunos controles sigan visibles. Use el CLI; las claves públicas y la preferencia de branding permitida por el plan son excepciones. Los entornos de token no crean runtimes aislados.