Bot de Telegram de atención al cliente con IA: código fuente completo

Un bot de atención al cliente completo y listo para producción para Telegram, que combina un asistente de IA, una base de conocimiento ligera y la derivación a un operador humano en un único código limpio. Creado para agencias y freelancers que entregan bots de soporte a sus clientes, o para cualquiera que quiera automatizar su propio canal de soporte en Telegram sin construir la infraestructura desde cero.

Cómo funciona:
Telegram → IA → Base de conocimiento → PostgreSQL → Panel de administración (dentro del chat)

Características principales:

• 🧠 Respuestas con IA a través de cualquier API compatible con OpenAI (OpenAI, OpenRouter, Groq o un modelo autoalojado): cambia de proveedor modificando una sola URL

• 📚 Base de conocimiento / FAQ integrada con búsqueda por palabras clave que fundamenta las respuestas de la IA en tus políticas reales, sin necesidad de base de datos vectorial

• 🙋 Derivación a un operador con un solo comando: el cliente escribe /operator, la conversación pasa al grupo de Telegram de tu equipo de soporte y los administradores responden con el «Responder» nativo de Telegram, sin herramientas adicionales

• 🗂 Historial completo de conversaciones: cada mensaje (del usuario, de la IA y del operador) se registra en PostgreSQL

• 🛠 Comandos de administración, directamente en Telegram: estadísticas, gestión de FAQ, mensajes de difusión, historial por usuario y más

• ⚙️ Prompt del sistema editable en vivo: cambia el tono, las reglas o el contexto de negocio de la IA con /setprompt, sin necesidad de volver a desplegar

• 📊 Estadísticas integradas: usuarios, mensajes, nuevos registros, solicitudes abiertas de operador

• 🐳 Docker y docker-compose: toda la pila (bot + PostgreSQL) se inicia con un solo comando

• 🔐 .env.example con cada variable documentada, además de un README detallado y una guía de configuración paso a paso

Tecnologías: Python 3.12, aiogram 3 (asíncrono), SQLAlchemy 2.0 + asyncpg, PostgreSQL 16, Docker.

Qué incluye:

• Código fuente completo y comentado (33 archivos, estructura modular limpia: manejadores, modelos de base de datos, capa de IA, utilidades)

• Dockerfile + docker-compose.yml para un despliegue inmediato

• .env.example con todas las variables de configuración

• Conjunto de datos de FAQ de ejemplo + script de carga inicial

• README detallado y una guía completa de configuración y uso en PDF

Un gran punto de partida para: bots de soporte de comercio electrónico, centros de ayuda SaaS, bots de soporte informático interno o como base de marca blanca que personalizas y revendes a tus propios clientes.