Helpdesk gratis y open source: crea tu propio sistema de tickets con IA (descarga el código)

Si buscas un helpdesk gratis y open source para atender a tus clientes sin pagar una licencia por cada persona de tu equipo, aquí tienes uno listo para descargar: Lean Helpdesk. Junta todas tus bandejas de correo en un solo panel, convierte cada conversación en un ticket y te deja responder como si fuera un chat.

Lo construí con ayuda de inteligencia artificial cuando el soporte de nuestro equipo vivía repartido en varias bandejas: una por cada marca, programa y evento. Alguien respondía desde Gmail, otro desde Outlook, y nadie sabía con certeza qué correos ya tenían respuesta. Hoy lo usamos todos los días para atender clientes de varios países, y el código está abierto para que lo instales en tu propio hosting.

En este artículo te cuento qué hace, cómo funciona por dentro, cómo instalarlo paso a paso y cuándo te conviene más que una herramienta como Zendesk o FreeScout.

Qué es Lean Helpdesk

Un helpdesk es un sistema para atender las preguntas de tus clientes de forma ordenada. En lugar de que cada correo se pierda en la bandeja de alguien, cada conversación se convierte en un ticket: tiene un estado (abierto o cerrado), un historial y un responsable.

Lean Helpdesk hace justo eso, sin nada más. La palabra «lean» viene de la idea de quitar todo lo que sobra: no tiene base de conocimiento, ni chat en vivo, ni cien configuraciones. Tiene lo que un equipo pequeño o mediano necesita para responder rápido y no dejar a nadie sin respuesta.

• Varias bandejas en un solo lugar. Conectas cada correo (soporte@, ventas@, eventos@) y los ves todos en el mismo panel.
• Tickets automáticos. Cada correo nuevo se convierte en un ticket. Si el cliente responde el mismo hilo, se suma al ticket que ya existe.
• Vista tipo chat. Cada ticket se lee como una conversación de WhatsApp, con los mensajes del cliente a un lado y los tuyos al otro.
• Adjuntos. Ves los archivos que te envían y puedes adjuntar los tuyos al responder.
• Correos nuevos. Además de responder, puedes escribirle a un cliente desde cero.
• Buscador global. Encuentras cualquier conversación por correo o asunto, en todas las bandejas a la vez.
• Reportes de tiempo de respuesta. Ves cuánto tarda tu equipo en responder, por semana, por mes y por día de la semana.
• Conexión con bots. Tiene una pequeña API para que una automatización consulte los tickets pendientes.

Por qué no usé Zendesk ni otra herramienta de pago

Zendesk, Help Scout y Freshdesk son muy buenas herramientas. El problema es el modelo de cobro: casi todas cobran por agente, cada mes. Si tienes cinco personas respondiendo, pagas cinco licencias, y el precio sube cada vez que crece el equipo o que la herramienta decide cambiar sus planes.

En nuestro caso había otro detalle: atendemos varias marcas, y a veces un correo se envía con el servidor de una marca pero la respuesta debe llegar al correo de otra. Las herramientas grandes lo resuelven, pero con configuraciones que cuestan tiempo o planes más caros.

Antes de construir el mío usé FreeScout, que es una excelente alternativa gratuita y todavía la recomiendo. Lean Helpdesk nació porque quería algo aún más simple, con una interfaz más parecida a un chat y con reportes de tiempos de respuesta pensados para nuestro equipo.

Cómo funciona por dentro

No necesitas saber programar para usarlo, pero entender cómo funciona te ayuda a instalarlo sin miedo.

1. Tu cliente escribe a tu correo de siempre. No cambia nada para él: sigue escribiendo a soporte@tuempresa.com.
2. Cada 5 minutos el helpdesk revisa los correos nuevos. Lo hace con una tarea programada del servidor, llamada cron. Se conecta a cada bandeja por IMAP, que es el protocolo que usan los programas de correo para leer mensajes.
3. Crea o actualiza el ticket. Si es una conversación nueva, crea un ticket. Si el cliente está respondiendo algo anterior, lo agrega al mismo hilo. También descarga los adjuntos.
4. Tú respondes desde el panel. El helpdesk envía tu respuesta por SMTP, el protocolo de envío de correo, así que el cliente recibe un correo normal desde tu dirección.

Por dentro está hecho en PHP y MySQL, las mismas tecnologías que usa WordPress. Por eso funciona en casi cualquier hosting, incluso en los más económicos.

Lo construí apoyándome en IA

Soy ingeniero de software, pero este proyecto no lo escribí línea por línea a mano. Lo construí conversando con un asistente de inteligencia artificial: yo definía qué necesitaba el equipo, revisaba el código que proponía, lo probaba en el servidor y pedía ajustes. En pocos días tenía una primera versión funcionando.

Te lo cuento porque hoy cualquier empresa puede hacer algo parecido con sus propias herramientas internas. La IA acelera muchísimo el trabajo, pero no reemplaza el criterio: alguien tiene que saber qué pedir, revisar la seguridad y probar que todo funcione con datos reales. Más abajo te cuento las lecciones de seguridad que te ahorrarán sustos.

