Mailjet API¶
Odoo 兼容 Mailjet 的 API 用于群发邮件。通过在 Mailjet 账户和 Odoo 数据库中配置设置,设置专用的群发邮件服务器。在某些情况下,还需要在自定义域名的 DNS 设置中进行配置。
在Mailjet中设置¶
创建 API 凭证¶
要开始,请登录到 Mailjet Account Information 页面。接下来,导航到 Senders & Domains 部分,然后点击 SMTP and SEND API Settings。
然后,将 SMTP(简单邮件传输协议) 配置设置复制到记事本中。这些设置可以在 配置(仅限 SMTP) 部分找到。SMTP(简单邮件传输协议) 配置设置包括服务器地址、所需的安全选项(使用 SSL(安全套接字层)/TLS(传输层安全))以及端口号。这些设置用于在 Odoo 中配置 Mailjet,相关内容将在 最后一节 中介绍。
重要
Odoo 在 Odoo Online 和 Odoo.sh 数据库上 阻止了端口 25。
接下来,点击标有 检索您的 API 凭据 的按钮来检索 Mailjet API 凭据。
然后,点击眼睛图标以显示 API 密钥。将此密钥复制到记事本中,因为它将作为 Odoo 配置中的 用户名。接下来,点击 生成秘密密钥 按钮以生成 秘密密钥。将此密钥复制到记事本中,因为它将作为 Odoo 配置中的 密码。
添加已验证的发件人地址¶
下一步是将发件人地址或域名添加到Mailjet帐户设置中,以便通过Mailjet的服务器发送电子邮件时,该电子邮件地址或域名得到批准。首先,导航到 Mailjet帐户信息<https://app.mailjet.com/account>
_页面。接下来,在 添加发件人域名或地址 链接下方的 发件人和域名 部分中,单击该链接。
确定是否需要将发件人的电子邮件地址或整个域名添加到 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 中进行设置¶
在从Mailjet帐户获取TXT记录信息后,向域的 DNS(域名系统) 添加一个TXT记录。此过程因 DNS(域名系统) 提供商而异。请咨询提供商以获取特定的配置过程。TXT记录信息包括 主机 和 值 。将它们粘贴到TXT记录的相应字段中。
返回Mailjet帐户信息¶
在将TXT记录添加到域名的 DNS 后,返回到Mailjet账户。然后,导航到 Domain 旁边的齿轮图标,然后选择 Validate。
,点击此操作也可以通过转到 Mailjet 账户信息的 Sender domains & addresses 页面,并点击 Manage 来完成。
接下来,点击 立即检查 来验证已添加到域名上的 TXT 记录。如果域名配置正确,将会出现一个成功的界面。
在成功设置域名后,有一个选项是 验证此域名 (SPF/DKIM)。此按钮会生成 SPF 和 DKIM 记录,以便输入到 DNS 提供商中。
在Odoo中设置¶
要完成设置,请导航到Odoo数据库并转到 设置 。在打开 开发者模式 的情况下,转到 。然后,通过点击 创建 按钮创建新的外发服务器配置。
接下来,输入从 Mailjet 账户中复制的 SMTP 服务器
(in-v3.mailjet.com)、端口号
(587 或 465) 和 安全性 (SSL/TLS)
。 这些信息也可以在 此处 找到。 建议使用 SSL/TLS,即使 Mailjet 可能不要求这样做。
对于 Username,输入 API KEY。对于 Password,输入之前从 Mailjet 账户复制到记事本的 SECRET KEY。这些设置可以在 中找到。
然后,如果使用Mailjet服务器进行大规模邮件发送,请将 Priority 值设置为高于任何事务性电子邮件服务器。最后,保存设置并 测试连接 。
重要
为了使用 Mailjet 实现通知功能,需要在 Odoo 中设置三个参数。
需要在服务器配置中设置 From Filter。建议将其设置为域名,而不是完整的电子邮件地址。它应与接下来的两个步骤中的域名匹配。有关更多信息,请查看 FROM 过滤文档。
系统参数 mail.default.from 必须具有值
notifications@yourdomain.com
.系统参数 mail.default.from_filter 必须设置为
yourdomain.com
。将yourdomain
替换为 Odoo 数据库的自定义域名。如果没有自定义域名,则使用系统参数 mail.catchall.domain。
更多信息,请查看 “使用唯一电子邮件地址”文档。
可以通过激活 开发者模式(调试模式) 来访问 System Parameters 。
设置完成后,Odoo 数据库即可使用 Mailjet 邮件服务器进行群发邮件或事务性邮件。