使用webservice接口进行批量发送

来自亿业科技接口
跳转至: 导航搜索

批量发送需要准备些什么信息?

  • 主要信息:
待发送的会员email地址列表,待发送的邮件主题和邮件内容;
  • 发送相关信息:
任务名称(后续查询报表使用,需要确保唯一性
发送方名称和发送方地址,回复地址(不提供则默认和发送方相同);
发送时间(不提供则默认立刻发送)和过期时间(不提供则默认发送后7天过期);
 注:为了不冲突,请确保任务名称的唯一性,否则可能得到意想不到的结果~;
    可以在实际任务名称后面添加“时间戳+随机数”来确保唯一,时间戳精确到毫秒
  • 可选信息:
如果主题或者内容中有变量(比如会员名称,账单金额等),请准备每个会员对应的变量值;


批量发送应该调用你们什么接口?如何调用?

  • 主要调用的接口
批量导入联系人批量发送
首先循环调用批量导入联系人接口将待发送的会员email地址导入到某个联系组;
然后调用批量发送接口将待发送主题和内容,联系组名称以及发送相关信息一股脑传递过来即可;
  • 可选接口
    • 如果主题或者内容中含有变量,需要额外再调用接口:导入临时标签
这样的话,需要同时循环调用批量导入联系人方法和导入临时标签方法,将待发送的联系人导入到某个联系组,同时导入本次发送中对应的变量值;
所有待发送的联系人循环导入完毕后,调用批量发送接口进行发送即可;
    如果主题或者内容中含有变量,变量名称和变量值的转换和传递方法请参考本文下方的#如果主题或者内容中有变量,应该怎么处理?
  • 如何调用
请参考各个接口描述中的“最佳实践”说明进行设置即可;


如果主题或者内容中有变量,应该怎么处理?

1:将主题和内容中的变量转换成我司平台的临时标签的样式;
比如,主题中有“亲爱的$userfullname,请查收您的11月账单”,其中"$userfullname"是变量,需要将其转换为我司能够识别的临时标签;
我司临时标签名称请以"{[STAG-"开头,以"]}"结尾,比如上述的"$userfullname"转换为我司的临时标签就是"{[STAG-userfullname]}"
这样,转换完毕后的主题就是”亲爱的{[STAG-userfullname]},请查收您的11月账单“
    我司临时标签名称最大长度100个字节,字符范围是大小写字母和阿拉伯数字,对应的临时标签值的长度无限制;
    我司对临时标签出现的区域也没有限制,主题和内容均可;出现在内容时,临时标签可以作为某个链接的参数,我们在发送前会进行替换;
2:发送前调用导入临时标签,传入待发送的email地址对应的临时标签值;
3:调用批量发送接口将转换后的主题和内容提交过来即可;