DokBot

Primeros pasos

Introducción

DokBot convierte tus documentos (PDF, DOCX, XLSX, MD, TXT) en un chatbot con IA que podés instalar en cualquier sitio web en minutos.

Usa Retrieval-Augmented Generation (RAG): cada respuesta se basa en el contenido que subiste, así que el bot nunca inventa información que no le diste.

Si el bot no puede responder con confianza, captura el email del visitante y te deriva la conversación en lugar de adivinar.

Inicio rápido

Tené un bot funcionando en tu sitio en cuatro pasos:

  • Creá una base de conocimiento y subí tus documentos — PDF, DOCX, XLSX/XLS, MD o TXT, hasta 10MB por archivo — o pegá una URL para importar una página web en su lugar.
  • Creá un bot, asignale la o las bases de conocimiento, elegí un proveedor y modelo, y definí el tono en el system prompt.
  • Probalo en vivo en el Playground hasta que las respuestas sean precisas y después publicalo — mientras esté en Borrador, el widget no responde en sitios externos, así podés iterar sin riesgo.
  • Abrí la pestaña Instalar, copiá la línea de script y pegala antes de cerrar la etiqueta </body> de tu sitio.

Conceptos clave

Bases de conocimiento

Una base de conocimiento es un conjunto de documentos que DokBot procesa y divide en pequeños fragmentos de texto para la búsqueda.

Formatos soportados: PDF, DOCX, XLSX/XLS, MD y TXT, hasta 10MB por archivo. También podés pegar la URL de una página web en lugar de subir un archivo — DokBot la descarga y extrae el contenido automáticamente, sin IA de por medio en ninguno de los dos casos.

Cada documento pasa por un proceso corto que podés seguir en su estado — Pendiente, Procesando, Listo, o Error si algo falla — y una vez listo podés ver cuántos fragmentos generó.

Un bot puede tener una o varias bases de conocimiento asignadas, y una misma base se puede reutilizar en varios bots.

Cómo funciona la búsqueda RAG

Cuando un visitante hace una pregunta, DokBot busca en tu base de conocimiento los fragmentos más relevantes y se los pasa al modelo de IA como contexto.

Al modelo se le indica que responda solo con base en ese contexto, lo que evita respuestas inventadas.

BYOK vs. Créditos IA

BYOK ("Bring Your Own Key") significa que conectás tu propia API key de un proveedor como OpenAI, Anthropic, Groq u OpenRouter. Le pagás el consumo directamente a ese proveedor, y DokBot nunca te cobra por uso de IA — solo por la plataforma.

Créditos IA significa que DokBot corre la IA por vos usando nuestra propia key. Tu plan incluye un cupo mensual de créditos, y podés recargar si se te agotan. Es la opción para quienes no quieren gestionar API keys.

Usar el panel

Crear y publicar un bot

Todo bot arranca en Borrador: podés configurarlo, probarlo y asignarle bases de conocimiento, pero su widget público se mantiene en silencio en cualquier sitio externo mientras lo trabajás.

Cuando estés conforme con sus respuestas en el Playground, publicalo desde su pestaña Overview para que el widget quede activo donde lo instales.

Configurar un bot

La pestaña Configuración de cada bot controla cómo piensa y cómo se ve:

  • Proveedor y modelo — elegidos entre las API keys y modelos que registraste en Configuración de cuenta.
  • System prompt — las instrucciones y el rol que dan forma a cada respuesta (tono, personalidad, qué evitar).
  • Nombre, avatar y color de marca — se muestran dentro del widget de chat.
  • Mensaje de bienvenida — lo primero que ve un visitante al abrir el chat.
  • Mensaje de fallback — se muestra cuando el bot no puede responder con su base de conocimiento, justo antes de ofrecer juntar el email del visitante.
  • Dominios permitidos — restringe qué sitios pueden embeber el widget; si lo dejás vacío, cualquier origen puede cargarlo.

Probar en el Playground

El Playground te deja chatear con un bot tal como lo haría un visitante, usando su configuración y base de conocimiento actuales — la forma más rápida de detectar una respuesta incorrecta o faltante antes de publicar.

Revisar conversaciones y derivaciones

La página de Conversaciones solo lista los chats que el bot no pudo resolver y derivó a un humano, divididos en dos vistas: "Derivada a email" para las que siguen pendientes, y "Contactado" para las que ya seguiste.

Cada conversación muestra el email del visitante si lo dejó (o un ID de visitante anónimo si no) más la transcripción completa. Marcala como contactada una vez que hiciste el seguimiento para que salga de tu cola de pendientes.

Proveedores

Proveedores soportados

DokBot soporta los siguientes proveedores para BYOK: OpenAI, Anthropic, Google AI Studio, Groq, OpenRouter, CheaperInference y Ollama Cloud.

Podés agregar tu API key y registrar los modelos que quieras usar desde Configuración → API Keys, y luego elegirlos al configurar un bot.

