Saltar al contenido principal

Primeros pasos

Las asignaciones documentadas de páginas incluidas se comparten entre los proyectos de un propietario. Consulte precios para las asignaciones de los planes y Cuenta y facturación en el dashboard para el uso actual y la asignación disponible de su cuenta.

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 Nuevo chatbot y asigne un nombre al proyecto y, de forma opcional, una URL del sitio web. Después de crearlo, el espacio de trabajo se abre en Conocimiento → Importar y actualizar. Si abre un proyecto sin una pestaña seleccionada, se muestra Resumen. Crear el proyecto no inicia una importación.

Consulte precios para conocer los límites actuales de proyectos, páginas y uso.

2. Configure la fuente de contenido​

En Conocimiento → Importar y actualizar, conecte el sitio web público, revise las páginas detectadas, ajuste la selección recomendada o una selección personalizada e inicie la importación o actualización de las páginas seleccionadas. Los cambios en los ajustes de la fuente se guardan automáticamente: compruebe el estado del guardado y resuelva los errores de validación o vuelva a intentarlo si falla el guardado antes de continuar. Los ajustes avanzados de la fuente también ofrecen una acción independiente Extraer ahora, que utiliza el modo de descubrimiento configurado. Las reglas de inclusión/exclusión y la profundidad de rastreo están disponibles mediante configuración como código, no en el dashboard.

ChattyBox extrae contenido HTML legible y pone en cola el contenido modificado para indexarlo. El descubrimiento y el guardado automático no inician la importación. No renderiza JavaScript ni aplica robots.txt; utilice páginas públicas cuya indexación esté autorizado a realizar y seleccione deliberadamente el alcance inicial. El tiempo necesario depende del descubrimiento, del número de páginas y del trabajo de indexación.

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​

Abra Conocimiento → Páginas y compare las páginas importadas con las fuentes esperadas. Abra el trabajo de importación para revisar los recuentos y los avisos de contenido parcial; compruebe también el trabajo de embeddings por separado antes de evaluar las respuestas. Una importación completada no garantiza que se haya indexado cada página solicitada ni cada sección. Consulte progreso e indexación parcial.

4. Pruebe la calidad de las respuestas​

Abra Probar chatbot 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 la fuente o la selección si las respuestas son débiles y actualice cuando lo permita el periodo de espera del plan: las actualizaciones gratuitas son como máximo semanales y las de pago, como máximo diarias. Probar chatbot consume la asignación de mensajes del propietario y guarda las conversaciones. Las interacciones de prueba pueden aparecer en Analítica y, si se detectan como preguntas sin responder, en Preguntas sin responder; la facturación y el registro de una laguna dependen del resultado. No instale el chatbot solo porque haya terminado la primera importación.

5. Ajuste la experiencia​

En Personalizar → Comportamiento, elija Asistente útil, Representante de ventas, Soporte técnico, Bot sarcástico o Persona personalizada y edite las instrucciones. Los cambios se guardan automáticamente; compruebe el estado del guardado antes de continuar. Al editar un preajuste, este pasa a ser una persona personalizada. Estas instrucciones complementan las reglas integradas de fundamentación y formato de ChattyBox; el contenido recuperado se añade automáticamente, así que no copie toda la base de conocimientos en el prompt. El texto de Persona no sustituye la respuesta de respaldo obligatoria cuando falta contexto o hay una laguna de contenido. El ajuste independiente assistant.fallbackMessage solo está disponible mediante configuración como código. Después de guardar, pruebe preguntas compatibles y el comportamiento de respaldo.

Si va a utilizar el widget alojado, abra Personalizar → Apariencia para previsualizar el título, el mensaje de bienvenida, los colores, el icono, la posición y el comportamiento del idioma. Estos cambios también se guardan automáticamente; compruebe el estado. El modo fijo y las anulaciones del script afectan al idioma de la interfaz del widget, no al idioma de las páginas indexadas. El título y el mensaje de bienvenida escritos por usted no se traducen automáticamente. Free incluye estilos, pero mantiene la marca de ChattyBox; Starter y los planes superiores permiten ocultarla.

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​

ObjetivoSiguiente paso
Montar la interfaz gestionada de ChattyBox desde el código de la aplicaciónSDK de JavaScript
Crear y mantener su propia interfazSDK headless de JavaScript
Permitir que un asistente de programación con IA integre el paquete npmIntegración asistida por IA
Gestionar la configuración del proyecto desde Git y CICLI y despliegue de configuración
Usar la interfaz gestionada sin npm ni un paso de compilaciónScript del widget alojado
Añadir el widget gestionado a WordPress sin editar el temaPlugin de WordPress
Añadir el widget gestionado a Drupal 10 u 11 con ComposerMódulo de Drupal

