From 7719a58d55c684ddfe848d8e5737a9600d7555fd Mon Sep 17 00:00:00 2001 From: tiku-odoo Date: Thu, 15 Feb 2024 21:06:12 +0000 Subject: [PATCH] [IMP] misc: email comm add allowed alias sys parameter closes odoo/documentation#8087 X-original-commit: 256c96b56f838ad21e5051e20e8e19946eb8140e Signed-off-by: Timothy Kukulka (tiku) --- .../email_communication/email_servers.rst | 44 ++++++++++++++++-- .../email_servers/allowed-domain.png | Bin 0 -> 3357 bytes 2 files changed, 39 insertions(+), 5 deletions(-) create mode 100644 content/applications/general/email_communication/email_servers/allowed-domain.png diff --git a/content/applications/general/email_communication/email_servers.rst b/content/applications/general/email_communication/email_servers.rst index 8003d55c6..581c2d7a1 100644 --- a/content/applications/general/email_communication/email_servers.rst +++ b/content/applications/general/email_communication/email_servers.rst @@ -23,7 +23,7 @@ standard online Odoo database normally since it has already been pre-configured Scope of this documentation =========================== -This document is **mainly dedicated to Odoo on-premise databases** who don't benefit from an +This document is **mainly dedicated to Odoo on-premise databases** that do not benefit from an out-of-the-box solution to send and receive emails in Odoo, unlike `Odoo Online `_ and `Odoo.sh `_. Incoming and outgoing servers must be configured for on-premise databases. @@ -58,8 +58,8 @@ These notifications are sent using a default from address. For more information Manage outbound messages ======================== -As a system admin, go to :menuselection:`Settings --> General Settings --> Discuss` in Odoo, and -enable the :guilabel:`Custom Email Servers` option. Then, click :guilabel:`Save`. Next, click +As a system administrator, go to :menuselection:`Settings --> General Settings --> Discuss` in Odoo, +and enable the :guilabel:`Custom Email Servers` option. Then, click :guilabel:`Save`. Next, click :guilabel:`Outgoing Email Servers` and click :guilabel:`Create` to create a new outgoing mail server record in Odoo. Reference the SMTP data of the external email server. Once all the information has been filled out, click :guilabel:`Test Connection`. @@ -208,7 +208,7 @@ Odoo relies on generic email aliases to fetch incoming messages. * **Reply messages** of messages sent from Odoo are routed to their original discussion thread (and to the inbox of all its followers) by the alias of the model if there is any or by the catchall - alias (**catchall@**). Replies to messages of models that don't have a custom alias will use the + alias (**catchall@**). Replies to messages of models that do not have a custom alias will use the catchall alias (`catchall@mycompany.odoo.com`). The catchall address, however, does not have another action attached to it like other aliases might, it is only used to collect replies. * **Bounced messages** are used as a Return-Path. One example this is especially @@ -265,7 +265,7 @@ To edit catchall and bounce aliases, first activate the :ref:`developer mode Technical --> Parameters --> System Parameters` to customize the aliases (`mail.catchall.alias` & `mail.bounce.alias`). These types of changes should be completed prior to the database going live. If a customer replies after a change is made then the -system will not recognize the old alias and the reply won't be received. +system will not recognize the old alias, and the reply will not be received. By default, inbound messages are fetched every 5 minutes for on-premise databases. @@ -302,3 +302,37 @@ received to the database during the set period of time (as stated by the value i parameter: `mail.incoming.limit.period`). Odoo will then determine whether any of the emails received match that of the email(s) being received during the specified time-frame, and will prevent a feedback loop from occurring if a duplicate email is detected. + +Allow alias domain system parameter +----------------------------------- + +Incoming aliases are set in the Odoo database to create records by receiving incoming emails. To +view aliases set in the Odoo database, first activate the :ref:`developer mode `. +Then, go to :menuselection:`Settings app --> Technical --> Email section --> Aliases`. + +The following system parameter, `mail.catchall.domain.allowed`, set with allowed alias domain +values, separated by commas, filters out correctly addressed emails to aliases. Setting the +domain(s) for which the alias can create a ticket, lead, opportunity, etc., eliminates false +positives where email addresses with only the prefix alias (not the domain) are present. + +In some instances, matches have been made in the Odoo database when an email is received with the +same alias prefix and a different domain on the incoming email address. This is true in the sender, +recipient, and :abbr:`CC (Carbon Copy)` email addresses of an incoming email. + +.. example:: + When Odoo receives emails that have the name `commercial` prefix alias in the sender, recipient, + or :abbr:`CC (Carbon Copy)` email address(es) (e.g. commercial@gmail.com, commercial@odoo.net), + the database falsely treats the email as the full `commercial` alias (with a different domain), + and therefore, creates a ticket/lead/opportunity/etc. + +To add the `mail.catchall.domain.allowed` system parameter, first, activate the :ref:`developer mode +`. Then, go to :menuselection:`Settings app --> Technical --> Parameters section --> +System Parameters`. Click :guilabel:`Create`. Then, type in `mail.catchall.domain.allowed` for the +:guilabel:`Key` field. + +Next, for the :guilabel:`Value` field, add the domain(s) separated by comma(s) (if plural domains). +Manually :guilabel:`Save`, and the system parameter takes immediate effect. + +.. image:: email_servers/allowed-domain.png + :align: center + :alt: mail.catchall.domain.allowed system parameter set with key and value highlighted. diff --git a/content/applications/general/email_communication/email_servers/allowed-domain.png b/content/applications/general/email_communication/email_servers/allowed-domain.png new file mode 100644 index 0000000000000000000000000000000000000000..da7c1baaa35490393017fadab86b06ec296aa786 GIT binary patch literal 3357 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