基本概念

SendCloud服务机制

SendCloud 为用户提供了 SMTP 和 WEBAPI 两种调用接口的方式, 用户可以根据业务场景或个人喜好选择任一方式接入


邮件类型

触发邮件: 在某种场景下, 由事件触发的邮件发送. 比如: 注册激活, 密码找回, 站内通知, 信息确认, 账单寄送等.

批量邮件: 商家对会员发送的通知邮件. 比如: 新功能上线, 打折优惠等.

注意: SendCloud 要求收件地址来源自会员注册, 发送内容是用户主动订阅, 且不带有广告营销性质.


通过SMTP接入

使用 SMTP 协议传输数据到 SendCloud 的邮件服务器 ( smtp.sendcloud.net:25 smtpcloud.sohu.com:25 )


通过 WEBAPI 接入

WEBAPI 是使用 HTTP 接入 SendCloud 服务的一种方式. 用户可以利用 SendCloud 提供的 HTTP 接口, 调用 SendCloud 的服务.

目前 WEBAPI 提供了邮件发送 , 域名查询, 个人信息, 地址列表 (CRUD), 统计查询, 标签 (CRUD), 退信列表 (CRUD), 取消订阅列表 (CRUD) 等功能.

用户只需要选择熟悉的开发语言, 实现客户程序, 就可以方便地和 SendCloud 进行通信.


API_USER

API_USER 是调用接口发信时的帐号

SendCloud 为新用户生成了「测试 API_USER」, 方便用户测试发送. 使用测试 API_USER 发信, 每天的上限是200封, 即使是收费用户


API_KEY

API_KEY 是调用接口发信时的密码


发信域名

发信域名是一封邮件的出处. 在 SMTP 会话过程中, 即是 mail from 的后缀

mail from: test@liubida.cn
250 sender test@liubida.cn OK

如上所示, liubida.cn 就是这封邮件的发信域名. 发信域名的概念很重要, 因为很多 ESP ( 邮件服务器 ) 就是根据发信域名来确定发信的频度, 每天发信的数量等重要指标的.

SendCloud 为新用户生成了「测试域名」, 方便用户测试发送. 测试域名的命名规则: '随机串.sendcloud.org'. 使用测试域名发信, 每天的上限是200封, 即使是收费用户

当用户正式接入服务时, 需要在 SendCloud 平台上配置自己的发信域名

正式接入 SendCloud 平台的用户, 应该拥有自己服务的域名 ( 比如 liubida.cn ) 你也可以使用 liubida.cn 的子域来作为自己的发信域名 ( 比如 push.liubida.cn )

你可以通过【设置】-【域名】-【新增发信域名】来创建自己的发信域名

注意, 已经配置MX记录的域名不建议配置成发信域名, 你可以使用其子域名来进行配置.

下面列举了使用不同发信域名的邮件示例:

使用测试域名: W0YoeJHepAzA7v1JDuG6e8reehqEuPoP.sendcloud.org 发送的邮件 pic

 * 前缀: beb31150-bef0-11e4-9dbb-00163e15002f
 * 发信域名: W0YoeJHepAzA7v1JDuG6e8reehqEuPoP.sendcloud.org
 * mail from的组成: 前缀@发信域名 (beb31150-bef0-11e4-9dbb-00163e15002f@W0YoeJHepAzA7v1JDuG6e8reehqEuPoP.sendcloud.org)

使用自有域名 ( 自己创建的域名 ) : push.liubida.cn 发送的邮件 pic

 * 前缀: 98a47302-beee-11e4-a3b9-00163e12fa99
 * 发信域名: push.liubida.cn
 * mail from的组成: 前缀@发信域名(98a47302-beee-11e4-a3b9-00163e12fa99@push.liubida.cn)

邮件中为什么会显示代发?


发信域名配置

创建发信域名之后, 需要完成必要的配置, 才能使用其进行发信. 这些配置项是保证域名能够优质出信的基础, 如果使用未配置的域名发信, 出信量和到达率都会很糟糕.

VERIFY_KEY 是 SendCloud 分配给每个账户的域名唯一标示, 防止域名被其他账户盗用.

