Configurar la importación de correo

Además de la carga manual, los PDFs pueden importarse por correo electrónico.

Cómo funciona

El correo debe contener un archivo PDF.
El PDF debe contener un código QR DOCTAG válido.
Solo si la validación es correcta se importa el documento.
Si el PDF contiene varios códigos QR, se divide en documentos separados antes de cada código.

Configuración

Encontrará la función en Ajustes > Sistema > Correo electrónico. Introduzca allí las credenciales de un buzón que sea utilizado exclusivamente por el servidor DOCTAG. La importación siempre usa el flujo de trabajo marcado como predeterminado (con asterisco) en los ajustes.

La importación de correo elimina los mensajes del buzón tras importarlos.}

Integración moderna de correo OAuth2

A partir de 2026, DOCTAG soporta la integración segura y universal de buzones de correo mediante el estándar OAuth2 (RFC 6749) y XOAUTH2 (RFC 7628). Esto le permite conectar Google, Microsoft, Yahoo y muchos otros proveedores sin interfaces propietarias ni bibliotecas adicionales.

✅ Universal: Funciona con Google, Microsoft, Yahoo y cualquier proveedor OAuth2
✅ Seguro: Sin contraseñas en texto claro; los tokens se almacenan cifrados (AES-256)
✅ Sencillo: Configuración unificada, menos dependencias
✅ Compatible con versiones anteriores: IMAP/POP3 clásico sigue siendo posible

Proveedores soportados

Google: imap.gmail.com
Microsoft: outlook.office365.com
Yahoo: imap.mail.yahoo.com
Otros: Cualquier servidor IMAP con soporte XOAUTH2

Pasos de configuración

En DOCTAG, vaya a Ajustes > Sistema > Correo electrónico y seleccione el proveedor "OAuth2 (Google, Microsoft, Yahoo)".
Seleccione su proveedor y haga clic en "Conectar con proveedor".
Será redirigido al proveedor para autorizar el acceso.
Tras el inicio de sesión correcto, las credenciales se almacenan cifradas.

Nota: Para la configuración puede necesitar acceso a las respectivas consolas cloud (Google Cloud, Microsoft Azure, Yahoo Developer) para introducir los datos de cliente OAuth2. La URL de redirección es siempre: https://<su-dominio>/api/oauth2/callback

Seguridad y gestión de tokens

Todos los tokens OAuth2 se almacenan cifrados con AES-256.
Renovación automática de tokens; no se requiere intervención manual.
Si surgen problemas (p. ej. tokens caducados), basta con volver a autorizar.

Migración y compatibilidad

Los buzones IMAP/POP3 existentes siguen funcionando (modo heredado).
Para nuevos buzones de Google/Microsoft/Yahoo se recomienda encarecidamente OAuth2.

Resolución de problemas

"XOAUTH2 not supported": El servidor de correo no soporta XOAUTH2 – use el modo heredado.
"Invalid access token": Token caducado – vuelva a autorizar.
"OAuth2 configuration missing": Compruebe los datos de cliente OAuth2 en las variables de entorno.