Comment gérer les messages sortants¶

Sending emails with Odoo’s default configuration¶

On Odoo Online and Odoo.sh, sending and receiving emails works out of the box. No configuration is required.

When a database is created, the subdomain company-name.odoo.com is used to send and receive emails. The deliverability is optimized for this subdomain as it uses Odoo’s DNS configuration.

Emails are sent with catchall@company-name.odoo.com as the reply-to address. In addition, delivery errors are sent to bounce@company-name.odoo.com.

Using a custom domain to send emails¶

The database can be configured to use a custom domain, in which case all default email addresses are built using the custom domain. If the custom domain is company-name.com, the sender address will be notifications@company-name.com, the reply-to address catchall@company-name.com, and the bounce address bounce@company-name.com. The custom domain can be utilized when sending emails either with Odoo’s email servers or an external one.

This section assumes ownership of a custom domain. If not, a custom domain must be purchased from a domain registrar such as GoDaddy, Namecheap, or any alternative provider.

Using a custom domain with Odoo’s email server¶

On Odoo Online or Odoo.sh, some configurations are mandatory in the custom domain’s DNS to ensure good deliverability.

The first step is to configure the SPF and DKIM to be compliant with Odoo’s mail server.

Next, the custom domain must be set as the alias domain of a company. Select the company, open the Settings, and add the custom domain under the Alias Domain field.

After adding the alias domain, click the (internal link) icon to assign more companies to the custom domain if needed. Enable the Developer mode (debug mode) mode to modify the default aliases if desired:

• Bounce Alias: the mailbox used to catch delivery errors and populate the red envelope on the corresponding message.

• Catchall Alias: the default mailbox used to centralize all replies.

• Default From Alias: the default sender address.

All email aliases (e.g., related to CRM or Helpdesk teams) must have their corresponding mailbox in the custom domain mail server.

To receive emails in the Odoo database within the corresponding chatter (CRM, invoices, sales orders, etc.), one of these three methods must be used:

• Redirections/forwarding,

• Incoming mail servers,

• MX record (requires advanced technical knowledge)

Using a custom domain implies that specific local-parts might be used by Odoo to send emails.

Sending emails with an external SMTP server¶

To add an external SMTP server in Odoo, open Settings, and enable the Use Custom Email Servers option found under the Discuss section.

Still under the Discuss section, click Outgoing Email Servers, then New to create an outgoing mail server record. Most fields are the common parameters used to set up a connection to an SMTP server; use the values provided by your email provider.

Once completed, click Test Connection. Note that a successful test connection does not confirm that the email will go out as some restriction might remain on the provider side, thus, it is recommended to consult your provider’s documentation.

Local-part values¶

Below are presented the different local-part values that can be used by Odoo to send emails. It might be required to whitelist them in your mail server:

• The Alias Domain Bounce Alias (default value = bounce),

• The Alias Domain Default From (default value = notifications),

• The default admin address admin@company-name.odoo.com or, if changed, the new value),

• The default Odoobot address odoobot@company-name.odoo.com or, if changed, the new value),

• The specific FROM defined on an email marketing campaign,

• The specific FROM that can be defined in an email template.

Setting up different servers for transactional and mass emails¶

Personalized mail servers¶

Transactional emails and mass mailings can be sent using separate email servers in Odoo. Doing so means day-to-day emails, quotations, or invoices sent to clients will be handled as transactional emails. Mass mailing emails, including the sending of batches of invoices or quotations, will be managed by the Marketing Automation or Email Marketing application.

First, activate the Developer mode (debug mode) and go to Settings ‣ Technical ‣ Email: Outgoing Mail Servers. There, add two outgoing email server records, one for the transactional emails server and one for the mass mailings server. Enter a lower Priority value for the transactional server (e.g., 1) over the mass mailings server (e.g., 2) so transactional emails are given priority.

Now, go to Email Marketing ‣ Configuration ‣ Settings, enable Dedicated Server, and select the appropriate email server. Odoo uses the server with the lowest priority value for transactional emails, and the server selected here for mass mailings.

FROM filtering¶

The FROM Filtering field allows for the use of a specific outgoing email server depending on the From email address or domain that Odoo is sending on behalf of. The value must be a domain or a complete address that matches the sender’s email address and is trusted on the outgoing mail server provider’s side.

If FROM filtering is not used, emails will go out using the notification address.

When an email is sent from Odoo, the following sequence is used to choose the outgoing email server:

• First, Odoo searches for a server that has the same FROM filtering value as the From value (i.e., email address) defined in the outgoing email. This configuration is ideal if all users of a company share the same domain but have different local-parts.

• If no server is found based on the first criteria, Odoo looks for the first server without a FROM filtering value set. The email will be overridden with the notification address.

• If no server is found based on the second criteria, Odoo uses the first server, and the email will be overridden with the notification address.

It is also possible to use Odoo’s mail server for transactional emails in addition to mass mailings.

Using an external email server and Odoo’s default server¶

On Odoo Online and Odoo.sh, databases are started with Odoo’s SMTP server. If no outgoing mail server is set, the default Odoo’s SMTP server will be used.

Using a custom domain with an external email server¶

Similar to the previous chapter, proper configuration might be needed to ensure that the external email server is allowed to send emails using your custom domain. Refer to your provider’s documentation to properly set up the relevant records (SPF, DKIM, and DMARC). A list of the most common providers is available.

Restriction de port¶

Port 25 is blocked for security reasons on Odoo Online and Odoo.sh. Try using port 465, 587, or 2525 instead.

Domaine d’alias¶

The catchall domain is company-specific. By default, all companies share Odoo’s subdomain (e.g., company-name.odoo.com), but each company may have its own custom email domain.

When the Developer mode (debug mode) is activated, the alias domain options are available by going to Settings ‣ Technical ‣ Email: Alias Domains.

The Default From Alias field can be filled with a local-part of the email address (by default notifications) or a full email address. Configure it to determine the FROM header of your emails. If a full email address is used, all outgoing emails will be overwritten with this address.

Notification system¶

When an email is sent from the chatter, customers can reply directly to it. If a customer replies directly to an email, the answer is logged in the same chatter, thus functioning as a message thread related to the record.

Upon receiving the reply, Odoo then uses the subscribed followers (based on the subscribed subtypes) to send them a notification by email, or in the Odoo inbox, depending on the user’s preferences.

Using a unique email address for all outgoing emails¶

To force the email address from which emails are sent, activate the Developer mode (debug mode), and go to Settings ‣ Technical ‣ Email: Alias Domains. On the Default From Alias, use the the local-part or a complete email address as the value.