SPF 是为了防范垃圾邮件而提出来的一种 DNS 记录类型, 用于登记某个域名拥有的外发邮件的所有 IP 地址

MX 是邮件交换记录, 它指向一个邮件服务器, 用于电子邮件系统发邮件时根据收信人的地址后缀来定位邮件服务器

CNAME 是链接跳转记录. SendCloud 需要此配置项来收集点击数据.

CNAME 是选配项. 如果不配置, SendCloud 只能为你收集打开和退订数据. 只有在配置此项之后, SendCloud 才能为你收集用户的点击数据.

DKIM 是防止欺诈邮件的一个重要技术手段, 通常发送方会在电子邮件的标头插入 DKIM-Signature 及电子签名资讯, 而接收方则透过 DNS 查询得到公钥后进行验证. 建议配置, 特别是国外域比较多的用户.

注意: 正是因为发信域名如此的重要, 所以 SendCloud 要求用户必须创建自己的发信域名, 并且完成配置, 才能正式接入

我们在系统中给出了详细的配置引导, 用户需要按照配置引导的内容到自己的域名管理系统中去做配置. 以下举例说明:

pic

  1. 标注红星, 表示此项配置为必配项
  2. 状态: 是否配置正确, 并通过 SendCloud 验证.
  3. 类型: 此项属于域名配置的哪一种类型. 比如 TXT, MX, CNAME 等类型.
  4. 需配置的记录值: SendCloud 引导用户需要配置的值
  5. 现有记录值: SendCloud 查询得到的记录值. ( 用户需要在自己的域名管理系统中做配置, 使现有记录值需配置的记录值匹配)

邮件模板 (template)

20150707 SendCloud 平台更新: 模板和样本功能合二为一. 新建模板时增加字段: 邮件标题, 模板类型.

创建模板流程如下:

  1. 用户根据邮件标题、邮件内容和模板类型创建模板
  2. 创建成功后, 用户就可以使用此模板发送邮件

同时, 邮件模板也是一个方便用户发送邮件的功能. 用户编辑/上传邮件模板后, 在请求接口时, 不需要再传输邮件内容, 只需在参数中指定模板的「调用名称」即可.

用户可以通过【发送相关】-【邮件模板】来创建【邮件模板】

注意: 用户可以调用模板发送, 也可以普通发送(上传内容发送). 两种发送方式都要求最终的内容和至少一个模板匹配


变量替换

SendCloud 支持在邮件中使用「变量」.

变量的格式: 首尾使用 % 包含, 即为用户定义的一个变量. 举例:

亲爱的%name%: # name是变量

    欢迎注册爱发信, 这是您的验证码: %active_code%. # active_code是变量

变量的用法:

  1. 普通发送, 模板发送 中使用变量, 来作为占位符
  2. 地址列表, X-SMTPAPI 中设置变量的值
  3. SendCloud 会根据不同收件人, 来替换邮件内容中相应变量的值

注意: 邮件标题中可以含有一个变量 20150707 更新


当天请求额度

用户每天能够请求的额度值, 即每天能够发送给 SendCloud 的最大邮件数量.

用户请求超过此值时, 用户会收到 'Request quota exceeded' 的错误提示.

**注意: SendCloud 当天成功接收的邮件请求, 并不一定能够在当天发送完毕. 部分邮件可能会处于发送 - 暂停 - 发送 - 暂停的队列状态, 这样的队列状态可能会持续数日.


信誉度

用户在 SendCloud 平台的信誉评分. 「信誉度」和「当天请求额度」是高度正相关的两个数值. 当信誉度小于 0 时, 当天请求额度为 0 .

此评分是由 SendCloud 根据用户的邮件发送数据实时计算出来的

注意: 短时间内「无效地址」,「垃圾举报」的激增会直接导致信誉度减为负数 , 用户无法继续请求.


用户认证

用户在正式接入 SendCloud 之前, 必须完成一些信息的认证. SendCloud 目前提供了个人用户企业用户两种认证方式.

个人用户

企业用户

SendCloud 平台希望用户接入之前, 已经完成商业网站的域名申请和备案.

如果用户没有商业网站域名, 则该用户不能升级成为付费用户.

个人用户的当天请求额度初始值为1000, 企业用户的当天请求额度初始值为3000