Chatbot Builder - Help

Chatbot Builder - Ayuda

Guía completa para crear chatbots de IA a partir de diversos documentos y fuentes web

📖

Descripción general

Chatbot Builder (Chatbotty.ai) es una plataforma optimizada con Redis Cache para crear chatbots de IA a partir de diversos documentos y fuentes web. Sirve a todos los que necesitan proporcionar respuestas de calidad a las consultas de los usuarios basándose en documentos y fuentes actuales - oficinas gubernamentales, organizaciones, empresas y particulares.

✨ Características principales

🤖 IA y procesamiento

  • • Chatbots de IA a partir de diversos documentos y fuentes web
  • • Enrutamiento inteligente de IA para calidad óptima de respuestas
  • • Base de datos vectorial para búsqueda semántica
  • • Fragmentación avanzada por tipo de documento

⚡ Rendimiento y fiabilidad

  • • Caché multinivel (Memoria → Redis → PostgreSQL)
  • • Widget asíncrono sin impacto en la velocidad de la página
  • • Protección contra abusos y ataques de bots
  • • Límites de velocidad flexibles para chatbots individuales

📊 Gestión y análisis

  • • Amplias opciones de personalización y configuración
  • • Reemplazo automático de documentos con nuevas versiones
  • • Análisis en tiempo real y optimización de calidad
  • • Gestión automática de suscripciones y niveles

🎯 Ideal para

  • Oficinas gubernamentales e instituciones públicas

    Automatización de servicios de información para ciudadanos, respuestas a preguntas frecuentes sobre trámites oficiales

  • Comercio electrónico y servicios en línea

    Soporte inteligente al cliente sin call center, gestión de pedidos y reclamaciones

  • Empresas con documentación extensa

    Búsqueda rápida en recursos internos, incorporación de nuevos empleados

  • Instituciones educativas

    Apoyo a estudiantes y respuestas a preguntas frecuentes, información sobre programas de estudio

  • Centros de salud

    Información para pacientes y soporte administrativo, guías para pacientes

  • Bufetes de abogados

    Acceso rápido a documentos legales y precedentes, análisis de casos jurídicos

  • Empresas de TI y tecnología

    Automatización del soporte técnico y documentación de API, resolución de problemas comunes

  • Empresas de consultoría

    Compartir experiencia y mejores prácticas, base de conocimiento interna

  • Agencias de marketing

    Análisis de necesidades del cliente y optimización de contenido, asistencia con briefs creativos

🚀

Primeros pasos

🎯 Guía rápida

  1. 1
    Registro e inicio de sesión

    Cree su cuenta. Automáticamente obtiene el nivel Evaluation durante 14 días con 3.000 mensajes/mes (más que los 500 de Elite) más todas las funciones Elite.

  2. 2
    Creación de su primer chatbot

    Haga clic en "Nuevo Chatbot" → introduzca nombre y descripción → elija el estilo de respuesta (formal/amigable/profesional). Después de la creación, será redirigido a la configuración detallada donde puede personalizar todos los parámetros del chatbot según sus necesidades.

  3. 3
    Carga de documentos

    Arrastre y suelte archivos PDF/DOCX/TXT/MD o introduzca la URL de una página web. Puede elegir el tipo de documento para una estrategia de fragmentación óptima (legal, técnico, académico, noticias, general).

  4. 4
    Pruebas e integración

    Pruebe el chatbot en modo de vista previa → copie el código de integración → insértelo en su sitio web

⚡ Consejos rápidos para empezar

📄 Preparación de documentos

  • Estructura: Use encabezados claros, viñetas y numeración
  • Formato: PDF con texto legible (no imágenes escaneadas)
  • Tamaño: El tamaño del archivo afecta la velocidad de procesamiento
  • Contenido: Elimine duplicados y partes irrelevantes
  • Idioma: Terminología y estilo consistentes
  • Metadatos: Nombres de archivo claros para mejor organización
  • Actualidad: Use las versiones más recientes de los documentos

🎨 Integración del widget

Integración sencilla mediante código JavaScript:

<script 
  src="https://chatbotty.ai/chatbot-embed.js"
  data-chatbot-id="xxxxxxxx">
</script>
  • • Carga asíncrona sin bloqueo de página
  • • Soporte multidominio
🤖

Gestión de chatbots

➕ Creación de chatbots

🎯 Configuración básica

Información básica:

  • Nombre del chatbot: Identificación de su chatbot
  • Descripción: Breve descripción del propósito del chatbot
  • Estilo de respuesta: Formal / Amigable / Profesional / Informal

🎨 Apariencia

Personalización de la apariencia del widget del chatbot:

  • Color del tema: Selección de colores predefinidos
  • Mensaje de bienvenida: Texto para el primer contacto con el usuario
  • Mensaje de error: Texto mostrado cuando el chatbot no está disponible
  • Dominios permitidos para integración: Especifique dónde se puede usar el widget

💎 Número máximo de chatbots por plan

Free

1 chatbot

Evaluation

1 chatbot

14 días de prueba

Basic

1 chatbot

Elite

2 chatbots

Enterprise

3 chatbots

🗑️ Confirmación de eliminación

⚠️

Proceso de eliminación seguro

Al eliminar un chatbot, aparece un diálogo de confirmación para evitar la eliminación accidental. Esto garantiza que no pierda datos importantes por error.

⚠️ Advertencia:

Todos los datos del chatbot, documentos y análisis se eliminarán permanentemente y no se pueden recuperar.

🔧

Configuración avanzada del chatbot

🧠 Comportamiento de IA y prompts

📝 Instrucciones del sistema

Defina la personalidad y el comportamiento del asistente de IA. Contiene directrices para:

  • • Estilo de comunicación y tono de respuesta
  • • Comportamiento general y reglas
  • • Instrucciones críticas para limitaciones
