# Documentación Completa de ChatbotNeo

> **Plataforma de IA Conversacional para Captación de Leads y Soporte 24/7.**
> 
> Este archivo unifica toda la documentación técnica y guías de usuario de ChatbotNeo.
> Úsalo como contexto para entender cómo funciona la plataforma, cómo se integra (HTML/WordPress)
> y cómo se configura el entrenamiento (RAG) y los prompts del chatbot.

## URL Principal
https://chatbotneo.com

## Índice de Contenido
El contenido a continuación es una agregación de todas las páginas de documentación encontradas en https://chatbotneo.com/docs.
Cada sección representa una página o guía distinta separada por líneas dobles.

---



==================================================

# Documentación
URL: /docs

Manual oficial de ChatbotNeo. Aprende a integrar tu chatbot, entrenar a la IA con tus datos y analizar métricas de rendimiento.

# Bienvenido a ChatbotNeo

**La plataforma integral para automatizar la atención al cliente mediante Inteligencia Artificial.**

ChatbotNeo te permite crear asistentes virtuales que no solo responden, sino que *entienden* tu negocio. Utilizando tecnología RAG, transformamos tus manuales, webs y documentos en un agente experto disponible 24/7.

<Callout title="¿Tienes prisa?" type="tip">
  Pasa de cero a tener un bot funcionando en tu web en menos de 5 minutos con nuestra guía de **[Inicio Rápido](/docs/inicio-rapido)**.
</Callout>

---

## ¿Por dónde quieres empezar?

Selecciona la ruta que mejor se adapte a lo que buscas hoy:

### Primeros Pasos
Si es tu primera vez aquí, te recomendamos seguir este orden.

<Cards>
  <Card
    href="/docs/inicio-rapido"
    title="Inicio Rápido"
    icon={<Zap className="text-amber-500" />}
  >
    Crea tu cuenta, configura tu primer bot y elige el modo de despliegue.
  </Card>

  <Card
    href="/docs/integracion"
    title="Instalación Web"
    icon={<Code className="text-blue-500" />}
  >
    Guías paso a paso para insertar el widget en HTML, WordPress o Shopify.
  </Card>
</Cards>

### Domina la Plataforma
Profundiza en las capacidades avanzadas y la gestión diaria.

<Cards>
  <Card
    href="/docs/base-conocimiento"
    title="Entrena a tu IA"
    icon={<BookOpen className="text-purple-500" />}
  >
    Aprende a subir PDFs y scrapear webs para que el bot sepa qué responder.
  </Card>

  <Card
    href="/docs/analiticas"
    title="Analíticas y Leads"
    icon={<LayoutDashboard className="text-green-500" />}
  >
    Interpreta las métricas, revisa conversaciones y gestiona los contactos capturados.
  </Card>

  <Card
    href="/docs/planes"
    title="Planes y Límites"
    icon={<Coins className="text-gray-500" />}
  >
    Entiende las cuotas de mensajes, capacidades de almacenamiento y opciones Enterprise.
  </Card>

  <Card
    href="/docs/que-es-chatbotneo"
    title="Arquitectura"
    icon={<Bot className="text-pink-500" />}
  >
    Descubre cómo funciona la tecnología RAG y la seguridad de tus datos.
  </Card>
</Cards>

---

## ¿Qué hace único a ChatbotNeo?

A diferencia de los chats convencionales, nuestra plataforma está diseñada para la **autonomía**:

*   **Sin flujos complejos:** No necesitas diseñar árboles de decisión "Si/Entonces". La IA decide la mejor respuesta basándose en el contexto.
*   **Actualización en tiempo real:** Si cambias un precio en tu web, el bot lo aprende al instante (con la actualización automática).
*   **Híbrido:** Perfecto para soporte (resolver dudas) y ventas (capturar leads).

==================================================

# Analíticas y Leads
URL: /docs/analiticas

Interpreta las estadísticas de tu chatbot. Mide la satisfacción del usuario (CSAT), gestiona leads capturados y exporta datos a tu CRM.

ChatbotNeo no solo conversa, también **escucha y analiza**. El sistema procesa cada interacción para ofrecerte métricas de negocio y detectar oportunidades de venta sin que tengas que leer miles de chats manualmente.

## Dashboard Principal

Tu vista aérea del rendimiento. Aquí puedes ver la salud general de tu asistente en el periodo seleccionado (7 días, 30 días o 3 meses).

<ImageZoom src="/dashboard_general.png" alt="Panel principal de métricas y categorías frecuentes" />

### Métricas Clave (KPIs)
*   **Interacciones:** Número total de mensajes procesados.
*   **Captura de Leads:** Porcentaje de usuarios que terminan dejando sus datos de contacto (Tasa de Conversión).
*   **Satisfacción (CSAT):** Valoración media de 1 a 5 estrellas basada en el análisis de sentimiento de la IA.
*   **Usuarios Únicos:** Cantidad de personas distintas que han hablado con el bot.

### Insights Automáticos
La IA agrupa las conversaciones automáticamente para decirte de qué hablan tus usuarios:
*   **Top Categorías:** ¿Preguntan más por "Precios", "Soporte Técnico" o "Envíos"?
*   **Consultas Frecuentes:** Las preguntas exactas más repetidas. Ideal para mejorar tu documentación.

---

## Análisis de Conversaciones

En la pestaña **Conversaciones**, puedes auditar cada charla individualmente.

<ImageZoom src="/conversaciones.png" alt="Tabla de conversaciones con clasificación por IA" />

### Clasificación Inteligente
Olvídate de etiquetar chats a mano. ChatbotNeo analiza el contexto y asigna automáticamente:
1.  **Categoría:** El tema principal de la charla (ej: "Problemas con certificado SSL").
2.  **Valoración:** Una puntuación de estrellas (⭐⭐⭐⭐⭐) basada en si el usuario terminó la charla contento o frustrado.
3.  **Lead:** Un indicador (✅/❌) de si se capturaron datos.

### Acciones
*   **Ver Chat:** Abre la transcripción completa para leer qué se dijo.

---

