You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Mitchell Admin 536a2d73ce 🌈 pre-commit 3 years ago
..
data 🌈 pre-commit auto cleanup 3 years ago
models 🌈 pre-commit 3 years ago
tests 🌈 pre-commit manual cleanup 3 years ago
views 🌈 pre-commit auto cleanup 3 years ago
README.md 📖 rename module 3 years ago
__init__.py 🌈 pre-commit auto cleanup 3 years ago
__manifest__.py ⬆️1️⃣4️⃣ OCA/odoo-module-migrator 3 years ago

README.md

Robust Mails

This module is used to improve email deliverability and make sure that replies find their way to the correct thread in Odoo.

Options:

  • Force the From and Reply-To addresses of outgoing email
  • Generate a thread-specific Reply-To address for outgoing emails so that losing the headers used to identify the correct thread won't be a problem any more.

Gotcha

To make the automatic bounce message work when using thread-specific Reply-To addresses, you should define the actual catchall alias in a system parameter called mail.catchall.alias.custom and change the mail.catchall.alias to something completely random that will never be used, or alternatively remove it.

The reason is this: when Odoo is looking for a route for an incoming email that has lost its headers, it won't check whether the email was sent to catchall@whatever.com but instead it will see if the local part of that address contains the word catchall. And this isn't a good thing when the address is something like catchall+123abc@whatever.com. That's why we had to skip the default catchall evaluation and redo it in a later phase.

Database-specific Settings

Setting Purpose Default value
email_headers.strip_mail_message_ids Office 365 emails may add whitespaces before the Message-Id's. This feature removes them. "True"
email_headers.prioritize_replyto_over_headers When "True", Odoo will prioritize the (unique) Reply-To address of an incoming email and only then look at the References and In-Reply-To headers. "True"
mail.catchall.alias The default catchall alias. See "Gotcha" for more information. "catchall"
mail.catchall.alias.custom The new catchall alias setting. See "Gotcha" for more information. Will be set automatically upon module installation. mail.catchall.alias value

Debugging

Decode and decrypt a message id

from odoo.addons.email_headers.models.mail import decode_msg_id
decode_msg_id(<encrypted and base32/64 encoded message database id>, self.env)

Encrypt and encode a message id

from odoo.addons.email_headers.models.mail import encode_msg_id
encode_msg_id(<message database id>, self.env)