🏷️ Marcadores disponibles

Los siguientes marcadores se pueden usar en los prompts de instrucciones y mensajes:

  • {current_datetime} - Fecha y hora actual
  • {chatbot_id} - Identificador único del chatbot
  • {fallback_message} - Mensaje de respaldo personalizado cuando no se encuentra respuesta

⚡ Calidad de búsqueda y respuesta

🔍 Parámetros de búsqueda

  • Umbral de similitud (0.4): Coincidencia mínima para usar el documento
  • Número de fragmentos de documento en contexto (5): Cuántos fragmentos de documento recibe la IA
  • Enrutamiento inteligente de modelo: Selecciona automáticamente un mejor modelo según la complejidad de la consulta
  • Tickets de soporte automáticos: Cuando la IA no puede responder, ofrece crear un ticket de soporte. Requiere consentimiento del usuario y email.
  • Forzar respuesta de respaldo: Cuando está activado, siempre muestra el mensaje de respaldo para consultas con baja relevancia de documentos. Cuando está desactivado, la IA responderá incluso sin documentos relevantes (modo conversacional).

⚙️ Preferencias de idioma y parámetros de IA

  • Idioma de respuesta del chatbot: Idioma en el que responderá el chatbot
  • Zona horaria: Para respuestas sobre fecha y hora actual
  • Creatividad (Temperatura): 0.0 = preciso, 1.0 = respuestas creativas
  • Longitud máxima de respuesta (tokens): Límite en tokens (≈ 375 palabras para 500 tokens)

🛡️ Protección antispam

  • Máx. solicitudes/día: Número máximo de solicitudes desde una dirección IP en 24 horas (protección anti-bot)
  • Máx. solicitudes/sesión: Número máximo de solicitudes por sesión (ventana de 2 horas para prevención de abusos)
  • Límite de velocidad por minuto: Protección contra consultas de spam
  • TTL de caché (segundos): Cuánto tiempo almacenar las respuestas en caché

🔄 Restablecer valores predeterminados

🔄

Restaurar configuración predeterminada

El botón 'Restablecer valores predeterminados' restaura toda la configuración avanzada a sus valores predeterminados. Aparece un diálogo de confirmación antes de restablecer para evitar cambios accidentales.

ℹ️ Nota:

Siempre puede restablecer su configuración a los valores predeterminados si desea empezar de nuevo o si algo no funciona como se esperaba.

📄

Gestión de documentos

📤 Carga de archivos

📋 Fuentes compatibles

📄

Archivos

PDF, DOCX, TXT, MD, HTML

Elite+
🌐

URL web

Extracción automática

🔄

Actualizaciones

Reemplazo automático de versiones

🎯 Preparación óptima de documentos

✅ Prácticas recomendadas:

  • • Encabezados y estructura claros
  • • PDF con texto legible (no imágenes)
  • • Formato consistente
  • • Numeración lógica de secciones

❌ Evitar:

  • • Imágenes escaneadas sin OCR
  • • Fragmentación excesiva del texto
  • • Formato inconsistente
  • • Archivos mayores de 10MB

💾 Límites de almacenamiento por plan

Free

10MB total

Evaluation

20MB total

Basic

10MB total

Elite

20MB total

Enterprise

50MB total

📋 Detección de duplicados

📋

Gestión inteligente de duplicados

Al cargar un documento con el mismo nombre que uno existente, aparece un diálogo de confirmación con opciones para evitar sobrescrituras accidentales.

Opciones disponibles:

  • Reemplazar: Sobrescribe el documento existente con la nueva versión
  • Conservar ambos: Mantiene ambas versiones (el nuevo archivo recibe un sufijo numérico)

📄 Proceso de carga de documentos

1

Seleccionar chatbot

Elija el chatbot al que se asignará el documento

2

Seleccionar método de carga

📎 Archivos (PDF, DOCX, TXT, MD)

Máximo 10 MB por archivo

Elite+

🌐 URL web

Extracción automática de páginas web

3

Seleccionar tipo de documento

El sistema optimiza automáticamente el procesamiento por tipo:

⚖️

Documento legal:

Leyes, regulaciones, contratos

🔧

Manual técnico:

Guías, especificaciones, procedimientos

📰

Noticias:

Artículos, comunicados de prensa

🎓

Texto académico:

Artículos científicos, estudios

📄

Documento general:

Configuración universal

4

Describir documento (opcional)

Añade una descripción para facilitar la navegación futura en la lista de documentos

💡

Consejo para actualizar archivos

Al introducir el mismo nombre de documento, tienes la opción de reemplazar automáticamente la versión original sin tener que eliminar el documento obsoleto. Tus datos se mantendrán actualizados.

💬

Widget de chat

🔧 Integración web (mostrar el chatbot en tu sitio web)

📋 Obtener código de integración

Puedes encontrar el código de integración de cada chatbot en el menú contextual (tres puntos). Haz clic en "Copiar código de integración" y pégalo en tu sitio web antes de la etiqueta de cierre </body>.

<script 
  src="https://chatbotty.ai/chatbot-embed.js"
  data-chatbot-id="xxxxxxxx">
</script>

💡 Consejo: El widget se carga de forma asíncrona y no afecta la velocidad de tu página. La burbuja de chat aparece una vez que la configuración se ha cargado en segundo plano.

🔴 Nota: Si el chatbot está desactivado, el widget no aparecerá en el sitio web en absoluto.

⚠️ Instalación vía GTM: Si integras el widget a través de Google Tag Manager y un visitante rechaza las cookies, GTM no se cargará y el chatbot no aparecerá. Recomendamos integrar el código directamente en HTML, fuera de GTM.

⚙️ Configuración del widget