## Gestión de Leads

Cuando el chatbot detecta una oportunidad de venta y consigue el contacto del usuario, la información aparece en la sección **Leads**.

<ImageZoom src="/vista_leads.png" alt="Tabla de gestión de leads capturados" />

### Datos Enriquecidos
Además del Nombre, Correo y Teléfono, la IA rellena campos extra para ayudarte a vender mejor:

*   **Motivo:** Un resumen generado por IA de *por qué* nos contactó (ej: "Interés en realizar prácticas" o "Solicitud de presupuesto web").
*   **Ubicación:** Ciudad y país aproximado del usuario.
*   **Info Adicional:** Cualquier otro dato relevante extraído de la charla.

### Acciones
*   **Ver Chat:** Abre la transcripción completa para leer qué se dijo.
*   **Ver Usuario:** Muestra el historial de todas las conversaciones que ha tenido esa misma persona en el pasado.
*   **Compartir:** Comparte la ficha del lead con tu equipo de ventas.

### Compartir y Exportar
Puedes enviar estos leads a tu equipo de ventas al instante pulsando el botón **Compartir** (<Share2 className="inline size-4"/>):

*   **📧 Email:** Reenvía la ficha del lead por correo.
*   **📱 WhatsApp:** Genera un mensaje directo para enviar por WhatsApp.
*   **📋 Copiar:** Copia los datos al portapapeles.
*   **📄 TXT:** Descarga la transcripción y los datos en un archivo de texto.