Cómo instalar Lean Helpdesk paso a paso

El código completo está en GitHub. Necesitas un hosting con PHP 8.1 o superior, MySQL y la posibilidad de crear tareas cron. Cualquier hosting con cPanel, CyberPanel o Plesk sirve.

1. Descarga el código desde el repositorio de Lean Helpdesk en GitHub (botón verde «Code» y luego «Download ZIP») y súbelo a un subdominio, por ejemplo soporte.tudominio.com.
2. Instala las librerías con Composer, ejecutando composer install --no-dev en la carpeta del proyecto. Si tu hosting no tiene terminal, muchos paneles traen una opción para ejecutar Composer.
3. Crea la base de datos en tu hosting y ejecuta el archivo install/schema.sql desde phpMyAdmin, en la pestaña SQL.
4. Configura la conexión. Copia config/database.example.php con el nombre config/database.php y escribe los datos de tu base de datos.
5. Crea tu usuario desde la terminal: php install/crear-usuario.php tu@empresa.com "TuContraseña".
6. Programa el cron para que corra cada 5 minutos: */5 * * * * php /ruta/a/tu/helpdesk/cron/fetch_emails.php.
7. Entra al panel, ve a Ajustes y agrega tus bandejas con sus datos de IMAP y SMTP.

Si usas Gmail o Google Workspace, necesitas una contraseña de aplicación en lugar de la contraseña normal de la cuenta. Se crea desde la seguridad de tu cuenta de Google, con la verificación en dos pasos activada.

Lecciones de seguridad que aplican a cualquier herramienta propia

Cuando construyes herramientas internas, sobre todo con ayuda de IA, es fácil que se cuelen errores de seguridad que nadie nota hasta que es tarde. Estas son las reglas que apliqué en la versión pública:

• Nunca subas contraseñas a GitHub. Los datos de conexión van en un archivo que Git ignora. En el repositorio solo hay un archivo de ejemplo. Es uno de los errores más comunes: si alguna vez lo hiciste, cambia esa contraseña de inmediato, porque borrar el archivo no la borra del historial.
• No dejes scripts de «emergencia» en el servidor. Un archivo para resetear contraseñas que se ejecuta desde el navegador es una puerta abierta. En Lean Helpdesk el usuario se crea solo desde la terminal.
• Protege cada endpoint. Todas las rutas que muestran datos de clientes deben pedir sesión, incluidos los reportes.
• Los adjuntos nunca se ejecutan. La carpeta de adjuntos bloquea cualquier archivo de código, por si alguien envía uno malicioso por correo.
• Desconfía de los adjuntos comprimidos. En una bandeja de soporte llegan muchos correos falsos del tipo «Cotización urgente.rar» o «Confirmar datos bancarios.zip». Son phishing: nadie del equipo debería abrirlos.

Cómo lo conecto con mis automatizaciones

Lean Helpdesk tiene un punto de conexión, api/bot/pendientes.php, que devuelve los tickets que siguen sin respuesta. Lo protege una clave secreta que defines en config/bot.php.

Yo lo uso con un flujo de n8n que revisa los pendientes varias veces al día y le avisa al equipo en Discord cuáles llevan más tiempo esperando. Si te interesa armar algo así, te explico la base en mi guía sobre qué es un webhook y en la de n8n con Claude.

¿Lean Helpdesk, FreeScout o Zendesk?

• Elige Lean Helpdesk si tienes un equipo pequeño o mediano, varias bandejas de correo y quieres algo simple, gratis y que puedas modificar a tu medida.
• Elige FreeScout si necesitas más funciones listas para usar, como etiquetas, respuestas guardadas, flujos automáticos o apps móviles, y prefieres un proyecto con una comunidad grande detrás.
• Elige Zendesk o Help Scout si no quieres preocuparte por servidores ni actualizaciones y el costo por agente no es un problema para tu empresa.

Preguntas frecuentes

¿Lean Helpdesk es gratis?

Sí. Tiene licencia MIT: puedes usarlo, modificarlo y adaptarlo a tu empresa sin pagar nada. Solo pagas tu hosting.

¿Cuántos agentes y bandejas soporta?

No tiene límites. Puedes conectar todas las bandejas que necesites. El límite real lo pone tu servidor.

¿Funciona con Gmail y Outlook?

Sí, con cualquier correo que permita IMAP y SMTP: Gmail, Google Workspace, Microsoft 365 o el correo de tu propio hosting.

¿Necesito saber programar?

Para instalarlo te ayuda tener nociones básicas de hosting: crear una base de datos, subir archivos y programar un cron. Si nunca lo has hecho, la instalación es una buena tarea para pedirle a tu desarrollador o a una IA que te guíe paso a paso.

¿Puedo mejorarlo y compartir mis cambios?

Claro. El código está abierto en GitHub y cualquier mejora es bienvenida. Si lo instalas, cuéntame en los comentarios cómo te fue.