Puedes personalizar completamente el widget en la sección "Apariencia" al editar el chatbot. Todas las configuraciones se aplican automáticamente al código de integración.

🎨 Apariencia y posición:

  • Color del tema: 6 colores predefinidos (azul, rojo, verde, amarillo, morado, naranja)
  • Posición del widget: Abajo a la derecha / Abajo a la izquierda
  • Mensaje de bienvenida: Saludo al usuario
  • Mensaje alternativo: Texto para casos en que el chatbot no sabe la respuesta a una pregunta

⚙️ Comportamiento del chatbot:

  • Nombre del chatbot: Se muestra en el encabezado
  • Descripción: Breve descripción del propósito del chatbot (no se muestra en la web)
  • Estilo de respuesta: Profesional, amigable, formal
  • Estado: Chatbot activo/inactivo

🎯 Personalización del widget

Opciones de posición:

  • • Abajo a la derecha (predeterminado)
  • • Abajo a la izquierda

Efectos de burbuja:

  • Efecto de pulso - Burbuja animada para atraer la atención (se puede activar/desactivar)

👁️ Vista previa del widget

Usa la vista previa del widget para probar tu chatbot antes de integrarlo:

  • • Haz clic en el botón "Vista previa" en la configuración del chatbot
  • • Se abre el widget en una ventana modal
  • • Prueba todas las funciones y la apariencia
  • • No requiere instalación de código

🔗 Página pública del widget

Accede a tu widget en: /widget-embed/[widgetId]

  • • Página independiente para pruebas
  • • Se puede compartir con miembros del equipo
  • • No requiere integración en sitio web

💡 Consejo: Todos los cambios se aplican inmediatamente en todos los sitios web con el widget integrado. No es necesario cambiar el código.

⚡ Optimización de rendimiento

🚀 Carga asíncrona

  • • Carga asíncrona en segundo plano
  • • La burbuja aparece cuando la configuración está lista
  • • Cero impacto en la velocidad de la página principal
  • • Mejora progresiva

💾 Caché inteligente

  • 90%+ tasa de aciertos de caché
  • • Validez de configuración de 5 minutos
  • • Carga rápida vía Redis
  • • Funcionamiento fluido incluso durante caída de Redis Cache

🔒 Seguridad y restricciones

🌐 Restricciones de dominio

Limita el acceso solo a dominios permitidos:

Ejemplo de configuración:

  • • example.com
  • • *.example.com (incluyendo subdominios)

🛡️ Protección anti-spam

Configuración de límites de solicitudes para protección contra spam y abuso

Máx. solicitudes/día

50

Número máximo de solicitudes desde una dirección IP por 24 horas (protección anti-bot)

Máx. solicitudes/sesión

20

Número máximo de solicitudes por sesión (ventana de 2 horas para prevención de abuso)

Límite solicitudes/min

10

🛡️ Protección contra consultas spam

TTL de caché (segundos)

300

⚡ Tiempo de almacenamiento en caché de las respuestas

📝 Nota:

Estos parámetros son completamente configurables por el usuario en la configuración avanzada de cada chatbot para máxima flexibilidad.

📊

Análisis

🎯 Acceso por plan

🆓 Free

Sin acceso

Ventana emergente de actualización con instrucciones

⭐ Evaluation

Acceso completo

14 días de funciones nivel Elite

🔵 Basic

Métricas básicas

  • • Conteo de mensajes
  • • Consultas principales
  • • Estadísticas del chatbot

👑 Elite+

Análisis detallado

  • • Tasa de éxito
  • • Exportación de datos
  • • Informes detallados
  • • Interfaz interactiva
  • • Análisis para cada chatbot por separado

🤖 Análisis detallado del chatbotElite+

📋 Visualización por chatbot

  • Vista individual: Análisis separado para cada chatbot
  • Filtrado de consultas: Muestra solo conversaciones relevantes
  • Métricas aisladas: Rendimiento de chatbots individuales separado
  • Comparación de chatbots: Posibilidad de comparar el rendimiento de diferentes bots

🔍 Visualización detallada de consultas

  • Consulta completa: Visualización de toda la pregunta del usuario
  • Fiabilidad de respuesta: Valor exacto de puntuación de confianza
  • Respuesta IA: Texto completo de la respuesta del chatbot
  • Marca temporal: Fecha y hora de cada consulta

💡 Uso práctico: Permite un análisis preciso de cómo los chatbots individuales responden a las consultas de los usuarios, identificación de áreas problemáticas y optimización de documentos para cada chatbot por separado.

📈 Métricas disponibles

🎯 KPIs principales

📊
Total de consultas
Número de todos los mensajes por período
Tasa de éxito
Porcentaje de respuestas completas
⚠️
Respuestas parciales
Porcentaje de respuestas parciales
📈
Fiabilidad promedio
Puntuación de similitud de documentos

📊 Calidad de respuestas

✅ RespondidaXX%
Respuesta completa encontrada
⚠️ ParcialXX%
Respuesta parcial
❌ Sin respuestaXX%
Respuesta no encontrada

⚠️ Limitaciones del historial de datos por plan

Se retienen los datos correspondientes al número máximo de consultas por mes según tu plan. Los datos más antiguos se eliminan automáticamente para optimizar el rendimiento de la base de datos.

  • Free: 200 consultas
  • Basic: 3000 consultas
  • Elite: 6000 consultas
  • Enterprise: 10000 consultas

📤 Exportación e informes

📋 Disponibilidad: La funcionalidad de exportación está disponible solo para planes Elite+ (Elite y Enterprise).

💡 Consejo: Recomendamos exportar los datos el último día de cada mes para hacer seguimiento del historial completo de consultas de clientes.

💾 Formatos de exportación

  • CSV: Datos tabulares para Excel
  • JSON: Datos estructurados para API