<Callout type="tip" title="Notificaciones en tiempo real">
  ¿Quieres recibir un aviso en tu correo cada vez que entre un lead nuevo? Configúralo en la sección de **[Personalización > Notificaciones](/docs/personalizacion#privacidad-y-notificaciones)**.
</Callout>

==================================================

# Gestión de Contenido
URL: /docs/base-conocimiento

Aprende a subir archivos PDF, Excel y realizar scraping web para crear la base de conocimiento de tu chatbot. Actualización automática de contenidos.

La sección **Gestión de Contenido** es el "cerebro" de tu chatbot. Aquí es donde alimentas a la IA con información de tu empresa para que pueda responder preguntas con precisión utilizando tecnología RAG (Retrieval-Augmented Generation).

<ImageZoom src="/gestion_contenido.png" alt="Vista general de la gestión de contenido" />

## Flujo de Trabajo

A diferencia de otras herramientas, ChatbotNeo tiene un sistema de seguridad de dos pasos: **Carga** y **Aplicación**. Esto te permite revisar qué información ha entendido el sistema antes de que el chatbot empiece a usarla.

<Steps>
<Step>
### Añadir Fuentes de Datos

Tienes dos formas principales de añadir información:

#### Opción A: Subir Archivos
Haz clic en **"Añadir Archivos"**.
*   **Formatos:** PDF, XLSX, XLS, CSV.
*   **Uso:** Ideal para información general de la empresa o catálogos de precios estáticos.

#### Opción B: Añadir URL (Web Scraping)
Haz clic en **"Añadir URL"** para que nuestro crawler lea tu sitio web.

<ImageZoom src="/modal_scrapping.png" alt="Modal de configuración de scraping web" />

Dispones de 3 modos de lectura:
1.  **Solo esta URL:** Lee únicamente la página específica que introduzcas (ej: `tuweb.com/precios`).
2.  **Recursivo (Mismo dominio):** Empieza en la URL dada y sigue todos los enlaces internos para leer toda la web.
3.  **Usar Sitemap:** Busca el archivo `sitemap.xml` para una indexación estructurada y completa.
</Step>

<Step>
### Estado Pendiente y Revisión

Una vez subido un archivo o procesada una web, aparecerá en la tabla con el estado <span className="text-yellow-600 bg-yellow-100 px-2 py-0.5 rounded text-xs font-bold">Pendiente</span>.

**¿Qué significa esto?**
El sistema ha extraído el texto, pero **el chatbot aún NO lo está usando**. Está en una "sala de espera" para que tú lo valides.

<ImageZoom src="/contenido_pendiente.png" alt="Fila de archivo en estado pendiente con acciones disponibles" />

En este estado tienes 3 acciones disponibles a la derecha:

*   <Eye className="inline size-4 mr-1 text-blue-500" /> **Visualizar (Ojo):** Te muestra el texto plano que el sistema ha logrado leer. Úsalo para confirmar que no hay caracteres raros o información basura.
*   <Play className="inline size-4 mr-1 text-green-500" /> **Aplicar (Play):** Confirma que el contenido es correcto. Al pulsarlo, el sistema vectoriza la información y se la enseña al chatbot.
*   <Trash2 className="inline size-4 mr-1 text-red-500" /> **Eliminar:** Borra el contenido si no es correcto.

<Callout type="warn" title="Importante">
  Tu chatbot **no sabrá nada** de los documentos subidos hasta que no pulses el botón de **Play** (▶️) y el estado cambie a "Completado".
</Callout>
</Step>

<Step>
### Finalización

Tras pulsar el botón de Play, verás un estado de "Procesando".

Cuando el estado cambie a <span className="text-green-600 bg-green-100 px-2 py-0.5 rounded text-xs font-bold">Completado</span>, el conocimiento ya está activo. Puedes ir al **Entorno de Pruebas** para hacer preguntas sobre este nuevo contenido.
</Step>
</Steps>

## Mantenimiento y Actualizaciones

Una vez que tus fuentes de datos están subidas, ChatbotNeo ofrece herramientas para mantenerlas al día sin tener que borrar y empezar de cero.

### Actualización Manual
Si haces un cambio puntual en una página de tu web (ej: cambias un precio), no hace falta que la borres.
1.  Busca la URL en la lista de contenido completado.
2.  Haz clic en el icono de **Reintentar / Actualizar** (<RotateCw className="inline size-4 text-blue-500" />).
3.  El sistema volverá a scrapear la URL y actualizará la información existente.

### Actualización Web Automática
Para webs vivas (blogs, e-commerce) que cambian frecuentemente, puedes activar el piloto automático.

En la parte superior derecha de la tabla, verás el interruptor: **Actualización Web Automática** <ToggleRight className="inline size-5 text-green-600" />.

*   **¿Qué hace?** El sistema revisará todas las URLs de tu lista **todos los lunes**.
*   **¿Cómo funciona?** Si detecta cambios en el texto de la web, actualizará la base de conocimiento del chatbot automáticamente sin que tú hagas nada.

---

## Preguntas Frecuentes

<Accordions type="single">
  <Accordion title="¿Cuánto tarda en procesar la información?">
    El tiempo varía según el tamaño. Archivos PDF pequeños y URLs individuales tardan apenas unos segundos. Si seleccionas el modo **Recursivo** en una web grande, puede tardar varios minutos en leer y vectorizar todas las páginas.
  </Accordion>

  <Accordion title="¿Qué pasa si mi web cambia de contenido?">
    Tienes dos opciones: pulsar el icono de **Actualizar (Reintentar)** manualmente en esa fila para traer los cambios al momento, o activar la **Actualización Automática** para que el sistema lo haga por ti cada lunes.
  </Accordion>

  <Accordion title="¿Puedo borrar contenido ya aplicado?">
    Sí. Si borras un archivo que tiene el estado "Completado" (usando el icono de la papelera), el chatbot **olvidará** esa información inmediatamente y dejará de usarla en sus respuestas.
  </Accordion>
</Accordions>

==================================================

# Guía: Cómo funciona la IA Generativa y RAG
URL: /docs/guia

Entiende la tecnología detrás de ChatbotNeo. Explicación de IA Generativa, arquitectura RAG y vectores semánticos para chatbots inteligentes.

**ChatbotNeo** es una capa de inteligencia artificial que se conecta a los datos de tu empresa para ofrecer atención al cliente automatizada, precisa y humana las 24 horas del día.

A diferencia de los chatbots antiguos basados en botones y flujos rígidos, ChatbotNeo utiliza **IA Generativa (LLMs)** y **RAG (Retrieval-Augmented Generation)** para entender el contexto y responder basándose únicamente en tu información.

## Pilares Fundamentales

<Cards>
  <Card title="Entrenamiento Personalizado" icon={<Cpu />}>
    No inventamos respuestas. El bot lee tus PDFs, Words y sitio web para convertirse en un experto en TU negocio.
  </Card>

  <Card title="Omnicanalidad" icon={<Globe />}>
    Entrena una vez, despliega en todas partes: Web, WhatsApp, Telegram y Messenger.
  </Card>

  <Card title="Interacción Natural" icon={<MessageSquare />}>
    Olvida los comandos exactos. Tus usuarios pueden hablarle como a una persona real.
  </Card>
</Cards>

## ¿Cómo funciona?

1.  **Ingesta:** Subes tus documentos o pegas la URL de tu web.
2.  **Indexación:** ChatbotNeo "lee" y fragmenta la información en vectores semánticos.
3.  **Consulta:** Cuando un usuario pregunta, el sistema busca el fragmento más relevante.
4.  **Generación:** La IA formula una respuesta usando esa información encontrada.

> "ChatbotNeo no es solo un chat; es tu mejor empleado de soporte, disponible 24/7 sin descanso."

==================================================

# Inicio Rápido
URL: /docs/inicio-rapido

Guía paso a paso para crear y configurar tu primer asistente virtual. Regístrate, elige modo producción y obtén tu script de instalación.

Sigue estos pasos para desplegar tu primer agente de IA en **ChatbotNeo**.

<Steps>
<Step>
### Registro y Verificación

Para comenzar, necesitas una cuenta activa en la plataforma.

1. Accede a la página de **[Registro de Usuario](https://chatbotneo.com/auth/register)**.
2. Introduce tus datos y crea tu cuenta.

<Callout type="warn" title="Verificación requerida">
  Recibirás un correo electrónico de confirmación inmediatamente. Es **necesario** que hagas clic en el enlace de ese correo para activar tu cuenta antes de iniciar sesión.
</Callout>
</Step>

<Step>
### Crear Nuevo Chatbot

Una vez dentro del panel de control (Dashboard), verás que tu lista de proyectos está vacía.

Haz clic en el botón negro **"Crear Chatbot"** situado en la barra lateral o en la zona principal del dashboard.
</Step>

<Step>
### Elegir el Modo de Despliegue

Aquí defines el propósito de tu asistente. Verás una pantalla de selección para determinar el funcionamiento del chatbot:

<ImageZoom src="/crear_chatbot_inicio_rapido.png" alt="Pantalla de selección de modo: Producción vs Test" />

*   **Modo Producción:** Visible para visitantes reales. Consume cuota.
*   **Modo Test:** Solo para pruebas internas en el dashboard. No consume cuota de producción.

<Callout type="info">
  Fíjate en el contador **"Disponibles"**. Esto indica cuántos chatbots tienes libres según tu **[plan actual](/docs/planes)**.
</Callout>
</Step>

<Step>
### Método de Creación

Ahora debes decidir si empezar desde cero o aprovechar trabajo previo:

<ImageZoom src="/crear-metodo.png" alt="Selección de método: Desde cero o clonar existente" />

*   **Crear desde Cero:** Configuración manual limpia. Ideal para tu primer bot.
*   **Desde Existente (Clonar):** Copia la configuración, prompt y **base de conocimiento** de otro chatbot que esté ya creado. Ideal para crear variantes (ej: probar un prompt nuevo sin romper el bot original).
</Step>

<Step>
### Configuración Inicial

En este paso definirás la identidad y el comportamiento base del asistente.

<ImageZoom src="/configuracion-chatbot.png" alt="Formulario de configuración del chatbot" />

Los campos varían ligeramente según el modo de chatbot elegido:

1.  **Nombre:** Identificador interno (ej: "Soporte Web").
2.  **URL del sitio web (Solo en Producción):**
    *   Introduce la URL donde vivirá el chatbot (ej: `https://miempresa.com`).
    *   **Seguridad:** El widget bloqueará peticiones que no vengan de este dominio.
    *   **Autogeneración:** Al pulsar "Validar URL", el sistema escaneará tu web y **generará automáticamente un Prompt del Sistema** adaptado a tu negocio para que lo utilices como plantilla.
3.  **Mensaje de bienvenida:** Lo primero que dirá el bot al abrirse el chat.
4.  **Prompt del Sistema:** Las instrucciones que seguirá de la IA. Si validaste la URL, ya tendrás un borrador listo para usar.
5.  **Color:** Adaptalo para que encaje con el color de tu web.

</Step>

<Step>
### ¡Éxito! Integración

Tu chatbot ha sido creado correctamente. Verás una pantalla de confirmación con el **Script de Instalación**.

<ImageZoom src="/exito-integracion.png" alt="Pantalla de éxito con el código de script visible" />

**¿Qué hago ahora?**
1.  Copia el código haciendo clic en el botón "Copiar" e instálalo en tu web.
2.  Verifica desde un navegador en incógnito que el chatbot aparece correctamente.
3.  Pulsa "Ir al Dashboard" para continuar.

<Callout type="tip" title="No te preocupes por el código">
  Si no puedes instalarlo ahora, no pasa nada. Siempre puedes recuperar este script más tarde en la lista de tus chatbots.
</Callout>

</Step>

<Step>
### Ajustes de Configuración

Para terminar de dejar el chatbot a punto, ve a la pestaña **Configuración** de tu nuevo bot. Aquí encontrarás opciones avanzadas para controlar cómo se comporta y se ve tu asistente:

#### Configuración General
*   **Instrucciones del asistente:** Es el "cerebro" del chatbot. Define aquí su personalidad, qué temas debe tratar y cuáles debe evitar.
*   **URL de Política de Privacidad:** Campo opcional para incluir un enlace a tus términos legales dentro del chat (recomendado para GDPR).
*   **Correos para Notificaciones:** Añade las direcciones de email donde quieres recibir una alerta cada vez que el chatbot capture un nuevo Lead (cliente potencial).

#### Apariencia y Comportamiento
*   **Logo del Chatbot:** Sube tu icono o logotipo corporativo para sustituir el avatar por defecto.
*   **Mensaje de bienvenida flotante:** Un "globo" de texto que aparece junto al icono cerrado para llamar la atención del usuario (ej: "Hola 👋, ¿Necesitas ayuda?").
*   **Posición del Chatbot:** Elige en qué esquina de la pantalla se anclará el widget.
*   **Tamaño del icono:** Ajusta el tamaño en píxeles del botón flotante para que no tape elementos importantes de tu web.

</Step>
</Steps>

## Siguientes Pasos

Ahora que tu chatbot luce bien y está instalado, es hora de hacerlo inteligente.

*   **[Entrenar a tu Chatbot](/docs/base-conocimiento)**: Sube tus documentos para que responda sobre tu negocio.
*   **[Analíticas](/docs/analiticas)**: Descubre qué preguntan tus usuarios.

==================================================

# Integración y Despliegue
URL: /docs/integracion

Tutoriales de instalación para todas las plataformas. Obtén tu script único y despliega tu asistente de IA en tu sitio web en segundos.

Una vez que has entrenado y personalizado tu asistente, el último paso es hacerlo visible para el mundo. ChatbotNeo utiliza un **script ligero y asíncrono** que se puede insertar en cualquier plataforma web moderna sin afectar la velocidad de carga.

## Obtener el Script de Instalación

Independientemente de la plataforma que uses (WordPress, Shopify, React, etc.), el primer paso es conseguir tu **identificador único**.

1.  Accede a tu **[Panel de Control](/dashboard)**.
2.  Ve a la sección **[Ver todos los chatbots](/dashboard/chatbots)** o entra en la configuración de tu bot actual.
3.  Haz clic en el botón **"Copiar código"** o el icono del portapapeles.

<ImageZoom src="/copiar_script.png" alt="Panel donde se copia el script del chatbot" />

<Callout type="info" title="Seguridad de Dominio">
  Recuerda que si creaste el chatbot en **Modo Producción**, el script solo funcionará en el dominio que especificaste (ej: `miempresa.com`). Si intentas usarlo en otra web, el chat no cargará por seguridad.
</Callout>

---

## Selecciona tu Plataforma

Elige la guía que mejor se adapte a la tecnología de tu sitio web:

<Cards>
  <Card
    href="/docs/integracion/wordpress"
    title="WordPress"
    icon={<LayoutTemplate />}
  >
    Instalación mediante plugin (WPCode) o editando el tema (footer.php).
  </Card>

  <Card
    href="/docs/integracion/shopify"
    title="Shopify"
    icon={<ShoppingBag />}
  >
    Integración en tiendas online modificando el archivo theme.liquid.
  </Card>

  <Card
    href="/docs/integracion/html"
    title="HTML / JavaScript / React"
    icon={<Code />}
  >
    Para sitios web a medida, Landing Pages estáticas o aplicaciones web (Next.js, Vue, PHP).
  </Card>
</Cards>

### ¿No encuentras tu plataforma?

Si usas otro CMS como **Wix, Squarespace, Webflow o Prestashop**, el proceso es casi idéntico al de **HTML estándar**:

1.  Busca en tu CMS la opción de **"Custom Code"** (Código personalizado) o **"Inject Code"**.
2.  Selecciona la ubicación **Footer** (o `Body - End`).
3.  Pega el script que copiaste en el paso 1.

==================================================

# HTML / JavaScript
URL: /docs/integracion/html

Guía para insertar el script del chatbot en cualquier sitio web HTML, PHP, Python o React. Código asíncrono optimizado.

La integración vía HTML es el método más universal. Funciona en cualquier sitio web, desde una landing page estática hasta aplicaciones a medida (PHP, Python, React, etc.).

## Obtén tu Código

Si no copiaste el código en el momento de crear el chatbot, puedes recuperarlo en cualquier momento:

1. Ve a tu **Dashboard** y en el desplegable de arriba a la izquierda selecciona **[Ver todos los chatbots](/dashboard/chatbots)**.
2. Busca el chatbot que quieres insertar.
3. Copia el bloque de código completo haciendo clic en el botón de copiar.

<ImageZoom src="/copiar_script.png" alt="Pantalla de éxito con el código de script visible" />

## Localiza el archivo correcto

Abre el código fuente de tu página web.
*   Si es una web simple: abre el `index.html`.
*   Si usas un framework o plantillas: busca el archivo que controle el pie de página (ej: `footer.php`, `layout.tsx`, etc.).

Debes buscar la etiqueta de cierre del cuerpo de la página: `</body>`.

## Pega el Script

Pega el código que has copiado del dashboard justo **encima** de esa etiqueta de cierre.

```html title="index.html"
<!DOCTYPE html>
<html lang="es">
<head>
    <title>Mi Web</title>
</head>
<body>
    <!-- Todo el contenido de tu web... -->
    <footer>...</footer>

    <!-- 👇 PEGA TU CÓDIGO AQUÍ 👇 -->
    <script 
        id="chatbotneo-embed-script"
        src="https://chatbotneo.com/widget.js?id=TU_ID_AQUI"
    ></script>
    <!-- 👆 FIN DEL CÓDIGO 👆 -->

</body>
</html>
```

<Callout type="info" title="Nota de Rendimiento">
  Colocar el script al final del `body` asegura que el contenido visual de tu web cargue primero. El widget es asíncrono, por lo que no ralentizará tu página.
</Callout>

## Verifica la Instalación

1. Guarda los cambios.
2. Abre tu página web en una nueva pestaña.
3. **Refresca la caché** (Ctrl + F5 en Windows o Cmd + Shift + R en Mac).
4. El chatbot debería aparecer en la posición que lo tengas configurado.

Si no aparece, asegúrate de que la URL de tu navegador coincide con la que pusiste en la configuración del chatbot (si elegiste el Modo Producción).

==================================================

# Chatbot para Shopify
URL: /docs/integracion/shopify

Aprende a instalar el widget de ChatbotNeo en tu tienda Shopify. Edita el archivo theme.liquid para añadir soporte y ventas con IA.

En Shopify, para que el chatbot aparezca en todas las páginas (Inicio, Productos, Carrito), debemos insertar el código en el archivo maestro de diseño llamado `theme.liquid`.

## Obtén tu Código

Si no copiaste el código en el momento de crear el chatbot, puedes recuperarlo en cualquier momento:

1. Ve a tu **Dashboard** y en el desplegable de arriba a la izquierda selecciona **[Ver todos los chatbots](/dashboard/chatbots)**.
2. Busca el chatbot que quieres insertar.
3. Copia el bloque de código completo haciendo clic en el botón de copiar.

<ImageZoom src="/copiar_script.png" alt="Pantalla de éxito con el código de script visible" />

---

## Accede al Editor de Código

1. Inicia sesión en tu panel de administración de Shopify.
2. En el menú izquierdo, ve a **Tienda online** (Online Store) → **Temas** (Themes).
3. Busca tu tema actual (el que dice "Tema actual").
4. Haz clic en los **tres puntos (`...`)** y selecciona **Editar código**.

---

## Modifica el archivo theme.liquid

Una vez en el editor, verás muchas carpetas a la izquierda. Sigue estos pasos con cuidado:

1. Abre la carpeta **Layout**.
2. Haz clic en el archivo `theme.liquid`.
3. Baja hasta el final del código. Debes buscar la etiqueta de cierre `</body>`.

### Pega el código

Inserta el script justo **antes** de `</body>` y asegúrate de no romper ninguna etiqueta `{% ... %}` existente.

```html title="layout/theme.liquid" {8-14}
  <!-- ... contenido previo del tema ... -->
  
  {% section 'footer' %}

  <!-- 👇 PEGA TU SCRIPT AQUÍ 👇 -->
  <script
    id="chatbotneo-embed-script"
    src="https://chatbotneo.com/widget/embed.min.js?chatbot_id=TU_ID_AQUI"
    async defer>
  </script>
  <!-- 👆 FIN DEL SCRIPT 👆 -->

</body>
</html>
```

4. Haz clic en **Guardar** (Save) en la esquina superior derecha.

<Callout type="warn" title="Precaución">
  El archivo `theme.liquid` controla el diseño de toda tu tienda. Ten cuidado de no borrar accidentalmente otras líneas de código ajenas al chatbot.
</Callout>

---

## Verifica la Tienda

1. Haz clic en el botón "Ver tienda" o abre tu web en una nueva pestaña.
2. Espera unos segundos. El chatbot debería aparecer.
3. Navega a un producto o al carrito para confirmar que el asistente te sigue durante la navegación.

**¿No aparece?**
En Shopify, a veces los cambios tardan 1-2 minutos en propagarse a la CDN. Si no lo ves al instante, espera un momento y recarga la página.

==================================================

# Chatbot para WordPress
URL: /docs/integracion/wordpress

Dos métodos para instalar ChatbotNeo en WordPress: Usando el plugin WPCode (recomendado) o editando el archivo footer.php de tu tema.

WordPress no permite pegar código JavaScript directamente en el editor de páginas estándar. Para integrarlo correctamente y que aparezca en **toda la web**, debes insertarlo en el "pie de página" (footer) de tu tema.

## Obtén tu Código

Si no copiaste el código en el momento de crear el chatbot, puedes recuperarlo en cualquier momento:

1. Ve a tu **Dashboard** y en el desplegable de arriba a la izquierda selecciona **[Ver todos los chatbots](/dashboard/chatbots)**.
2. Busca el chatbot que quieres insertar.
3. Copia el bloque de código completo haciendo clic en el botón de copiar.

<ImageZoom src="/copiar_script.png" alt="Pantalla de éxito con el código de script visible" />

---

## Método 1: Usando un Plugin (Recomendado)

Esta es la opción más segura. Si actualizas tu tema de WordPress, el chatbot seguirá funcionando.

### Paso A: Instalar el Plugin
1. En tu panel de administración, ve a **Plugins** → **Añadir nuevo**.
2. Busca: `WPCode` (o "Insert Headers and Footers").
3. Instala y Activa el plugin **"WPCode"**.

<ImageZoom src="/plugin_wordpress.png" alt="Búsqueda del plugin WPCode en WordPress" />

### Paso B: Pegar el Código
1. En el menú lateral izquierdo, busca **Code Snippets** → **Header & Footer**.
2. Baja hasta la sección llamada **Footer** (Pie de página).
3. Pega tu script en ese cuadro de texto.

```html title="Ajustes de WPCode -> Footer"
<!-- Otros scripts que ya tengas... -->

<!-- 👇 PEGA TU SCRIPT AQUÍ 👇 -->
<script
  id="chatbotneo-embed-script"
  src="https://chatbotneo.com/widget/embed.min.js?chatbot_id=TU_ID_AQUI"
  async defer>
</script>
```

4. Haz clic en **"Save Changes"** (Guardar cambios) arriba a la derecha.

---

## Método 2: Editor de Temas (Avanzado)

Este método no requiere plugins, pero es más arriesgado. Si escribes mal el código, podrías romper el diseño de tu web.

<Callout type="warn" title="Precaución">
  Si actualizas tu tema (ej: Astra, Divi, Elementor), perderás este cambio. Se recomienda hacer esto solo si usas un **Tema Hijo (Child Theme)** o si sabes exactamente lo que haces.
</Callout>

### Paso A: Abrir el Editor
1. Ve a **Apariencia** → **Editor de archivos de temas**.
2. A la derecha, busca el archivo `footer.php` (suele llamarse "Pie de página del tema").

### Paso B: Insertar Código
1. Busca la etiqueta de cierre `</body>` al final del archivo.
2. Pega tu script justo **antes** de esa línea y **después** de la función `wp_footer()`.

```php title="footer.php" {5-10}
   <?php wp_footer(); ?>

   <!-- 👇 INICIO SCRIPT CHATBOTNEO 👇 -->
   <script
     id="chatbotneo-embed-script"
     src="https://chatbotneo.com/widget/embed.min.js?chatbot_id=TU_ID_AQUI"
     async defer>
   </script>
   <!-- 👆 FIN SCRIPT CHATBOTNEO 👆 -->

</body> <!-- Etiqueta de cierre -->
</html>
```

3. Pulsa el botón **Actualizar archivo**.

---

## Verificación

Una vez guardado (por cualquiera de los dos métodos):

1.  Abre tu web en una **Ventana de Incógnito**.
2.  Deberías ver el icono del chatbot en la esquina inferior.
3.  Si usas plugins de caché (como WP Rocket o LiteSpeed), **vacía la caché** para que los cambios se reflejen al instante.

==================================================

# Personalización
URL: /docs/personalizacion

Aprende a personalizar la apariencia de tu chatbot web y configura el System Prompt para controlar el comportamiento y tono de la IA.

La sección de **Configuración** te permite adaptar ChatbotNeo para que se sienta como una extensión natural de tu empresa. Aquí controlas tanto lo que el usuario ve (diseño) como lo que la IA piensa (comportamiento).

## Configuración General

Aquí se definen los parámetros técnicos y lógicos del funcionamiento del bot.

### Campos Básicos

*   **Nombre del chatbot:** Es el identificador interno. También será el nombre que vean los usuarios en la cabecera del chat (ej: "Soporte Técnico" o "María de Ventas").
*   **URL del sitio web:**
    *   **Seguridad:** El widget solo cargará en este dominio exacto. Esto evita que alguien copie tu script y lo ponga en otra web para gastar tu cuota.
    *   **Contexto:** Ayuda a la IA a saber en qué entorno está operando.

---

### Instrucciones del Asistente (System Prompt)

Este es el campo **más importante** de toda la plataforma. Aquí defines el "ADN" de tu inteligencia artificial. Todo lo que escribas aquí son reglas que el bot seguirá a la hora de contestar.

#### ¿Cómo redactar un buen Prompt?

No te limites a decir "Eres útil". Sé específico. Una buena instrucción sigue esta estructura: **Rol + Objetivo + Tono + Restricciones**.

**Ejemplo de una instrucción potente:**

> "Eres Sofía, una experta en nutrición de la clínica [Nombre]. Tu tono es empático, profesional y motivador.
>
> **Tus objetivos son:**
> 1. Resolver dudas sobre nuestros tratamientos.
> 2. Intentar agendar una cita. Para ello, pide el correo electrónico del usuario antes de dar precios finales.
>
> **Restricciones:**
> - No inventes información médica. Si no lo sabes, di que consulten a un especialista y pide datos de contacto.

#### Consejos de Ingeniería de Prompts:
1.  **Captura de Leads:** Si quieres crees que no está pidiendo lead lo suficiente, díselo explícitamente: *"Tu prioridad es conseguir el lead del usuario ofreciéndole enviar un presupuesto detallado"*.
2.  **Seguridad:** Añade frases como *"Si te preguntan sobre tu tecnología, di simplemente que eres un asistente virtual de la empresa, no menciones modelos de IA externos"* o *"No hables de política o religión"*.
3.  **Formato:** Puedes pedirle cómo estructurar la respuesta: *"Usa listas con viñetas para enumerar productos"*.

---

### Privacidad y Notificaciones

*   **URL de Política de Privacidad:** Añade el enlace a tus términos legales (ej: `https://ejemplo.com/politica-privacidad`). Aparecerá un enlace discreto dentro del chat para cumplir con la GDPR/RGPD.
*   **Correos para Notificaciones:** Escribe aquí las direcciones de email de las personas que recibiran un correo cuando entre un lead con la informacion de contacto.
    *   Cada vez que el bot capture un **Lead** (consiga un email o teléfono), el sistema enviará un aviso inmediato a estas direcciones para que podáis contactar al cliente al instante.

<ImageZoom src="/correo_lead.png" alt="Formulario de configuración general y prompt del sistema" />

---

## Apariencia y Comportamiento

En este bloque defines la identidad visual para que coincida con tu marca.

### Identidad Visual

*   **Logo del Chatbot:** Sustituye el robot por defecto por el isotipo de tu empresa o la foto de una persona real para generar más confianza.
*   **Color Principal:** Selecciona el color hexadecimal (ej: `#FF5733`) de tu marca. Esto pintará el botón flotante, los enlaces y las burbujas de mensaje del usuario.

### Mensajes de Enganche (Hooks)

Diferencia entre los dos tipos de mensajes iniciales:

1.  **Mensaje de Bienvenida (Dentro del chat):**
    *   Es lo primero que dice el bot cuando el usuario **abre** la ventana.
    *   *Uso:* Saludar y orientar. *"¡Hola! Soy Neo. ¿En qué puedo ayudarte hoy?"*
2.  **Mensaje Flotante (Fuera del chat):**
    *   Es un globo de texto que aparece junto al icono cuando el chat está **cerrado**.
    *   *Uso:* Llamar la atención (Call to Action). *"👋 ¿Buscas un presupuesto?"*.
    *   *Nota:* Puedes activarlo o desactivarlo con el interruptor.

### Posición y Tamaño

*   **Posición:** Elige si quieres el chat a la derecha (estándar) o izquierda (útil si tienes botones de WhatsApp u otros elementos a la derecha).
*   **Tamaño del icono:** Ajusta el slider en píxeles (px).
    *   *Recomendación:* Entre **60px y 70px** es el estándar ideal para móvil y escritorio.

<Callout type="warn" title="Guardar Cambios">
  Ningún cambio se aplicará en tu web hasta que no hagas clic en el botón gris **"Guardar Cambios"** al final de la página. Si el bot ya está instalado, los cambios se reflejarán automáticamente al refrescar la página (puede tardar unos minutos por la caché).
</Callout>

==================================================

# Planes y Precios
URL: /docs/planes

Consulta nuestros precios flexibles. Empieza con el plan de Chatbot Gratis o escala con planes profesionales para empresas y PYMES.

ChatbotNeo ofrece tres niveles diseñados para acompañarte en cada etapa: desde la validación de tu idea hasta el despliegue corporativo a gran escala.

## Resumen de Planes

<Cards>
  <Card
    title="Gratuito"
    icon={<Zap className="text-amber-500" />}
  >
    **0€ / mes**

    Para probar la plataforma y validar el valor inicial.
  </Card>

  <Card
    title="Profesional (PYMES)"
    icon={<Building className="text-blue-500" />}
  >
    **64€ / mes** (Anual)

    **Más Popular.** Sin marca de agua, captura de leads y modelos avanzados.
  </Card>

  <Card
    title="Enterprise"
    icon={<Crown className="text-purple-500" />}
  >
    **A Medida**

    Para grandes organizaciones. Seguridad avanzada y soporte dedicado.
  </Card>
</Cards>

---

## Comparativa Detallada

| Característica | Gratuito | Profesional | Enterprise |
| :--- | :--- | :--- | :--- |
| **Precio** | **0€** | **64€**/mes* | **A medida** |
| **Chatbots Producción** | 1 (Básico) | 1 (Avanzado) | Ilimitados |
| **Entorno de Pruebas** | — | 3 Chatbots | Ilimitados |
| **Marca de Agua** | Visible | **Invisible** | Personalizada |
| **Captura de Leads** | — | Automática | Integrada CRM |
| **Base Conocimiento** | 5 MB | 200MB / 500 URLs | Ilimitada |
| **Analíticas** | Básicas | Detalladas + Insights | Integración BI |
| **Soporte** | Estándar | Prioritario | Gerente Cuenta |

<br />

<div className="text-sm text-muted-foreground border rounded-lg p-4 bg-fd-card flex gap-3 items-start" style={{ borderLeft: '4px solid #F3D044' }}>
  <Info className="size-5 shrink-0 mt-0.5" style={{ color: '#F3D044' }} />
  <div className="text-fd-foreground font-medium">
    ¿Necesitas más capacidad? Puedes añadir chatbots extra por <span className="font-bold" style={{ color: '#F3D044' }}>+15€/mes</span> cada uno.
  </div>
</div>

---

## Desglose por Nivel

### Plan Gratuito
Diseñado para desarrolladores o pequeños negocios que necesitan validar la herramienta.
*   **Volumen:** Uso ligero (ideal para probar integración).
*   **Integración:** Web básica.
*   **Limitación:** La marca del producto será visible en el chat.

### Plan Profesional
El estándar para **Startups y PYMES** en crecimiento.
*   **Sin Marca de Agua:** Tu chatbot parecerá desarrollado internamente (Marca Blanca).
*   **Leads:** Captura y visualización automática de clientes potenciales.
*   **IA Avanzada:** Acceso a modelos con mejor razonamiento y naturalidad.
*   **Capacidad Ampliada:** Permite bases de conocimiento más grandes y scraping de hasta 500 URLs.

### Plan Enterprise
Infraestructura robusta para casos de uso complejos.
*   **Seguridad:** SSO (Single Sign-On) y cumplimiento normativo.
*   **Consultoría:** Implementación personalizada y entrenamiento a medida.
*   **SLA:** Acuerdos de nivel de servicio garantizados.

<Callout title="¿Dudas con el plan Enterprise?" type="info">
  Ofrecemos despliegue en servidores propios (On-Premise) e integraciones complejas.
  [Contactar con Ventas](mailto:ventas@redflexion.com)
</Callout>

==================================================

# Qué es ChatbotNeo
URL: /docs/que-es-chatbotneo

Descubre cómo funciona ChatbotNeo. Tecnología RAG para atención al cliente 24/7, captura de leads automática y automatización con IA.

**ChatbotNeo** es una plataforma integral de inteligencia artificial diseñada para transformar la documentación estática de tu empresa (PDFs, Webs, Archivos) en conversaciones dinámicas y resolutivas.

Actúa como una capa de inteligencia entre tus datos y tus clientes, permitiendo ofrecer soporte **24/7**, capturar leads cualificados y reducir drásticamente el volumen de tickets de soporte repetitivos, todo ello con un lenguaje natural y humano.

---

## La Evolución del Chatbot

Para entender ChatbotNeo, primero hay que entender qué **NO** es.

| Chatbot Tradicional (Antiguo) | ChatbotNeo (IA Generativa) |
| :--- | :--- |
| ❌ Basado en botones y menús rígidos. | ✅ **Conversacional:** Entiende el lenguaje natural. |
| ❌ "Lo siento, no entiendo tu comando". | ✅ **Contextual:** Interpreta la intención del usuario. |
| ❌ Requiere programar cada respuesta manualmente. | ✅ **Autónomo:** Genera respuestas leyendo tus documentos. |
| ❌ Frustrante para el usuario. | ✅ **Fluido:** Como hablar con un empleado experto. |

---

## ¿Cómo funciona la tecnología?

ChatbotNeo utiliza una arquitectura avanzada conocida como **RAG (Retrieval-Augmented Generation)**. En lugar de inventarse respuestas, el sistema sigue un proceso para contestar a los usuarios con la información subida.

<Steps>
<Step>
### Ingesta y Fragmentación
Cuando subes un PDF o conectas tu web en la sección de [Gestión de Contenido](/docs/base-conocimiento), ChatbotNeo no solo "guarda" el archivo. Lo lee, lo limpia y lo divide en pequeños fragmentos de información digerible.
</Step>

<Step>
### Vectorización (Indexación Semántica)
Transformamos esos fragmentos en **vectores numéricos**. Esto permite que la IA entienda conceptos, no solo palabras clave.
*   *Ejemplo:* La IA sabe que "Coste", "Precio" y "Tarifa" están relacionados semánticamente, aunque la palabra exacta no aparezca.
</Step>

<Step>
### Recuperación Inteligente
Cuando un usuario hace una pregunta (ej: *"¿Tienen envíos a Canarias?"*), el sistema busca en tu base de datos únicamente los fragmentos más relevantes relacionados con "envíos" y "geografía".
</Step>

<Step>
### Generación de Respuesta
ChatbotNeo envía esos fragmentos encontrados a un **LLM (Modelo de Lenguaje)** avanzado con una instrucción clara.
</Step>
</Steps>

<Callout type="info" title="Seguridad de Datos">
  Este proceso garantiza que la IA **nunca** responderá con información que no esté en tus documentos.
</Callout>

---

## Tu Centro de Mando

ChatbotNeo no es una caja negra. Dispones de un panel de control completo para supervisar, medir y mejorar el rendimiento de tu asistente en tiempo real.

{/* Inicio de la Cuadrícula de 4 Imágenes */}
<div className="grid grid-cols-1 md:grid-cols-2 gap-4 my-8">
  <ImageZoom src="/dashboard_general.png" alt="Vista general con métricas clave" />
  <ImageZoom src="/vista_leads.png" alt="Tabla con leads capturados por el bot" />
  <ImageZoom src="/mapa_usuarios.png" alt="Mapa de los usuarios unicos" />
  <ImageZoom src="/conversaciones.png" alt="Vista de la tabla con las conversaciones" />
</div>
{/* Fin de la Cuadrícula */}

Desde este panel centralizado puedes gestionar:

*   <MessageSquare className="inline size-4 mr-1 text-blue-500"/> **Historial de Conversaciones:** Lee las charlas que tienen tus usuarios con el bot. Detecta qué preguntan más a menudo y verifica la calidad de las respuestas.
*   <Users className="inline size-4 mr-1 text-amber-500"/> **Gestión de Leads:** Visualiza y exporta los datos de contacto (emails, teléfonos, nombres) que el chatbot ha capturado automáticamente.
*   <LineChart className="inline size-4 mr-1 text-green-500"/> **Analíticas:** Métricas clave como número de usuarios únicos, total de conversaciones, mensajes intercambiados y tasas de conversión.
*   <Database className="inline size-4 mr-1 text-purple-500"/> **Contenido y Fuentes:** Sube, actualiza o elimina los documentos y webs que utiliza la IA para informarse.
*   <Settings2 className="inline size-4 mr-1 text-gray-500"/> **Personalización:** Modifica en cualquier momento el color del widget, el logotipo, el mensaje de bienvenida y, lo más importante, el **Prompt del Sistema**.

---

## Pilares Fundamentales

<Cards>
  <Card title="Entrenamiento a Medida" icon={<Database className="text-blue-500" />}>
    Tu chatbot es único. Se entrena exclusivamente con **tus datos**. Si actualizas un PDF o cambias el precio en tu web, el bot lo aprende al instante.
  </Card>

  <Card title="Captación de Leads" icon={<Zap className="text-amber-500" />}>
    No solo resuelve dudas, también vende. Configura el bot para pedir el correo electrónico o teléfono de manera natural durante la conversación.
  </Card>

  <Card title="Multidioma Nativo" icon={<Globe className="text-green-500" />}>
    Sube tu documentación en español y el bot será capaz de responder a un cliente en inglés, francés o alemán automáticamente.
  </Card>

  <Card title="Control Total" icon={<ShieldCheck className="text-purple-500" />}>
    Tú defines la personalidad (Prompt del Sistema) y revisas las fuentes. Tienes el control absoluto de qué dice y cómo lo dice.
  </Card>
</Cards>

## Casos de Uso Comunes

*   **Soporte al Cliente (Tier 1):** Automatiza el 80% de las preguntas frecuentes (horarios, devoluciones, precios) liberando a tu equipo humano para casos complejos.
*   **Asistente de Ventas:** Guía a los visitantes de tu web recomendando productos basados en su catálogo y capturando sus datos de contacto.
*   **Base de Conocimiento Interna:** Para uso exclusivo de empleados, ayudándoles a encontrar información en manuales técnicos o normativas de RRHH rápidamente.

> **"ChatbotNeo no sustituye a tu equipo, lo superpotencia."**

---

Generado el: 2025-12-24T10:00:55.712Z
Total de páginas incluidas: 12
Documentación © ChatbotNeo. Todos los derechos reservados.