Widget

Instalar el widget

Cada bot tiene su propio script de instalación en su pestaña Instalar: una única etiqueta script que apunta a tu bot, por ejemplo `<script src="https://tuapp.com/widget.js" data-bot-id="..." async></script>`. Pegala una vez antes de cerrar la etiqueta </body> de tu sitio.

El bot tiene que estar Publicado para que el widget responda en sitios externos — mientras está en Borrador, se mantiene en silencio fuera de tu panel.

El widget se renderiza dentro de un Shadow DOM, así que nunca hereda ni filtra el CSS de tu sitio — siempre se ve igual sin importar dónde se instale.

Si no configurás dominios permitidos en Configuración, el widget acepta peticiones desde cualquier origen — configuralos una vez que sepas dónde va a vivir el bot.

Personalización

Cada bot se puede personalizar de forma independiente: color de marca, avatar, mensaje de bienvenida, posición del widget (abajo a la izquierda o derecha) y el mensaje de fallback cuando el bot no puede ayudar.

Derivación humana

Cuando el bot no puede resolver una consulta, puede capturar el email del visitante y notificar a una o más direcciones que configures en el bot, para que un humano haga el seguimiento. Vas a encontrar todas estas conversaciones en Conversaciones dentro de tu panel.

Acceso MCP (conectores de IA)

Qué es el acceso MCP de DokBot

DokBot expone un servidor MCP (Model Context Protocol) remoto, disponible en el plan Pro, para conectar asistentes como Claude o ChatGPT directamente a tu cuenta y que puedan gestionar tus bots, bases de conocimiento y conversaciones en tu nombre.

La conexión usa OAuth 2.1 estándar — tu cliente de IA nunca ve tu contraseña de DokBot, y vos aprobás exactamente qué puede hacer desde una pantalla de consentimiento antes de compartir nada.

Conectar Claude, ChatGPT u otro cliente MCP

En tu cliente de IA, agregá un nuevo conector personalizado / servidor MCP remoto y pegá esta URL:

https://dokbot.app/api/mcp
  • El cliente va a abrir una ventana de inicio de sesión/autorización de DokBot — iniciá sesión (o ya vas a estar logueado) y hacé clic en "Autorizar acceso".
  • Una vez aprobado, el cliente de IA descubre automáticamente las herramientas disponibles — no hace falta ninguna configuración manual además de pegar la URL.
  • Podés encontrar la URL exacta del conector y gestionar las apps conectadas en cualquier momento desde Configuración → Conectores IA (MCP), dentro de tu panel de DokBot.

Qué puede hacer la IA una vez conectada

El servidor MCP de DokBot expone actualmente estas herramientas: list_bots, get_bot, update_bot, list_knowledge_bases, list_documents, list_conversations, get_conversation y get_account_usage — cubriendo lectura y edición de la configuración de tus bots, revisión de tus bases de conocimiento y documentos, revisión de conversaciones, y consulta de tu plan y uso de créditos.

Revocar el acceso

Tenés el control en todo momento: abrí Configuración → Conectores IA (MCP) para ver todas las apps autorizadas y revocar el acceso al instante. Revocar invalida inmediatamente los tokens de esa conexión.

Precios

Resumen de planes

DokBot ofrece dos esquemas de precios: planes BYOK (más baratos, porque le pagás la IA directo al proveedor) y planes de Créditos IA (nosotros corremos la IA por vos, sin configurar ninguna key).

Mirá el detalle completo, los límites y los precios actuales en la página de Precios.

Seguridad y Privacidad

Cómo protegemos tus datos

Cada tabla está aislada con Row Level Security de Postgres: un usuario solo puede leer o escribir sus propios bots, bases de conocimiento y conversaciones.

Las API keys se encriptan en reposo (AES-256-GCM) y nunca se exponen de vuelta al cliente — solo se usan del lado del servidor para responder tus bots.

Leé la Política de Privacidad completa para más detalle sobre retención y procesamiento de datos.

Preguntas frecuentes

¿Necesito saber programar?

No. Subir documentos, configurar un bot e instalar el widget solo requiere copiar una etiqueta de script — no hace falta perfil técnico.

¿Puedo cambiar entre BYOK y Créditos IA más adelante?

Sí, podés cambiar cómo paga la IA un bot en cualquier momento desde su configuración.

¿Qué pasa si el bot no tiene contexto para responder?

Nunca inventa una respuesta. En cambio, ofrece juntar el email del visitante para que un humano haga el seguimiento.

¿Qué formatos y tamaños de archivo puedo subir?

PDF, DOCX, XLSX/XLS, MD y TXT, hasta 10MB por archivo. También podés importar una página web pegando su URL en lugar de subir un archivo.

¿Los visitantes notan si un bot sigue en Borrador?

No — el widget de un bot en Borrador simplemente no responde si está embebido fuera de tu panel, así podés configurarlo y probarlo sin exponer un bot inconcluso a visitantes reales.