使用webservice接口進行批量發送

從 亿业科技接口
跳到: 導覽搜尋

批量發送需要準備些什麼信息?

  • 主要信息:
待發送的會員email地址列表,待發送的郵件主題和郵件內容;
  • 發送相關信息:
任務名稱(後續查詢報表使用,需要確保唯一性
發送方名稱和發送方地址,回復地址(不提供則默認和發送方相同);
發送時間(不提供則默認立刻發送)和過期時間(不提供則默認發送後7天過期);
 注:为了不冲突,请确保任务名称的唯一性,否则可能得到意想不到的结果~;
    可以在实际任务名称后面添加“时间戳+随机数”来确保唯一,时间戳精确到毫秒
  • 可選信息:
如果主題或者內容中有變量(比如會員名稱,賬單金額等),請準備每個會員對應的變量值;


批量發送應該調用你們什麼接口?如何調用?

  • 主要調用的接口
批量導入聯繫人批量發送
首先循環調用批量導入聯繫人接口將待發送的會員email地址導入到某個聯繫組;
然後調用批量發送接口將待發送主題和內容,聯繫組名稱以及發送相關信息一股腦傳遞過來即可;
  • 可選接口
    • 如果主題或者內容中含有變量,需要額外再調用接口:導入臨時標籤
這樣的話,需要同時循環調用批量導入聯繫人方法和導入臨時標籤方法,將待發送的聯繫人導入到某個聯繫組,同時導入本次發送中對應的變量值;
所有待發送的聯繫人循環導入完畢後,調用批量發送接口進行發送即可;
    如果主题或者内容中含有变量,变量名称和变量值的转换和传递方法请参考本文下方的#如果主题或者内容中有变量,应该怎么处理?
  • 如何調用
請參考各個接口描述中的「最佳實踐」說明進行設置即可;


如果主題或者內容中有變量,應該怎麼處理?

1:將主題和內容中的變量轉換成我司平台的臨時標籤的樣式;
比如,主題中有「親愛的$userfullname,請查收您的11月賬單」,其中"$userfullname"是變量,需要將其轉換為我司能夠識別的臨時標籤;
我司臨時標籤名稱請以"{[STAG-"開頭,以"]}"結尾,比如上述的"$userfullname"轉換為我司的臨時標籤就是"{[STAG-userfullname]}"
這樣,轉換完畢後的主題就是」親愛的{[STAG-userfullname]},請查收您的11月賬單「
    我司临时标签名称最大长度100个字节,字符范围是大小写字母和阿拉伯数字,对应的临时标签值的长度无限制;
    我司对临时标签出现的区域也没有限制,主题和内容均可;出现在内容时,临时标签可以作为某个链接的参数,我们在发送前会进行替换;
2:發送前調用導入臨時標籤,傳入待發送的email地址對應的臨時標籤值;
3:調用批量發送接口將轉換後的主題和內容提交過來即可;