Mailjet API

Odoo 兼容 Mailjet 的
API（应用程序编程接口）
用于批量邮件发送。通过在 Mailjet 账户和 Odoo 数据库中配置设置，可搭建专用的批量邮件服务器。在某些情况下，还需在自定义域名的 DNS（域名系统） 设置中进行配置。

首先，登录 Mailjet 账户信息 页面。随后，进入 发送者 & 域名 部分，点击 SMTP 和 SEND API 设置。

接着，将 SMTP（简单邮件传输协议） 配置设置复制到记事本。它们位于 配置（仅 SMTP） 区域。SMTP 配置包括服务器地址、所需的安全选项（使用 SSL（安全套接字层）/TLS（传输层安全））以及端口号。这些设置将在后文 最后一节 <maintain/mailjet-api/odoo-setup> 中用于在 Odoo 中配置 Mailjet。

::: seealso Mailjet：如何配置我的 SMTP 参数？ :::

:::: important ::: title 重要提示 :::

Odoo 在 Odoo Online 和 Odoo.sh 数据库上 阻止 25 端口 <email-outbound-port-restriction>。 ::::

随后，点击 检索您的 API 凭证 按钮以获取 Mailjet API 凭证。

点击眼睛图标显示 API key，将该键复制到记事本，作为 Odoo 配置中的 用户名。再点击 生成 Secret Key 按钮生成 Secret Key，复制到记事本，作为 Odoo 配置中的 密码。

下一步是在 Mailjet 账户设置中添加发件人地址或域名，使其获得使用 Mailjet 服务器发送邮件的授权。首先，访问 Mailjet 账户信息 页面，然后在 发送者 & 域名 部分点击 添加发送者域名或地址 链接。

判断是需要添加单个发件人邮箱还是整个域名。如果可以访问 DNS（域名系统），配置整个域名会更方便。有关添加域名的步骤，请参阅 添加域名 <maintain/mailjet-api/add-domain> 部分。

:::: note ::: title 说明 :::

要么为所有使用 Mailjet 服务器发送邮件的 Odoo 数据库用户的邮箱地址逐一配置，要么统一配置这些用户邮箱所属的域名。 ::::

默认情况下，Mailjet 账户中最初设置的邮箱会被添加为受信任的发件人。若要添加其他邮箱，点击 添加发件人地址 按钮，然后填写使用自定义域名发送的邮箱地址。

至少应在提供商处设置并在 Mailjet 中验证以下邮箱：

:::: note ::: title 说明 :::

将 [yourdomain] 替换为 Odoo 数据库使用的自定义域名；若没有自定义域名，可使用系统参数 mail.catchall.domain。 ::::

随后，填写 邮件信息 表单，选择合适的邮件类型：事务邮件或批量邮件。完成表单后，系统会向该邮箱发送激活邮件，激活后即可将其设为受信任的发件人。

强烈建议在发件人所在域名上配置 SPF（发件人策略框架） / DKIM（域名密钥识别邮件） / DMARC（基于域的消息认证、报告与一致性）。

::: seealso

:::: important ::: title 重要提示 :::

如果数据库未使用自定义域名，则需在 Odoo CRM 中创建一个临时别名（上述三个邮箱之一），生成线索，以接收验证邮件并完成验证。 ::::

将整个域名添加到 Mailjet 账户后，所有与该域名关联的发件人地址均会自动获得使用 Mailjet 服务器发送邮件的验证。步骤如下：

  1. 访问 Mailjet 账户信息 页面。
  2. 在 发送者 & 域名 部分点击 添加发送者域名或地址 链接。
  3. 点击 添加域名，输入自定义域名。

:::: note ::: title 说明 :::

域名需先在 Mailjet 账户中添加，然后通过 DNS（域名系统） 完成验证。 ::::

在 Mailjet 中填写 添加新域名 页面后点击 继续。

添加域名后，会出现验证页面。若 Odoo 数据库为本地部署（on‑premise），请选择 选项 1；否则选择 选项 2：创建 DNS 记录。将 TXT 记录信息复制到记事本，然后前往域名的 DNS（域名系统） 提供商处完成验证。

从 Mailjet 获取的 TXT 记录信息包括 Host 与 Value 两项。将其粘贴到 DNS 提供商对应的 TXT 记录字段中。具体操作因 DNS 提供商而异，请参考其文档。

在域名 DNS 中添加 TXT 记录后，返回 Mailjet 账户，进入 账户信息 → 添加发送者域名或地址，点击域名旁的齿轮图标，选择 验证。

同样可以在 发送者域名 & 地址 页面点击 管理，然后点击 立即检查，验证 TXT 记录。若域名配置正确，将出现成功提示。

域名验证成功后，可点击 认证此域名（SPF/DKIM），系统会生成对应的 SPF 与 DKIM 记录，供在 DNS 提供商处填写。

::: seealso Mailjet 的 SPF/DKIM/DMARC 文档 :::

完成所有配置后，登录 Odoo 数据库，进入 设置。开启 开发者模式，进入 技术菜单 → 邮件 → 外发邮件服务器，点击 创建 按钮新建外发服务器配置。

填写之前从 Mailjet 复制的 SMTP 服务器（in-v3.mailjet.com）、端口号（587 或 465）以及 安全选项（SSL/TLS）。即使 Mailjet 并不强制要求，也建议使用 SSL（安全套接字层） 或 TLS（传输层安全）。

  • 用户名：填写 API KEY。
  • 密码：填写 SECRET KEY。

这些信息可在 Mailjet → 账户设置 → SMTP 和 SEND API 设置 中找到。

若 Mailjet 服务器用于批量邮件发送，请将 优先级 设置高于任何事务邮件服务器。完成后保存设置，并点击 测试连接。