Mailjet API

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

在Mailjet中设置

创建 API 凭证

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

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

然后,将 SMTP 配置设置复制到记事本中。这些设置可以在 Configuration (SMTP only) 部分找到。SMTP 配置设置包括服务器地址、所需的安全选项(使用 SSL/TLS)和端口号。这些设置是配置 Odoo 中的 Mailjet 所需的,具体内容请参考 last section

重要

Odoo 在 Odoo Online 和 Odoo.sh 数据库上阻止 port 25 端口。 在这里查看参考文档

来自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记录。

成功设置域名后,有一个选项可以 验证此域名 (SPF/DKIM)。此按钮会填充 SPFDKIM 记录,以输入到 DNS 提供商中。

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

在Odoo中设置

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

接下来,输入从Mailjet帐户中复制的`SMTP服务器`(in-v3.mailjet.com),端口号`(587或465),以及`安全性(SSL/TLS)。它们也可以在`这里 <https://app.mailjet.com/account/setup>`_找到。建议使用:abbr:SSL(安全套接字层) / TLS(传输层安全) 即使Mailjet可能不需要。

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

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

Odoo邮件服务器设置。

重要

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

  1. 需要在服务器配置中设置 From Filter。建议将其设置为域名而不是完整的电子邮件地址。它应该与前两个步骤中的域名匹配。更多信息可以参考 这里

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

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

更多信息请参阅 使用默认电子邮件地址

可以通过在“设置 –> 技术 –> 参数 –> 系统参数”菜单中激活:doc:../../applications/general/developer_mode`来访问:guilabel:`系统参数

设置完成后,Odoo数据库已准备好使用Mailjet电子邮件服务器进行大规模邮件或交易邮件!