Dmartech售后客服 发表于 2021年07月07日 14:41 最后修改于 2021年07月08日 10:07
平台常用的接口如下，其中黄色高亮的是完成邮件发送流程需要用的接口。
根据发送的时候时候是大批量发送还是发送单个（或若干个）邮箱，发送流程略有不同。这里假设平台上已经创建了活动和发件人地址，因此活动ID和发件人地址ID信息已获取。
如何创建活动可参见 https://webpower.kf5.com/posts/view/82330/
创建发件人地址请到设置-->通用-->发件人地址页面创建。
大批量发送一般适用于营销邮件发送场景，比如活动通知，折扣发放等。
大批量的发送流程主要分为以下四步，列出了每步对应的接口。
1) 创建联系人组，addGroup
2) 上传联系人到联系人组， addRecipients 或 importRemoteCSV
3) 创建邮件素材，createMailing
4) 发送邮件，sendMailing
请注意，步骤3）和步骤2）没有前后关系，顺序可以调整。
2）和4）添加联系人到组以及发送邮件平台提供了合成了这两步的接口： importRemoteCSVSendMailing，因此可以发送流程亦简化为
1) 创建联系人组，addGroup
2) 创建邮件素材，createMailing
3) 上传联系人到联系人组并发送邮件importRemoteCSVSendMailing
单个邮箱发送（单发）一般适用于系统触发类邮件发送，比如密码找回，发货通知等。
单发的发送流程主要以下4步，列出了每步对应的接口。
1) 创建联系人组，addGroup
2) 添加联系人到联系人组，addRecipient 或 addRecipients
3) 创建素材，createMailing
4) 发送邮件 sendSingleMailing
请注意，步骤3）创建素材和步骤2）没有前后关系，顺序可以调整。
2）和4）添加联系人到组以及发送邮件平台提供了合成了这两步的接口： addRecipientsSendMailing，因此可以发送流程亦简化为
1) 创建联系人组，addGroup
2) 创建素材，createMailing
3) 上传联系人并发送，addRecipientsSendMailing
总结上述发送接口调用流程如下：
发送场景 | 发送接口调用方案一 | 发送接口调用方案二 |
营销邮件发送/批量发送 | 01 addGroup 02 addRecipients，或 importRemoteCSV createMailing 03 sendMailing | 01 addGroup 02 createMailing 03 importRemoteCSVSendMailing |
系统邮件发送/单个发送 | 01 addGroup 02 addRecipient，或 addRecipients 03 createMailing 04 sendSingleMailing | 01 addGroup 02 createMailing 03 addRecipientsSendMailing |
获取邮件发送统计数据 | getMailingStatsSummary | 获取已正式发送邮件的统计报告 |
获取邮件发送后的打开点击数据 | getMailingResponse | 获取的时间范围不限 |
获取邮件发送后的弹回数据 | getMailingBounce | 获取时间指定某一天的弹回 |
其他注意事项:
1. addRecipients接口可以添加1-1000个联系人，因此可以用于少量群发或者单发，如果群发送数量比较大，比如一万以上，使用该接口上传联系人效率较低，建议使用批量导入接口importRemoteCSV导入联系人。
2. addRecipientsSendMailing接口可以添加1-1000个联系人，因此可以用于少量群发或单发，如果群发送数量比较大，比如一万以上，建议使用群发接口importRemoteCSVSendMailing。
3. 由于平台上预置了一个联系人组，如果联系人添加到该组，可以跳过步骤1创建联系人步骤。实际调用中，建议根据需要创建新的联系人组
接口文档地址：https://cndemo.webpower.asia/x/soap-v5.2/wsdl.php