🔍 Filtros de datos

🕐 Filtros temporales:

  • Esta semana: Últimos 7 días
  • Este mes: Mes actual
  • Este año: Año actual

📋 Filtros por respuesta:

  • Todas las consultas: Historial completo
  • ✓ Respondidas: Respuestas exitosas
  • ⚠ Parcialmente respondidas: Respuestas incompletas
  • ✗ Sin respuesta: Sin respuesta
💎

Suscripción

🎯 Resumen de planes

Current

Free

Perfect for getting started

$0/month

10MB storage

1 chatbot

100 requests/month

Basic support

✅ Conversation history

❌ Basic analytics

❌ Web URL scraping

❌ Analytics export

❌ API access

❌ Support tickets

❌ Webhook actions

❌ White-label branding

➕ Buy extra requests

Trial

Evaluation

14-day trial with Enterprise features

$0/month

10MB storage

1 chatbot

500 requests/month

✅ Conversation history

✅ Detailed analytics

✅ Web URL scraping

✅ Analytics export

✅ API access

✅ Support tickets (AI)

✅ Webhook actions (n8n)

❌ White-label branding

➕ Buy extra requests

Auto-downgrade to Free

Basic

For growing businesses

$15/month

25MB storage

1 chatbot

3000 requests/month (total)

Priority support

✅ Conversation history

✅ Basic analytics

❌ Web URL scraping

❌ Analytics export

❌ API access

❌ Support tickets

❌ Webhook actions

❌ White-label branding

➕ Buy extra requests

Popular

Elite

Most popular

$30/month

50MB storage

2 chatbots (max)

6000 requests/month (total)

Priority support

✅ Conversation history

✅ Detailed analytics

✅ Web URL scraping

✅ Analytics export

✅ API access

❌ Support tickets

❌ Webhook actions

❌ White-label branding

➕ Buy extra requests

Enterprise

Custom solutions

$50/month

100MB storage

3 chatbots (max)

10000 requests/month (total)

Premium support

✅ Conversation history

✅ Detailed analytics

✅ Web URL scraping

✅ Analytics export

✅ API access

✅ Support tickets (AI)

✅ Webhook actions (n8n)

✅ White-label branding

➕ Buy extra requests

💡 Uso de datos

10MB de datos corresponden a aproximadamente 1000 páginas de documento PDF. En formatos puramente textuales, incluso mucho más.

Advertencia: El tamaño original del archivo subido cuenta para los límites de datos. Las imágenes incrustadas en documentos pueden aumentar significativamente el tamaño del archivo.

💰 Suscripción anual

¡Ahorra 2 meses con facturación anual – paga solo 10 meses!

La facturación anual ofrece ahorros significativos en comparación con los pagos mensuales. Puedes cambiar tu período de facturación o suscripción en cualquier momento.

⏰ Expiración del período de prueba

  • • Degradación automática al plan Free después de 14 días
  • • Transición sin interrupciones y sin pérdida de datos

📊 Seguimiento de uso

📊 Seguimiento en el panel

Controla el uso de tu plan directamente en tiempo real:

📈 Límites mensuales
  • • Número de mensajes por mes
  • • Previsión hasta fin de mes
  • • Reinicio automático cada mes
📋 Límites permanentes
  • • Capacidad de almacenamiento (MB/MB)
  • • Número de chatbots (cantidad/límite)
📊 Estadísticas
  • • Total de chatbots creados
  • • Chatbots activos y funcionales
  • • Total de consultas de usuarios
  • • Documentos subidos
📈 Visualización
  • • Barras de progreso con colores
  • • Seguimiento en tiempo real

⚠️ Aplicación de límites

  • Almacenamiento excedido: Subida bloqueada con solicitud de actualización
  • Límite de chatbots: Creación bloqueada, se muestra diálogo de actualización
  • Mensajes mensuales: El widget no se cargará (fallo silencioso)
  • Acceso a análisis: Restricciones de funciones por plan

💰 Extra Messages Add-ons

Extra messages are additional message packages you can purchase to extend your monthly quota. Unlike monthly subscriptions, extra messages never expire and persist across billing cycles.

🔄 How it works:

  1. Your monthly quota is consumed first
  2. When monthly quota is exhausted, extra messages are automatically used
  3. Extra messages persist until fully consumed (no expiration)
  4. Visible on dashboard with real-time tracking

📦 Available Packages:

💡 When to buy:

  • Seasonal traffic spikes
  • Special campaigns
  • Testing before upgrade
  • One-time high usage

💳 Purchase:Click "Buy Extra Messages" on dashboard or in usage tracking card when approaching limit.

📄

Facturas

📋 Resumen

Todas tus facturas e historial de pagos están disponibles directamente en el portal del cliente. Allí puedes encontrar suscripciones, compras de complementos y todos los pagos anteriores.

🔗 Cómo acceder

  1. Ve a Suscripción en la barra lateral del panel
  2. Haz clic en el botón Gestionar suscripción
  3. Serás redirigido al portal del cliente donde puedes ver todas las facturas y el historial de pagos
⚙️

Configuración

👤 Gestión de cuenta de usuario

📝 Cambiar nombre

Información personal

  • Nombre: Nombre de usuario mostrado
  • • Se puede cambiar en cualquier momento
  • • Se muestra en el perfil y comunicaciones

📧 Cambiar correo electrónico

Después de enviar la nueva dirección, se envían enlaces de confirmación a ambos correos, el actual y el nuevo. El cambio se hace efectivo solo después de hacer clic en ambos enlaces.

  • • Revisa tu bandeja de entrada actual y confirma desde allí
  • • Revisa tu nueva bandeja de entrada y confirma desde allí
  • • Solo después de ambas confirmaciones se activará el nuevo correo

🔒 Cambiar contraseña

