DOCTAG Logo DOCTAG
DE DE EN EN FR FR IT IT
Comenzar gratis

Configurar la conexió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.

Nota importante: En los ajustes de correo electrónico, asegúrese de cambiar a la pestaña "Seguridad" y activar la casilla "Recepción de documentos por correo activa". Sin esta opción, la importación automática permanece desactivada y el registro del servidor mostrará: "Mail import skipped because shouldReceiveDocumentsViaMail is disabled".

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

  1. Vaya a Ajustes > Sistema > Correo electrónico, seleccione "OAuth2 (Google, Microsoft, Yahoo)" como método de inicio de sesión y elija la plantilla de proveedor adecuada (Google/Microsoft/Yahoo/Personalizado).
  2. Copie la URI de redirección mostrada automáticamente (https://<su-dominio>/api/oauth2/callback); la necesitará en el siguiente paso.
  3. Registre una app OAuth2 en el proveedor e introduzca allí la URI de redirección:
    • Google: Google Cloud Console → configure la pantalla de consentimiento OAuth y publique la app en "En producción" (en modo de prueba los refresh tokens caducan ya a los 7 días) → cree un ID de cliente OAuth de tipo "Aplicación web".
    • Microsoft: Azure/Entra Admin Center → cree un registro de aplicación → genere un secreto de cliente → añada los permisos de API IMAP.AccessAsUser.All, SMTP.Send y offline_access.
    • Yahoo: Yahoo Developer Network → registre una app.
  4. Copie el ID de cliente y el secreto de cliente del proveedor en los ajustes de correo de DOCTAG.
  5. Haga clic en "Conectar con proveedor", inicie sesión en el buzón y confirme el acceso.
  6. DOCTAG le redirige automáticamente de vuelta a los ajustes de correo; las credenciales quedan almacenadas cifradas.

Seguridad y gestión de tokens

  • Todos los tokens OAuth2 se almacenan cifrados con AES-256.
  • Los tokens de acceso se renuevan automáticamente en segundo plano (también durante la importación automática por cronjob); no se requiere intervención manual.
  • Si un token no puede renovarse automáticamente (p. ej. porque el refresh token ha dejado de ser válido), DOCTAG muestra un aviso en la parte superior de la página; en ese caso, repita una vez "Conectar con proveedor".

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.
  • La URI de redirección no coincide: la URI registrada en el proveedor debe coincidir exactamente con la mostrada en DOCTAG.