Módulo FileMailer-Web #
FileMailer-Web — la experiencia de correo que tu solución FileMaker estaba esperando. Nativa donde importa, estándar web donde cuenta.

Un cliente web moderno en React y TypeScript para el backend FileMailer-PG. FileMailer-Web está diseñado específicamente para ejecutarse dentro de un Visualizador Web de FileMaker, ofreciendo una integración de correo fluida y potente para cualquier CRM, ERP o solución FileMaker existente — y funcionando perfectamente también como aplicación de navegador independiente.
Visión General #
FileMailer-Web es el compañero frontend de FileMailer-PG. Mientras FileMailer-PG gestiona la sincronización IMAP/SMTP, los metadatos en PostgreSQL y el almacenamiento direccionable por contenido en Minio, FileMailer-Web ofrece una interfaz limpia y responsiva para navegar, buscar, leer, redactar, responder y organizar el correo — todo a través de APIs REST.
Lo que lo hace único es la profunda integración con FileMaker por diseño. Un sistema integrado de cabeceras de correo vincula cada email a cualquier objeto FileMaker que necesites — clientes, proveedores, operaciones, artículos, facturas, tickets, otros correos — a través de cabeceras de metadatos y enlaces por API REST. No hace falta hinchar tus archivos FileMaker con copias del contenido del correo: la copia autorizada vive en FileMailer-PG, FileMaker solo guarda las referencias.
Características Principales #
Diseño Orientado al Visualizador Web de FileMaker #
- Construido para incrustarse en un Visualizador Web de FileMaker con integración bidireccional fluida
- Contrato de arranque limpio: la API key y el contexto se entregan desde FileMaker
- Diseños responsivos y compactos que lucen nativos dentro de una presentación FileMaker
- Funciona igualmente bien como aplicación web de navegador independiente
Sistema Integrado de Cabeceras de Correo #
- Cada email lleva cabeceras personalizadas estructuradas que lo vinculan a objetos FileMaker
- Vincula mensajes a clientes, proveedores, operaciones, artículos, correos — o a cualquier entidad que tu solución necesite
- Enlace solo por metadatos: los archivos FileMaker se mantienen ligeros, el contenido del correo vive en FileMailer-PG
- Patrones de cabeceras personalizables por cuenta y por flujo de trabajo
Gestión Moderna de Correo #
- Scroll virtual para buzones con decenas de miles de mensajes
- Gestión multi-cuenta IMAP/SMTP con ordenación alfabética de cuentas
- Renderizado enriquecido de correo HTML con sanitización (DOMPurify)
- Compositor completo con editor rich-text Quill
- Responder, responder a todos, reenviar, borradores con autoguardado
- Subida, previsualización y descarga de adjuntos mediante almacenamiento CAS
Actualizaciones en Tiempo Real #
- Estado de sincronización en vivo impulsado por las notificaciones IMAP IDLE del backend
- Indicadores de sincronización a nivel de cuenta y de carpeta
- Refresco en línea sin recargar la aplicación
Canalización de Contenido Lista para IA #
- El backend compañero FileMailer-PG incrusta e indexa cuerpos y adjuntos de correo para inmersión en IA
- FileMailer-Web expone este contenido indexado al usuario y ofrece puntos de enlace para búsqueda y recuperación con IA
- Tu CRM/ERP gana contexto de correo potenciado por IA sin salir de FileMaker
Stack de Nivel Profesional #
- React 19 con hooks y funcionalidades concurrentes
- TypeScript de extremo a extremo — tipos compartidos con el esquema OpenAPI de FileMailer-PG
- Vite para servidor de desarrollo instantáneo y builds de producción rápidos
- Tailwind CSS utility-first
- shadcn/ui biblioteca de componentes accesibles
- Iconos Lucide
- Axios con interceptores para autenticación por API key, manejo de errores y logging
Temas y UX #
- Modo claro y oscuro integrados
- Diseño responsivo — escritorio, tableta y móvil
- Optimizado para incrustarse en viewports restringidos (Visualizador Web de FileMaker)
Arquitectura #
Solución FileMaker
└── Visualizador Web
└── FileMailer-Web (React SPA)
└── API REST (X-API-Key)
└── FileMailer-PG (Spring Boot)
├── PostgreSQL (metadatos, búsqueda de texto completo)
└── Minio / S3 (almacenamiento CAS, deduplicación SHA-256)
- Stateless — sin backend propio; todo el estado vive en FileMailer-PG
- Desplegable en cualquier parte — carpeta estática
dist/a Vercel, Netlify, GitHub Pages, S3+CloudFront, nginx o servida directamente por FileMaker Server - Autenticación por API key — sin sesiones, sin cookies, compatible con el Visualizador Web
Integración con FileMaker #
- Configura la URL base de la API de FileMailer-PG y la API key en el primer arranque (o inyéctalas desde FileMaker al cargar el Visualizador Web)
- Usa scripts FileMaker para abrir el visualizador web en una cuenta, carpeta o contexto de búsqueda concretos
- Usa el sistema de cabeceras de correo para navegar desde un registro FileMaker (un cliente, un pedido, un ticket) directamente al hilo de correo relacionado
- Redacta nuevos mensajes precargados con cabeceras que enlazan al registro FileMaker origen
Casos de Uso #
- Integración de correo en CRM — adjunta el histórico de comunicación directamente a las fichas de cliente
- Seguimiento de operaciones en ERP — vincula la correspondencia con proveedores a pedidos y operaciones
- Ticketing y helpdesk — enlaza mensajes entrantes a tickets, casos o incidencias
- Flujos documentales — los adjuntos pasan por el motor de deduplicación y quedan enlazados al objeto de negocio origen
- Buzones potenciados por IA — búsqueda semántica, resumen y recuperación sobre todo tu corpus de correo
Especificaciones Técnicas #
Stack #
- React 19 + TypeScript
- Vite 7
- Tailwind CSS 3 + shadcn/ui
- Primitivos Radix UI
- Editor rich-text Quill
- Cliente HTTP Axios
- React Router v7
Requisitos #
- Node.js 18+ para desarrollo
- Un backend FileMailer-PG en ejecución
- Una API key válida de FileMailer-PG
- Cualquier navegador moderno o un Visualizador Web de FileMaker (recomendado FileMaker Pro 19+)