La contraseña debe tener al menos 6 caracteres

Requisitos de contraseña:

  • • Mínimo 6 caracteres
  • • Combinación de letras y números
  • • Se requiere la contraseña actual

Contraseña olvidada:

  • • Restablecimiento por correo electrónico
  • • Enlace de restablecimiento seguro
  • • Entrega inmediata

🌐 Configuración de idioma

Cambia entre la interfaz en inglés y checo

  • • Haz clic en el selector de idioma en la navegación superior
  • • Idiomas disponibles: English (EN) / Czech (CS)
  • Recarga automática de página - La página se recarga automáticamente después del cambio de idioma para aplicar todas las traducciones
  • • La preferencia de idioma se guarda en tu cuenta

⚠️ Zona de peligro

Las acciones en esta sección son irreversibles. Procede con precaución.

⚠️ Eliminar tu cuenta eliminará permanentemente todos tus datos, chatbots, documentos y conversaciones. Esta operación es irreversible.

El botón "Eliminar cuenta" activará la eliminación completa de todos los datos de la base de datos.

🔗

API

🚀 Acceso programático a chatbots

💎 Disponible para planes superiores

El acceso API está disponible para usuarios con planes de suscripción Evaluation, Elite y Enterprise. Te permite integrar tus chatbots en aplicaciones, sitios web o sistemas personalizados.

📋 Lo que obtienes

  • REST API: Solicitudes HTTP estándar
  • Ejemplos de código: JavaScript, Python, PHP, Node.js
  • ID del chatbot: Identificador único para cada chatbot
  • Documentación completa: Disponible directamente en la aplicación

💡 Cómo empezar: Después de iniciar sesión en la aplicación, encontrarás la sección "Integración API" en el menú, donde puedes acceder a instrucciones detalladas incluyendo ejemplos de conexión para varios lenguajes de programación y muestras de prueba.

🔐 Autenticación API

Cómo funciona

El acceso API utiliza autenticación con token Bearer. Cada clave API está vinculada a un chatbot específico.

  1. Crea una clave API en Panel → Integración API para tu chatbot
  2. Incluye la clave API en el encabezado Authorization como token Bearer
  3. Envía una solicitud POST al endpoint /api/chat
  4. El chatbot se identifica automáticamente desde la clave API

Importante: NO necesitas enviar chatbot_id en el cuerpo de la solicitud. El chatbot se determina a partir de tu clave API.

🔑 Gestión de claves API

Crear claves API

Genera claves API seguras para acceso programático a tus chatbots.

Características:

  • Nombres personalizados - Etiqueta las claves para fácil identificación
  • Máximo 50 claves - Límite por chatbot
  • Tokens seguros - El token completo se muestra solo una vez al crearlo
  • Seguimiento de actividad - Marca temporal del último uso
  • Activar/desactivar - Desactivación temporal sin eliminación

Seguridad:

  • • Los tokens están enmascarados en la interfaz (muestran solo los primeros/últimos caracteres)
  • • Copiar al portapapeles para uso fácil
  • • Elimina las claves comprometidas inmediatamente

⚡ Cuota mensual: El uso de la API cuenta contra tu límite mensual de mensajes. Se pueden comprar mensajes adicionales cuando se excede la cuota.

💻 Ejemplos de código

JavaScript (Browser)

// 1. first request – no conversation_id needed
const response = await fetch('https://chatbotty.ai/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'What is your return policy?'
    // conversation_id not required – created automatically
  })
})

const result = await response.json()
const conversationId = result.data.conversation_id // save for follow-up requests

// 2. follow-up request – previous messages loaded as context
const response2 = await fetch('https://chatbotty.ai/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'What about exchanges?',
    conversation_id: conversationId
  })
})

Node.js

const response = await fetch('https://chatbotty.ai/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'What is your return policy?',
    conversation_id: conversationId // optional: to continue a conversation
  })
})

const result = await response.json()
console.log(result.data.message)
// result.data.conversation_id – save for follow-up requests

Python

import requests

response = requests.post(
    'https://chatbotty.ai/api/chat',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'message': 'What is your return policy?',
        'conversation_id': conversation_id  # optional: to continue a conversation
    }
)

result = response.json()
print(result['data']['message'])

PHP

<?php
$ch = curl_init('https://chatbotty.ai/api/chat');

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'message' => 'What is your return policy?',
    'conversation_id' => $conversationId // optional: to continue a conversation
]));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo $result['data']['message'];
?>

cURL

curl -X POST https://chatbotty.ai/api/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "What is your return policy?"}'

📋 Formato de respuesta

Respuesta exitosa

{
  "success": true,
  "data": {
    "message": "AI response text...",
    "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
    "sources": [
      {
        "content": "Relevant document excerpt...",
        "similarity": 0.95,
        "page": 1
      }
    ],
    "metadata": {
      "tokensUsed": 150,
      "cached": false,
      "responseTime": 1234,
      "searchResults": 3
    }
  },
  "timestamp": "2025-01-28T10:00:00.000Z"
}

Respuesta de error

{
  "success": false,
  "error": "Internal server error",
  "timestamp": "2025-01-28T10:00:00.000Z"
}

⚠️ Notas importantes

  • Las claves API son específicas del chatbot - Cada clave funciona con un solo chatbot
  • Hasta 50 claves por chatbot - Crea múltiples claves para diferentes aplicaciones
  • Las claves se pueden desactivar - Desactivación temporal sin eliminación
  • Se aplica la cuota mensual - Limitada por los mensajes/mes de tu plan de suscripción + mensajes adicionales comprados
  • Sin límite de tasa por minuto - La API está diseñada para acceso programático sin límites de tasa
  • Sin validación de dominio - La API funciona desde cualquier origen (usar con precaución)
  • Contexto de conversación - Cada respuesta devuelve un conversation_id. Pásalo en solicitudes posteriores para mantener el contexto — el sistema carga los últimos 20 mensajes automáticamente. Sin conversation_id, cada solicitud inicia una conversación nueva sin contexto — esto es perfectamente válido si no necesitas memoria conversacional (p.ej. consultas de datos puntuales).
  • Protege tus claves - Nunca expongas las claves API en código del lado del cliente
