Mailjet API

Odoo 兼容 Mailjet 的 API 用于群发邮件。通过在 Mailjet 账户和 Odoo 数据库中配置设置,设置专用的群发邮件服务器。在某些情况下,还需要在自定义域名的 DNS 设置中进行配置。

在Mailjet中设置

创建 API 凭证

要开始,请登录到 Mailjet Account Information 页面。接下来,导航到 Senders & Domains 部分,然后点击 SMTP and SEND API Settings

在Mailjet的发件人和域名部分中,可以找到SMTP和发送API设置链接。

Then, copy the SMTP configuration settings onto a notepad. They can be found under the Configuration (SMTP only) section. The SMTP configuration settings include the server address, the security option needed (Use SSL/TLS), and the port number. The settings are needed to configure Mailjet in Odoo, which is covered in the last section.

重要

Odoo blocks port 25 on Odoo Online and Odoo.sh databases.

来自Mailjet的SMTP配置。

接下来,点击标有 检索您的 API 凭据 的按钮来检索 Mailjet API 凭据。

然后,点击眼睛图标以显示 API 密钥。将此密钥复制到记事本中,因为它将作为 Odoo 配置中的 用户名。接下来,点击 生成秘密密钥 按钮以生成 秘密密钥。将此密钥复制到记事本中,因为它将作为 Odoo 配置中的 密码

添加已验证的发件人地址

下一步是将发件人地址或域名添加到Mailjet帐户设置中,以便通过Mailjet的服务器发送电子邮件时,该电子邮件地址或域名得到批准。首先,导航到 Mailjet帐户信息<https://app.mailjet.com/account> _页面。接下来,在 添加发件人域名或地址 链接下方的 发件人和域名 部分中,单击该链接。

在Mailjet界面中添加发件人域名或地址。

确定是否需要将发件人的电子邮件地址或整个域名添加到 Mailjet 设置中。如果有 DNS 访问权限,将整个域名配置为一个整体可能更容易。请参阅 添加域名 部分,了解添加域名的步骤。

注解

需要配置使用 Mailjet 服务器发送电子邮件的所有 Odoo 数据库用户的电子邮件地址,或者可以配置用户电子邮件地址的域名。

默认情况下,Mailjet帐户中最初设置的电子邮件地址将被添加为可信发件人。要添加另一个电子邮件地址,请单击标有 添加发件人地址 的按钮。然后,添加配置为从自定义域发送的电子邮件地址。

至少应在提供商中设置以下电子邮件地址,并在 Mailjet 中进行验证:

  • notifications@yourdomain.com

  • bounce@yourdomain.com

  • catchall@yourdomain.com

注解

yourdomain 替换为 Odoo 数据库的自定义域名。如果没有自定义域名,则使用 mail.catchall.domain 系统参数。

之后,填写 Email Information 表单,确保选择适当的电子邮件类型:事务性电子邮件或群发邮件。填写完表单后,会向电子邮件地址发送一封激活邮件,可以激活可信发件人。

建议在发件人的域名上设置 SPF/DKIM/DMARC 设置。

重要

如果数据库没有使用自定义域名,则需要在Odoo CRM中设置一个临时别名(使用上述三个电子邮件地址之一),以创建一个潜在客户,以便验证发件人地址。然后,数据库就能够接收验证电子邮件并验证帐户。

添加域名

通过将整个域名添加到Mailjet帐户中,与该域名相关的所有发件人地址都会自动验证,以便使用Mailjet服务器发送电子邮件。首先,导航到 Mailjet帐户信息<https://app.mailjet.com/account> _页面。接下来,在 发送者和域名 部分下,单击 添加发送者域名或地址 链接。然后,单击 添加域名 以添加自定义域名。

注解

需要将域名添加到Mailjet帐户中,然后通过 DNS 进行验证。

之后,在 Mailjet 上填写 添加新域名 页面,并点击 继续

添加域名后,将出现一个验证页面。除非Odoo数据库是在本地(在这种情况下,请选择: 选项1 ),选择 选项2:创建DNS记录 。将TXT记录信息复制到记事本中,然后转到域名的 DNS(域名系统) 提供商以完成验证。

在域名的DNS上输入的TXT记录信息。

在域名的 DNS 中进行设置

在从Mailjet帐户获取TXT记录信息后,向域的 DNS(域名系统) 添加一个TXT记录。此过程因 DNS(域名系统) 提供商而异。请咨询提供商以获取特定的配置过程。TXT记录信息包括 主机 。将它们粘贴到TXT记录的相应字段中。

返回Mailjet帐户信息

在将TXT记录添加到域名的 DNS 后,返回到Mailjet账户。然后,导航到 Account Information ‣ Add a Sender Domain or Address,点击 Domain 旁边的齿轮图标,然后选择 Validate

此操作也可以通过转到 Mailjet 账户信息的 Sender domains & addresses 页面,并点击 Manage 来完成。

接下来,点击 立即检查 来验证已添加到域名上的 TXT 记录。如果域名配置正确,将会出现一个成功的界面。

在Mailjet中检查DNS记录。

After successfully setting up the domain, there is an option to Authenticate this domain (SPF/DKIM). This button populates SPF & DKIM provider.

在Mailjet中使用SPF/DKIM记录对域名进行身份验证。

在Odoo中设置

要完成设置,请导航到Odoo数据库并转到 设置 。在打开 开发者模式 的情况下,转到 技术菜单 ‣ 电子邮件 ‣ 外发邮件服务器 。然后,通过点击 创建 按钮创建新的外发服务器配置。

Next, input the SMTP server (in-v3.mailjet.com), port number (587 or 465), and Security (SSL/TLS) that was copied earlier from the Mailjet account. They can also be found here. It is recommended to use SSL/TLS even though Mailjet may not require it.

对于 Username,输入 API KEY。对于 Password,输入之前从 Mailjet 账户复制到记事本的 SECRET KEY。这些设置可以在 Mailjet ‣ Account Settings ‣ SMTP and SEND API Settings 中找到。

然后,如果使用Mailjet服务器进行大规模邮件发送,请将 Priority 值设置为高于任何事务性电子邮件服务器。最后,保存设置并 测试连接

Odoo邮件服务器设置。

重要

为了使用 Mailjet 实现通知功能,需要在 Odoo 中设置三个参数。

  1. The From Filter needs to be set on the server configuration. It is recommended to set it as a domain and not a full email address. It should match the domain in the two proceeding steps. For more information, check out the FROM filtering documentation.

  2. 系统参数 mail.default.from 必须具有值 notifications@yourdomain.com.

  3. 系统参数 mail.default.from_filter 必须设置为 yourdomain.com。将 yourdomain 替换为 Odoo 数据库的自定义域名。如果没有自定义域名,则使用系统参数 mail.catchall.domain

For more information, check out the “Using a unique email address” documentation.

The System Parameters can be accessed by activating the Developer mode (debug mode).

Once the setup is complete, the Odoo database is ready to use the Mailjet email server for mass mailing or transactional emails.