Mailjet API¶
Odoo 与 Mailjet 的:abbr:`API（应用程序编程接口）`兼容，可用于邮件群发。通过在 Mailjet 账户和 Odoo 数据库中配置设置，通过 Mailjet 建立专用的邮件群发服务器。在某些情况下，还需要在自定义域名的 :`DNS（域名系统）`设置中进行配置。
在 Mailjet 中设置¶
创建应用程序接口证书¶
要开始操作，请登录 Mailjet 帐户信息 <https://app.mailjet.com/account>`_页面。然后，导航到 :guilabel:`发件人及域名 部分，点击 SMTP 和 SEND API 设置。
然后，将 SMTP （简单邮件传输协议） 配置设置复制到记事本中。这些设置可在 配置（仅限 SMTP） 部分找到。SMTP（简单邮件传输协议） 配置设置包括服务器地址、所需的安全选项（使用 SSL（安全套接字层）/TLS（传输层安全））和端口号。在 Odoo中配置 Mailjet 需要这些设置，在:ref:`最后一节<maintain/mailjet-api/odoo-setup>`中有介绍。
重要
接下来，单击标有 检索您的应用程序接口证书 的按钮，以检索 Mailjet API 凭据。
然后，点击眼睛图标，显示 API key。将此密钥复制到记事本中，作为 Odoo 配置中的 用户名。接下来，点击 Generate Secret Key 按钮生成 密钥 。将此密钥复制到记事本中，作为 Odoo 配置中的 密钥。
添加已核实的发件人地址¶
下一步是在 Mailjet 帐户设置中添加发件人地址或域，以便电子邮件地址或域获准使用 Mailjet 服务器发送电子邮件。首先，导航到 Mailjet 帐户信息 <https://app.mailjet.com/account>`_页面。然后，单击 :guilabel:`发件人和域名 部分下的 添加发件人域名或地址 链接。
确定是否需要将发件人的电子邮件地址或整个域添加到 Mailjet 设置中。如果 DNS 访问权限可用，则配置整个域可能更容易。跳转到 Add a domain 部分了解添加域的步骤。
備註
要么配置使用 Mailjet 服务器发送电子邮件的所有 Odoo 数据库用户的电子邮件地址，要么可以配置用户电子邮件地址的域名。
默认情况下，最初在 Mailjet 账户中设置的电子邮件地址会被添加为受信任发件人。要添加另一个电子邮件地址，请单击标有 添加发件人地址 的按钮。然后，添加配置为从自定义域发送的电子邮件地址。
至少应在提供商中设置以下电子邮件地址，并在 Mailjet 中进行验证：
notifications@yourdomain.com
bounce@yourdomain.com
catchall@yourdomain.com
備註
将 yourdomain 替换为 Odoo 数据库的自定义域。如果没有，则使用 mail.catchall.domain 系统参数。
然后，填写 电子邮件信息 表单，确保选择适当的电子邮件类型：交易电子邮件或群发电子邮件。填写表格后，系统会向该电子邮件地址发送一封激活电子邮件，然后即可激活受信任的发件人。
建议在发件人的域上设置 SPF（发件人策略框架）/: abbr:DKIM（域密钥识别邮件）/DMARC（基于域的消息验证、报告和一致性）。
重要
如果数据库没有使用自定义域，那么为了验证发件人地址，应在 Odoo CRM 中设置一个临时别名（上述三个电子邮件地址）来创建线索。然后，数据库就能接收验证电子邮件并验证账户。
添加域名¶
将整个域添加到 Mailjet 帐户后，与该域相关的所有发件人地址都会自动验证，以便使用 Mailjet 服务器发送电子邮件。首先，导航到 Mailjet 帐户信息 <https://app.mailjet.com/account>`_页面。然后，单击 :guilabel:`发件人和域名 部分下的 添加发件人域名或地址 链接。然后，点击:guilabel:添加域名 添加自定义域名。
備註
域名需要添加到 Mailjet 账户，然后通过:abbr:`DNS（域名系统）`进行验证。
然后，在 Mailjet 上填写 添加新域名 页面，并单击 继续。
添加域名后，将弹出一个验证页面。除非 Odoo 数据库是内部数据库（在这种情况下，请选择 选项 1），否则请选择 选项 2: 创建 DNS 记录。将 TXT 记录信息复制到记事本，然后导航到域名的 DNS （域名系统） 提供商完成验证。
在域名的 DNS 中设置¶
从 Mailjet 账户获取 TXT 记录信息后，向域名的 DNS （域名系统） 添加 TXT 记录。此过程因:abbr:DNS（域名系统） 提供商而异。具体配置过程请咨询提供商。TXT 记录信息由 主机 和 值 组成。将这些信息粘贴到 TXT 记录的相应字段中。
返回 Mailjet 账户信息¶
将 TXT 记录添加到域名的 DNS（域名系统）`后，返回 Mailjet 帐户。然后，导航至 :menuselection:`账户信息 –> 添加发件人域名或地址，单击 域名 旁边的齿轮图标，并选择 验证。
要执行此操作，也可进入 Mailjet 账户信息中的`发送域和地址 <https://app.mailjet.com/ account/sender>`_页面，然后单击 管理。
接下来，单击:guilabel:立即查看 以验证域上添加的 TXT 记录。如果域配置正确，将显示成功屏幕。
成功设置域后，可选择:guilabel:验证此域（SPF/DKIM）。此按钮会填充 :abbr:`SPF （发件人策略框架）`和 :abbr:`DKIM （域名密钥识别邮件）记录，以便输入到 :abbr:`DNS （域名系统）`提供商。
在 Odoo 中设置¶
要完成设置，请导航至 Odoo 数据库并转至 设置。打开 开发者模式 后，进入 。然后，点击 创建 按钮创建新的外发服务器配置。
接着，输入先前从 Mailjet 账户复制的`SMTP 服务器`（in-v3.mailjet.com）、端口号`（587 或 465）和`安全性（SSL/TLS）。也可在此处 <https://app.mailjet.com/account/setup>`_ 找到。建议使用 SSL（安全套接字层）/: abbr:TLS（传输层安全），即使 Mailjet 可能不需要它。
对于 用户名，输入 API KEY。对于 密码，输入之前从 Mailjet 账户复制到记事本的 SECRET KEY。这些设置可在 中找到。
然后，如果 Mailjet 服务器用于群发邮件，则将 优先 值设置为高于任何事务性电子邮件服务器的值。最后，保存设置并 测试连接。
重要
为了让 Mailjet 的通知功能正常工作，需要在 Odoo 中进行三个设置。
需要在服务器配置中设置 From Filter。建议将其设置为域而不是完整的电子邮件地址。它应与接下来两个步骤中的域相匹配。更多信息，请查阅 FROM filtering 说明文档。
mail.default.from`系统参数的值必须是`notifications/@yourdomain.com。
系统参数 mail.default.from_filter 的值必须为
yourdomain.com。将yourdomain替换为 Odoo 数据库的自定义域名。如果没有，则使用 mail.catchall.domain 系统参数。
有关详细信息，请查看 “使用唯一电子邮件地址” 说明文档。
通过激活 开发者模式 可以访问 系统参数。
设置完成后，Odoo 数据库就可以使用 Mailjet 电子邮件服务器发送群发邮件或事务性电子邮件了。