Las integraciones para navegador necesitan una clave pública de API del widget. En Instalar → Claves y dominios, revise los orígenes de la clave: una clave preparada para el dominio de un sitio web puede estar ya restringida a ese origen, mientras que las claves creadas sin restricciones funcionan en varios orígenes. En Editar orígenes puede activar restricciones opcionales y añadir los orígenes de producción, vista previa, staging y localhost que necesite. Si están activadas, la coincidencia es exacta por esquema, nombre de host y puerto (por ejemplo, https://example.com y http://localhost:3000 son distintos). En Instalación en el sitio web, seleccione la clave y copie el fragmento generado y la URL de la API. Las restricciones de origen son una protección adicional opcional, no un método de autenticación.

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.

Para recuperar el fragmento de una clave pública existente, introduzca una URL de sitio web HTTP(S) en Instalar → Instalación en el sitio web y seleccione la clave. El selector solo muestra claves no caducadas que no tienen restricciones o están permitidas para el origen de esa URL. Para seleccionar una clave restringida, introduzca un origen permitido; use Gestionar claves y dominios permitidos para consultar sus restricciones. Si el formulario no está disponible, complete primero el paso de configuración indicado en el dashboard. Para rotar una clave, cree otra, actualice y pruebe la instalación y, solo después, elimine la anterior. Al eliminarla, se detienen de inmediato las instalaciones que todavía la usan. Cada clave pertenece a un solo chatbot; llamarla «staging» o «producción» no crea entornos separados.

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 Conversaciones → Historial en cualquier plan. Conversaciones → Analítica y Conversaciones → Preguntas sin responder están disponibles en Pro y Business. Consulte analítica y preguntas sin responder.

Mapa del dashboard​

Abra un proyecto en /chatbot/<projectId>. Las pestañas usan el parámetro tab, no subpáginas independientes:

Vista del espacio de trabajoValor de tabPara qué sirve
ResumenoverviewRevisar el progreso de configuración y la actividad reciente
Conocimiento → Importar y actualizarsettingsDetectar, seleccionar, importar y actualizar páginas; ajustar la fuente
Conocimiento → PáginascontentRevisar páginas y trabajos de importación, eliminar contenido y reconstruir embeddings
Probar chatbottestHacer preguntas y volver a consultar conversaciones guardadas
Conversaciones → HistoriallogsLeer conversaciones guardadas y eliminar una o todas
Conversaciones → AnalíticaanalyticsConsultar las interacciones registradas de los últimos 30 días, con un máximo de 5.000; Pro/Business
Conversaciones → Preguntas sin respondergapsRevisar y resolver las preguntas detectadas sin respuesta; Pro/Business
Personalizar → ComportamientopromptsElegir o editar las instrucciones del asistente
Personalizar → AparienciaappearancePrevisualizar y ajustar la apariencia y el idioma del widget alojado
Instalar → Claves y dominioskeysCrear/eliminar claves públicas y editar restricciones de origen opcionales
Instalar → Instalación en el sitio webembedPreparar una instalación y copiar el fragmento de una clave
Configuración del chatbotmanageGestionar los datos del chatbot, los tokens de despliegue y el bloqueo de configuración, o eliminarlo

Todos los chatbots vuelve a /dashboard. El resumen de la cuenta está en /dashboard/overview; Cuenta y facturación, en /settings/account, incluye el perfil, el plan, el uso de mensajes, el portal de facturación y los controles PAYG. /settings y /settings/billing redirigen allí. /settings/keys ofrece un selector de proyecto para crear/eliminar claves públicas; las restricciones de origen opcionales se editan en el espacio del chatbot, en Instalar → Claves y dominios.

Permisos y bloqueo de configuración​

El acceso a un proyecto en el dashboard está reservado al propietario (o al usuario propietario de un espacio de trabajo antiguo). Una clave pública del widget no da acceso a los ajustes del proyecto ni al historial de conversaciones guardadas; pertenecer a una organización no concede por sí solo estos permisos.

Para gestionar el proyecto con Git/CI, Configuración del chatbot ofrece tokens de despliegue de configuración con ámbitos de desarrollo, vista previa o producción, caducidad opcional y revocación. El valor completo de un token solo se muestra al crearlo. La sección también muestra el historial de despliegues.

Activar el bloqueo de configuración es irreversible. Bloquea las escrituras de configuración del dashboard y las operaciones manuales de contenido, incluidas las ediciones de Persona y Extraer ahora, aunque algunos controles sigan visibles. En su lugar, despliegue la configuración mediante el flujo de CLI. La gestión de claves públicas, la limpieza de conversaciones y la preferencia de marca permitida por el plan no forman parte de los campos bloqueados. Los ámbitos de entorno de los tokens autorizan despliegues; no crean chatbots ni entornos de claves de navegador independientes.

La configuración como código también expone widget.enabled. Al establecerlo en false, se desactiva el chat público, incluido el SDK headless, no solo el widget flotante. El formulario actual de Apariencia no tiene un control equivalente para activarlo o desactivarlo.

Planes y límites​

PlanChatbotsPáginas de la cuentaMensajes al mes
Free110100
Starter31501.000
Pro105.00010.000
Business2525.00050.000

Los mensajes y las páginas almacenadas incluidas son asignaciones del propietario compartidas entre sus chatbots, incluido Probar chatbot. El trabajo mensual de actualización de páginas y los periodos de espera para actualizar son límites distintos; consulte los límites de actualización antes de una importación o reconstrucción grande. Consulte precios para conocer las asignaciones compartidas documentadas y Cuenta y facturación para ver el uso actual y la asignación disponible de su cuenta.

PAYG para mensajes, páginas y sitios es opcional en Pro/Business y está desactivado de forma predeterminada. En Cuenta y facturación, defina un límite mensual por función o elija explícitamente Sin tope de gasto. Un presupuesto de cero mantiene esa función con un límite estricto; sin límite de gasto se permiten cargos por uso sin tope. PAYG no desbloquea funciones en Free/Starter ni omite los periodos de espera del crawler. Allí puede editar el nombre del perfil; el correo electrónico se gestiona en los ajustes de cuenta del proveedor de inicio de sesión.