💬

Conversaciones

📝 Cómo funciona

La función de Historial de conversaciones registra automáticamente todas las sesiones del chatbot con metadatos completos para análisis, cumplimiento y control de calidad.

  • Registro de sesiones: Cada conversación se registra con un ID de sesión único
  • Seguimiento de metadatos: Dirección IP, URL de página, referencia, agente de usuario
  • Marcas temporales: Tiempo preciso para cada intercambio de mensajes
  • Información de contacto: Correo y nombre proporcionados por el usuario cuando están disponibles

🔍 Ver conversaciones

Accede al historial de conversaciones desde Panel → Conversaciones en el menú principal.

Filtros disponibles:

  • Período: Filtrar por período de tiempo (este mes, últimos 7 días, etc.)
  • Filtro (Chatbot): Mostrar conversaciones de un chatbot específico o todos
  • Fuente: Filtrar por fuente (widget, API, etc.)

Columnas mostradas:

  • • ID de sesión, Fecha/Hora, Nombre del chatbot
  • • Conteo de mensajes, Fuente, Correo de contacto
  • • Dirección IP (anonimizada), URL de página

📋 Detalles de conversación

Haz clic en cualquier conversación para ver el historial completo de mensajes con información detallada.

  • Línea de tiempo de mensajes: Todas las preguntas de usuarios y respuestas de IA
  • Datos de tiempo: Marcas temporales exactas para cada mensaje
  • Metadatos de origen: URL de página, referencia, agente de usuario
  • Información de contacto: Correo y nombre si el usuario los proporcionó

💡 Consejo: Usa el historial de conversaciones para identificar preguntas frecuentes y mejorar la base de conocimientos de tu chatbot. Los patrones en las consultas de usuarios pueden ayudarte a añadir documentación faltante.

🎫

Tickets de soporte

👑

Función Enterprise

Los tickets de soporte con IA están disponibles solo para usuarios del plan Enterprise.

🤖 Cómo funciona

El sistema de tickets de soporte con IA detecta automáticamente cuando el chatbot no puede responder la pregunta de un usuario y ofrece crear un ticket de soporte para seguimiento humano.

  • Detección inteligente: La IA reconoce cuando no puede proporcionar una respuesta satisfactoria
  • Consentimiento del usuario: El sistema pregunta al usuario si desea crear un ticket
  • Recopilación de correo: Recoge el correo electrónico del usuario para seguimiento
  • Resumen de IA: Genera un resumen de la conversación para el equipo de soporte

📝 Flujo de creación de tickets

El flujo de conversación de múltiples turnos para la creación de tickets:

  1. Activación: La IA detecta una pregunta sin respuesta o el usuario expresa frustración
  2. Oferta: "¿Te gustaría que creara un ticket de soporte?"
  3. Consentimiento: El usuario confirma que desea continuar
  4. Correo: "Por favor proporciona tu dirección de correo electrónico para seguimiento"
  5. Resumen: La IA genera un resumen de la conversación automáticamente
  6. Confirmación: Ticket creado con número de referencia

📋 Gestión de tickets

Accede y gestiona los tickets de soporte desde Panel → Tickets de soporte.

Flujo de estados:

  • Abierto: Nuevo ticket esperando revisión
  • En progreso: El equipo de soporte está trabajando en el problema
  • Resuelto: Problema atendido, esperando confirmación
  • Cerrado: Ticket completado y archivado

Acciones disponibles:

  • • Ver el contexto completo de la conversación
  • • Actualizar estado del ticket
  • • Añadir notas internas
  • • Enviar respuesta por correo al usuario

⚙️ Configuración

Activa y configura los tickets de soporte en Configuración del chatbot → pestaña Tickets de soporte.

  • Activar/Desactivar: Activa la creación de tickets para este chatbot
  • Notificaciones por correo: Recibe alertas de nuevos tickets
  • Respuesta automática: Mensaje personalizado enviado al usuario después de crear el ticket
  • Activadores: Configura cuándo se ofrecen los tickets

💡 Consejo: Revisa los tickets regularmente para identificar vacíos en tu base de conocimientos. Los temas comunes de tickets indican áreas donde deberías añadir más documentación.

🔗

Acciones webhook

👑

Función Enterprise y Evaluation

Las acciones webhook están disponibles para usuarios Enterprise (hasta 10 webhooks, hasta 10 herramientas en total entre todos los webhooks) y Evaluation (hasta 5 webhooks, hasta 5 herramientas en total entre todos los webhooks).

🔗 Resumen

Las acciones webhook permiten que tu chatbot interactúe con sistemas externos a través de llamadas a herramientas activadas por IA. Define webhooks personalizados con herramientas específicas que la IA puede invocar durante las conversaciones.

  • Webhooks personalizados: Define endpoints con autenticación
  • Herramientas IA: Especifica herramientas que la IA puede llamar (p.ej., get_order_status)
  • Parámetros: Define parámetros obligatorios y opcionales para cada herramienta
  • Manejo de respuestas: La IA procesa las respuestas del webhook de forma natural

⚙️ Configuración de webhooks

