FreeScout: Helpdesk omnicanal autohospedado con IA

freescout
Open Source Helpdesk

FreeScout: Helpdesk omnicanal autohospedado con IA

Alternativa gratuita a Zendesk y Help Scout construida con Laravel, con bandeja de entrada compartida, IA y soporte multicanal

Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar y usar FreeScout: Helpdesk omnicanal autohospedado con IA en el canal GENBYTE:

¿Qué es FreeScout: Helpdesk omnicanal autohospedado con IA?

FreeScout es un sistema de mesa de ayuda y bandeja de entrada compartida de código abierto, ligero y potente, desarrollado en PHP sobre el framework Laravel. Permite centralizar todas las conversaciones de clientes recibidas por correo electrónico, WhatsApp, Telegram, Facebook, Slack, chat en vivo y más en un solo lugar. Ofrece agentes, tickets y buzones ilimitados, es seguro por diseño, compatible con móviles, traducido a 33 idiomas y cuenta con instalador y actualizador web. La licencia es AGPL-3.0.

FreeScout combina la funcionalidad de un helpdesk empresarial con la privacidad y el control del autohospedaje, añadiendo capacidades de IA y una arquitectura modular extensible.

Características principales

Omnicanal

Centraliza conversaciones de email, WhatsApp, Telegram, Facebook, Slack, Live Chat y otros canales en una única interfaz.

Potenciado por IA

Integración con IA para redactar respuestas, clasificar tickets y mejorar la eficiencia de los agentes mediante el módulo oficial AiIntegration.

Recursos ilimitados

Sin límites en agentes de soporte, tickets, buzones de correo ni conversaciones.

Autenticación moderna

Soporte nativo para OAuth con Microsoft Office 365 y Google Workspace para conexión de buzones.

Progressive Web App

Instalable desde el navegador en móviles y escritorio, con notificaciones push web.

Almacenamiento S3

Compatibilidad nativa con almacenamiento S3 a través del módulo oficial S3Storage.

Accesibilidad

Soporte completo para lectores de pantalla, garantizando accesibilidad para usuarios con discapacidad visual.

Instalador y actualizador web

Proceso de instalación y actualización mediante interfaz gráfica sin necesidad de línea de comandos.

Gestión avanzada de conversaciones

Incluye notas internas, reenvío, fusión, movimiento de conversaciones, detección de colisiones, auto-respuestas, seguimiento de apertura y búsqueda potente.

Aplicaciones móviles nativas

Apps oficiales para Android e iOS con la misma funcionalidad y módulos que la versión web, más app de barra de menú para macOS.

Requisitos del sistema

  • Servidor web: Nginx, Apache o IIS
  • PHP 7.4 a 8.x
  • Base de datos: MySQL 5.0+, MariaDB 5.0+ o PostgreSQL
  • Sin requisitos mínimos de CPU o RAM; funciona en cualquier sistema, incluido hosting compartido

Instalación con Docker Compose

Instalación con Docker (recomendada)

FreeScout proporciona una imagen Docker oficial documentada en su sitio web. La forma más sencilla es seguir la guía oficial de Docker que incluye docker-compose.yml con configuración de base de datos, volúmenes persistentes y variables de entorno.

# Consultar la guía oficial de Docker para el docker-compose.yml completo # https://freescout.net/docker/ # Ejemplo típico de uso: # docker compose up -d

Instalación manual en servidor

Clonar el repositorio, configurar el archivo .env con los datos de base de datos y APP_KEY, ejecutar el instalador web accediendo a la URL del dominio.

git clone https://github.com/freescout-help-desk/freescout.git cd freescout cp .env.example .env # Editar .env con DB_DATABASE, DB_USERNAME, DB_PASSWORD, APP_URL php artisan key:generate # Acceder a https://tu-dominio.com para lanzar el instalador web

Instalaciones en un clic

Disponible en Pikapods, Zenith, Hostinger, Softaculous, Fantastico, Cloudron y script bash interactivo para Ubuntu.

# Ver lista completa en https://freescout.net/one-click-installs/

Acceder al proyecto

Acceso web

Tras la instalación, acceder a la URL configurada en APP_URL (ej. https://soporte.tuempresa.com) para iniciar sesión con la cuenta de administrador creada durante el instalador web.

Aplicaciones móviles

Descargar la app oficial para Android desde Google Play o para iOS desde App Store. Ingresar la URL de la instancia FreeScout y credenciales de agente o administrador.

Progressive Web App

Desde el navegador móvil o de escritorio, usar la opción 'Instalar aplicación' para añadir FreeScout como PWA con notificaciones push.

Casos de uso

  • Helpdesk de atención al cliente multicanal para PYMES y equipos de soporte
  • Bandeja de entrada compartida para equipos de ventas, éxito del cliente o operaciones
  • Migración desde Zendesk, Help Scout, osTicket u otros sistemas mediante herramienta de migración oficial
  • Automatización de flujos de trabajo con Zapier o Make (Integromat)
  • Integración personalizada mediante API REST documentada
  • Soporte interno de TI o RR.HH. con buzones dedicados y notas internas

Configuración avanzada

Variables de entorno clave (.env)

Configuración avanzada mediante variables de entorno documentadas en .env.example. Incluyen URL de la aplicación, proxy saliente, cabeceras de email personalizadas, zona horaria, proxies de confianza, lista blanca de hosts remotos y modo debug.

# Ejemplos de variables útiles APP_URL=https://soporte.ejemplo.com SESSION_SECURE_COOKIE=true APP_PROXY=http://proxy:3128 APP_TIMEZONE=Europe/Madrid APP_TRUSTED_PROXIES=** APP_REMOTE_HOST_WHITE_LIST="ejemplo.com,1.2.3.4" APP_DEBUG=false

Limpieza de caché tras cambios en .env

Cada modificación en .env requiere ejecutar el comando de limpieza de caché para que surta efecto.

php artisan freescout:clear-cache

Actualización de módulos oficiales

Los módulos oficiales (WhatsApp, IA, S3, etc.) se gestionan desde la interfaz de administración de FreeScout, requiriendo acceso a api.freescout.net. Si el servidor usa proxy, configurar APP_PROXY.

# Configurar proxy si api.freescout.net no es accesible directamente APP_PROXY=http://proxy:3128

Gestión y mantenimiento

Actualización del core

FreeScout incluye actualizador web accesible desde el panel de administración. También puede actualizarse vía git pull y ejecutando migraciones.

cd /ruta/freescout git pull php artisan migrate --force php artisan freescout:clear-cache

Copia de seguridad

Realizar copias de seguridad de la base de datos (MySQL/MariaDB/PostgreSQL) y del directorio storage/ (archivos adjuntos, logs, caché).

# Ejemplo backup base de datos MySQL mysqldump -u usuario -p base_datos > backup_$(date +%F).sql # Backup archivos cp -r storage/ /ruta/backups/storage_$(date +%F)

Logs y depuración

Los logs se almacenan en storage/logs/. Activar APP_DEBUG=true temporalmente para ver errores detallados en el navegador.

tail -f storage/logs/laravel.log # Activar debug temporal APP_DEBUG=true php artisan freescout:clear-cache

Stack técnico

  • PHP 7.4 - 8.x
  • Laravel Framework
  • MySQL / MariaDB / PostgreSQL
  • Nginx / Apache / IIS
  • JavaScript (Webpack, Laravel Mix)
  • Docker (imagen oficial)
  • AGPL-3.0 License

Apoya el canal GENBYTE

Sígueme en mis redes sociales

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Solución al Error "No se encontró la imagen de Windows RE" en Windows 10 al ejecutar reagentc /enable