Añade la posibilidad de adjuntar correos electrónicos de una determinada carpeta IMAP a objetos, por ejemplo, contactos. La coincidencia se realiza mediante varios algoritmos, por ejemplo, la dirección de correo electrónico, el dominio de la dirección de correo electrónico o el algoritmo original de Odoo.
Esto ofrece una posibilidad sencilla de archivar correos electrónicos en Odoo sin una integración con un cliente de correo.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 18.0Recupera correos electrónicos de carpetas IMAP específicas y los adjunta automáticamente a registros existentes de Odoo (como contactos o pedidos de venta) según reglas de coincidencia. También puedes adjuntar manualmente correos electrónicos marcados a cualquier registro.
Este módulo amplía la configuración del servidor de correo entrante de Odoo con una nueva pestaña "Carpetas a monitorizar". Para cada carpeta IMAP puedes definir una regla independiente: qué carpeta leer, dónde archivar los correos procesados, a qué modelo de Odoo adjuntarlos y cómo emparejar los correos con los registros.
El emparejamiento puede hacerse por dirección de correo exacta, por dominio de correo o utilizando el algoritmo de conversación estándar de Odoo. Puedes restringir las coincidencias con un filtro de dominio, elegir usar solo la primera coincidencia si se encuentran varias y decidir si eliminar, marcar o marcar como vistos los correos después del procesamiento. También puedes limitar la obtención a correos no leídos o solo a las últimas 24 horas.
Una vez confirmada una carpeta, puedes obtener los correos inmediatamente con un botón, o se obtendrán automáticamente cuando se ejecute el servidor. Los correos emparejados se adjuntan como mensajes al registro de destino, y se puede ejecutar una acción de servidor opcional sobre ese registro. Los correos que no coinciden pueden marcarse para su gestión manual.
Un asistente manual te permite revisar los correos marcados y adjuntarlos a cualquier registro a mano. El módulo añade el modelo fetchmail.server.folder y un asistente de adjuntado manual, y modifica la vista de formulario fetchmail.server.
Depende de
Modelos y campos (4)
- fetchmail.server · amplía un modelo existenteobject_id, folder_ids (Folders), server_type, folders_only (Process Only Specified Folders), folders_available (Available folders)
- fetchmail.server.folder · modelo nuevopath (Fetch from Folder), seen (Mark email as seen), state (Status), active, domain (Matching Domain), model_id (Target Model), sequence, action_id (Server Action), msg_state (Message state), server_id, mail_field (Email Field), match_first (Use First Match), model_field, model_order, archive_path (Archive Folder), delete_matching (Delete Matched Emails), match_algorithm (Matching Algorithm), flag_nonmatching (Flag Non-Matching Emails), fetch_unseen_only, fetch_last_day_only (Fetch Last 24 Hours Only)
- fetchmail.attach.mail.manually · modelo nuevoname, mail_ids, folder_id
- fetchmail.attach.mail.manually.mail · modelo nuevobody, date, subject, object_id, wizard_id, email_from (From), message_uid (Message id)
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 3 confirmadas, 6 sin información de 9 versiones.
Fuentes · Odoo 16.0
Confirmado el 2026-11-03 en la rama 16.0 de OCA/server-tools.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Configuración
Fuente · Odoo 18.0En tu configuración de fetchmail, encontrarás un nuevo campo de lista Folders to monitor. Añade aquí tus carpetas en notación IMAP (normalmente algo como INBOX.your_folder_name.your_subfolder_name), elige un modelo al que adjuntar los correos y un algoritmo de coincidencia que usar.
Dirección de correo exacta
Rellena un campo para buscar la dirección de correo en Field (model). Para los partners, este sería email. Rellena también el campo de cabecera del correo que se debe consultar en Field (email). Si quieres hacer coincidir los correos entrantes de tus clientes, este sería from. También puedes listar campos de cabecera, así que para hacer coincidir a los partners que reciben este correo, podrías rellenar to,cc,bcc.
Dominio de las direcciones de correo
Haz coincidir el dominio de la(s) dirección(es) de correo encontrada(s) en Field (email). Esto adjuntaría un correo a test1@example.com a un registro con Field (model) establecido en test2@example.com. Dado que se trata de una coincidencia difusa, probablemente quieras marcar Use 1st match, porque de lo contrario no ocurre nada si se encuentran varias coincidencias posibles.
Estándar de Odoo
Estrictamente hablando, este no es un algoritmo de coincidencia, sino que llama a la acción estándar del modelo sobre el nuevo correo entrante, que normalmente consiste en crear un nuevo registro.
Una configuración muy extendida es tener un buzón compartido con varias carpetas, es decir, uno en el que los usuarios dejan los correos que quieren adjuntar a los contactos. Llamemos a esta carpeta From partners. A continuación, cree una configuración de carpeta para su servidor con la ruta "INBOX.From partners" (observe las comillas debido al espacio, esto depende del servidor). Elija el modelo Partners, establezca Field (model) en email y Field (email) en from. En Domain, podría rellenar [('customer', '=', True)] para asegurarse de que solo coincidan los registros de clientes.
Ahora, cuando sus usuarios dejen correos en esta carpeta, Odoo los recogerá y los adjuntará al contacto en cuestión. Después de algunas pruebas, es posible que desee marcar Delete matches en la configuración de su carpeta para que esta carpeta no crezca indefinidamente.
Otra forma de evitar tener que procesar cada vez más mensajes de la carpeta para leer es mover automáticamente todos los mensajes procesados a una carpeta de archivo que se puede especificar.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.