Configura webhooks en Panel → Webhooks para cada chatbot.

  1. Crear webhook: Introduce nombre, URL y encabezados de autenticación opcionales
  2. Definir herramientas: Añade herramientas que la IA puede llamar (p.ej., get_order_status, check_inventory)
  3. Establecer parámetros: Define parámetros obligatorios (p.ej., order_id, product_sku)
  4. Probar: Usa la función de prueba para verificar que tu webhook funciona correctamente
  5. Activar: Habilita el webhook para uso en producción

🔄 Integración con n8n

n8n es una potente herramienta de automatización de flujos de trabajo que funciona perfectamente con nuestro sistema de webhooks.

Configuración rápida:

  1. Crea un nuevo flujo de trabajo en n8n
  2. Añade un nodo trigger Webhook (método POST)
  3. Copia la URL del webhook a la configuración de webhook de tu chatbot
  4. Construye tu lógica de flujo de trabajo (llamadas API, consultas de base de datos, etc.)
  5. Devuelve una respuesta JSON que la IA procesará

Formato de respuesta de ejemplo:{"status": "shipped", "tracking": "1Z999AA1", "eta": "2024-01-15"}

💡 Ejemplos de casos de uso

📦 Consulta de estado de pedido

El cliente pregunta "¿Dónde está mi pedido?" → La IA llama a get_order_status con el número de pedido → Devuelve información de seguimiento

👤 Integración CRM

El usuario proporciona correo → La IA llama a lookup_customer → Devuelve detalles de cuenta y actividad reciente

📅 Reserva de citas

El usuario solicita cita → La IA llama a check_availability y luego book_appointment → Confirma la reserva

🔍 Verificación de inventario

El cliente pregunta sobre disponibilidad del producto → La IA llama a check_stock → Devuelve inventario actual

🔒 Seguridad

  • HTTPS requerido: Todos los endpoints de webhook deben usar HTTPS
  • Encabezados personalizados: Añade tokens de autenticación en los encabezados
  • Manejo de timeout: Timeout de 30 segundos previene solicitudes colgadas
  • Protección SSRF: Las direcciones IP privadas están bloqueadas por seguridad
  • Limitación de tasa: Protección integrada contra llamadas excesivas

⚠️ Importante: Nunca expongas claves API sensibles en las URLs de webhook. Usa encabezados de autenticación en su lugar.

💡 Consejo: Comienza con operaciones simples de solo lectura (como consulta de pedidos) antes de implementar operaciones de escritura. Prueba a fondo usando el probador de webhooks integrado antes de activar en producción.

💡

Consejos y trucos para la preparación de documentos e implementación exitosa del chatbot

📄 Preparación de documentos

📋 Estructuración de contenido

  • División temática: Un archivo = un tema
  • Estructura lógica: Secciones y encabezados claros
  • Actualizaciones fáciles: Cambia solo las partes relevantes
  • Claridad: Orientación rápida del contenido

📝 Formato y nomenclatura

  • Formatos de texto: TXT, DOC, DOCX (sin imágenes)
  • Nombres claros: Nombres de archivo descriptivos
  • Auto-actualización: Mismo nombre = reemplazo
  • Sin preocupaciones: La versión anterior se elimina automáticamente

💡 Consejo: Prepara los documentos con antelación en formato de texto plano. Las imágenes y el formato complejo pueden empeorar la calidad de las respuestas del chatbot.

🎯 Búsqueda semántica

🔍 Cómo el chatbot encuentra respuestas

  • Coincidencia semántica: Busca significado similar, no texto exacto
  • Palabras clave: Identifica términos importantes en la consulta
  • Contexto: Considera el significado completo de la oración
  • Similitud: Compara con la información existente

✍️ Formulación óptima

  • Respuestas directas: "X tiene Y años" en lugar de "X celebró Y años"
  • Varias formulaciones: Usa diferentes formas de expresión
  • Preguntas esperadas: Piensa en las posibles consultas de los usuarios
  • Palabras clave: Incluye sinónimos y variantes

❌ Menos adecuado:

"Big Ben celebró su 165 aniversario"

✅ Mejor:

"Big Ben tiene 165 años"

Por qué:La segunda versión responde mejor a preguntas como "¿Cuántos años tiene Big Ben?" o "¿Qué edad tiene Big Ben?"

📊 Optimización basada en análisis

🔍 Análisis de brechas

  • Consultas sin respuesta: Rastrea preguntas frecuentes sin respuestas
  • Baja fiabilidad: Identifica consultas con baja confianza
  • Problemas recurrentes: Encuentra patrones en consultas fallidas
  • Frustraciones de usuarios: Observa puntos donde los usuarios se "atascan"

🎯 Mejoras dirigidas

  • Ampliación de documentos: Añade información faltante
  • Reformulación: Aclara pasajes confusos
  • Nuevas formulaciones: Añade diferentes formas de expresión
  • Probar e iterar: Prueba cambios y mide mejoras
💯 Interpretación de fiabilidad

< 30%

Respuesta fallida

30-40%

Parcialmente respondida

> 40%

Respuesta exitosa

💡 Consejo: Prueba tus modificaciones directamente en el chatbot. Haz las mismas preguntas de nuevo y monitorea los cambios de fiabilidad. El objetivo es alcanzar consistentemente más del 40% de fiabilidad.

¿Por qué valores tan bajos? Para 100% de fiabilidad, la consulta tendría que identificarse exactamente con la misma redacción en el documento, lo cual ocurre muy raramente. Por lo tanto, los valores realistas son más bajos.

❓ Optimización de FAQ

📈 Análisis de consultas más frecuentes

  • Seguir tendencias: Identifica preguntas recurrentes
  • Priorización: Enfócate en las consultas más frecuentes
  • Patrones: Busca formulaciones similares de la misma pregunta
  • Problemas: Encuentra consultas con baja fiabilidad

📝 Creación de documento FAQ

  • Un párrafo = P&R: Pregunta y respuesta juntas
  • Lenguaje natural: Usa formulaciones comunes
  • Respuestas completas: Toda la información necesaria de una vez
  • Varias variantes: Incluye sinónimos y alternativas
