Skip to main content
使用 SMTP 中继，从您的电子邮件客户端或应用程序发送事务性邮件（订单确认、密码重置、账户创建通知和其他自动消息）。 EffiLink 提供标准 SMTP 接口，让您可以从任何支持 SMTP 的应用、框架或邮件库发送邮件，无需修改现有的邮件发送代码。只需将 SMTP 客户端指向 EffiLink 的服务器，使用 API 密钥进行认证，邮件即可通过 EffiLink 的投递基础设施进行路由。 SMTP 非常适合旧版应用、CMS 平台以及任何不方便切换到 REST API 的环境。

​
连接设置

1、根据您所在地域选择就近节点： 中国大陆：
港澳台及海外地区（不包括欧盟）：
欧盟地区：
2、在 SMTP 客户端或应用中使用以下设置： 用户名和密码： 您可以使用账户下任意有效的 API 密钥 作为 SMTP 密码。由于 API 密钥本身即可完成认证，EffiLink 不依赖 SMTP 用户名进行请求认证。建议使用您 EffiLink 账户的主要联系邮箱作为用户名。 端口：
  • 非加密连接： 使用端口 1026 或 1027
  • 加密连接（SSL/TLS）： 使用端口 4026 或 4027
您可能还需要一个发送域名（例如 mail.example.com）。详见发件人域名管理。

​
SMTP 响应码

您的每次 SMTP 调用都会返回一个响应码：
  • 2xx — 成功： 邮件已被接收并接受投递。
  • 4xx — 临时错误： 出现暂时性错误，可稍后重试。
  • 5xx — 永久错误： 出现永久性错误，请勿继续投递。
收件人地址格式规则： @ 号之前的本地部分：
  • 可包含数字、大小写字母，以及 .!#$%&'*+/=?^_\{|}~-` 等符号。
  • 只能以字母或数字开头。
  • 点号不能连续出现，且不能位于末尾。
@ 号之后的域名部分：
  • 可包含数字、大小写字母、. 和 -。
  • 只能以字母或数字开头和结尾。
  • 点号和连字符不能连续出现。

​
使用 X-Easeye-* 头的 SMTP 扩展

EffiLink 支持自定义 SMTP 头，让您无需离开 SMTP 工作流即可使用平台功能（跟踪、分类、优先级和消息过期）。

​
X-Easeye-API

传入 JSON 载荷以配置跟踪、分类、活动标签、优先级和自定义跟踪域名。

​
X-Easeye-UniqueMsgID

作为发送方维度的邮件唯一标识，用于消息去重和跟踪。最大长度 50 字节；仅允许大小写字母、数字和连字符。

​
X-Easeye-ExpirationDate

设置邮件投递过期时间。若在此时间前尚未成功投递，EffiLink 将停止尝试并返回过期状态。格式：yyyy-MM-dd HH:mm:ss，时区为东八区（北京时间）。

​
使用 X-Easeye-* 头的完整示例