✨ Ejemplo de FAQ optimizada

¿Cuánto tarda el procesamiento de la solicitud de pasaporte?El procesamiento de la solicitud de pasaporte tarda un estándar de 6-8 semanas desde la presentación de una solicitud completa. Para necesidades de viaje urgentes, el procesamiento acelerado está disponible en 2-3 semanas por una tarifa adicional de $60. Puedes recoger tu pasaporte en persona en el centro de solicitudes o recibirlo por correo en tu dirección.

🚀 Resultado: El documento FAQ aumenta drásticamente la fiabilidad de las respuestas a las consultas más frecuentes. Satisfarás el 80-90% de las preguntas de los usuarios con alta precisión.

📊 Análisis a largo plazo

🔍 Monitoreo regular

  • Revisión semanal: Rastrea respuestas fallidas
  • Resumen mensual: Analiza tendencias y cambios
  • Respuestas parciales: Identifica áreas de mejora
  • Patrones de problemas: Encuentra deficiencias recurrentes

📤 Exportación de análisisElite+

  • Formato CSV: Para MS Excel y Numbers
  • Datos detallados: Todas las consultas y respuestas
  • Fiabilidad: Nivel de confianza para cada consulta
  • Marca temporal: Seguimiento de tendencias en el tiempo
📈 Flujo de trabajo recomendado

1. Exportación semanal

Descarga datos de la última semana

2. Análisis en Excel

Filtrar por fiabilidad < 40%

3. Actualizaciones

Modificar documentos según los hallazgos

💡 Para usuarios avanzados: Usa tablas dinámicas de Excel para agrupar consultas similares e identificar las áreas problemáticas más comunes.

🌐 Uso de fuentes web

🔗 Extracción de URL webElite+

  • Importación directa: Carga contenido de sitios web
  • Secciones FAQ: Ideal para Preguntas Frecuentes existentes
  • Documentación: Usa documentación ya preparada
  • Contenido actual: Siempre la versión más reciente de la información

✅ Beneficios de la extracción web

  • Ahorro de tiempo: Sin reescritura manual
  • Consistencia de datos: Sin diferencias entre sitio web y chatbot
  • Actualizaciones automáticas: Solo recarga la URL
  • Contenido estructurado: El formato se preserva
📋 Fuentes ideales para extracción

✅ Páginas adecuadas:

  • • Secciones FAQ
  • • Documentación de productos
  • • Guías y procedimientos
  • • Información de contacto

❌ Menos adecuadas:

  • • Páginas con muchas imágenes
  • • Menús de navegación
  • • Contenido publicitario
  • • Contenido generado por JavaScript

💡 Consejo: Si tienes FAQ o documentación de calidad en tu sitio web, usa la extracción de URL en lugar de la reescritura manual. Esto evita inconsistencias y ahorra tiempo durante las actualizaciones.

💡 Consejos para obtener el máximo valor

Obtén mejores respuestas de tu chatbot y aprovecha al máximo tu cuota mensual de mensajes con estos consejos:

📄 Calidad de documentos:
  • • Elimina contenido innecesario antes de subir — documentos más limpios = respuestas más precisas
  • • Usa documentos bien estructurados con encabezados y secciones claros
  • • Evita información duplicada entre documentos
❓ Fomenta buenas preguntas:
  • • Las preguntas específicas y enfocadas obtienen mejores respuestas que las vagas
  • • Los documentos bien preparados conducen a respuestas más rápidas y precisas
📊 Monitorea tu uso:
  • • Rastrea tu cuota de mensajes en los análisis del panel
  • • Para picos de tráfico estacionales, usa complementos de mensajes adicionales en lugar de actualizar tu plan
  • • Revisa las tendencias mensuales para decidir si tu plan actual se ajusta a tus necesidades
🔧

Solución de problemas

⚠️ Problemas comunes

🤖 El chatbot no responde

Posibles causas:

  • • Límite mensual de mensajes excedido
  • • Dominio bloqueado por restricciones
  • • Limitación de tasa activada
  • • Error de carga del widget

Solución:

  • • Verifica el uso en el panel
  • • Comprueba los dominios permitidos
  • • Herramientas de desarrollador del navegador → pestaña Red
  • • Contacta soporte con detalles del error

📄 El documento no se procesa

Problemas comunes:

  • • Archivo más grande que el límite del plan
  • • Formato no soportado
  • • PDF corrupto o protegido con contraseña
  • • Sobrecarga de cola de procesamiento

Diagnóstico:

  • • Verifica tamaño del archivo vs límite del plan
  • • Intenta seleccionar texto en el PDF
  • • Estado de procesamiento en documentos
  • • Reintenta la subida si está atascada

🌐 El widget no se carga

Problemas de carga:

  • • Bloqueo por política CORS
  • • Timeout de carga del script
  • • CSP (Política de Seguridad de Contenido)
  • • Interferencia de bloqueadores de anuncios

Pasos de solución:

  • • Mensajes de error en la consola del navegador
  • • Prueba en otro navegador/incógnito
  • • Desactiva temporalmente los bloqueadores de anuncios
  • • Verifica la configuración de dominios permitidos

🆘 Contacto de soporte

📧 Soporte por correo

support@chatbotty.ai

  • Planes prioritarios: en 24h (excepcionalmente hasta 48h)
  • Planes gratuitos: generalmente en 72h
  • • Adjuntos: Capturas de pantalla, registros bienvenidos

🔍 Qué incluir

  • • Tipo y versión del navegador
  • • Mensaje de error o captura de pantalla
  • • ID del chatbot y URL del widget
  • • Pasos de reproducción
  • • Errores de consola (F12)