如何發(fā)送系統(tǒng)類通知、群發(fā)活動(dòng)信息

通過(guò)本功能您可以批量發(fā)送短信。實(shí)現(xiàn)訂單狀態(tài)通知、物流通知、活動(dòng)通知等。
云片后臺(tái)有手動(dòng)群發(fā)功能,支持發(fā)送變量短信(免技術(shù)開(kāi)發(fā)，僅對(duì)高級(jí)用戶開(kāi)放）。

一、注冊(cè)、報(bào)備及設(shè)置

注冊(cè)云片，完成資質(zhì)報(bào)備、簽名報(bào)備及模板報(bào)備。
tips:

• 報(bào)備可以讓產(chǎn)品經(jīng)理、運(yùn)營(yíng)等業(yè)務(wù)人員完成。

• 開(kāi)發(fā)階段，建議先關(guān)閉IP 白名單，或?qū)⒎?wù)器 IP 及本地 IP 均設(shè)置在 IP 白名單內(nèi)。

• 為了避免開(kāi)發(fā)調(diào)試中，您的手機(jī)號(hào)被系統(tǒng)防騷擾機(jī)制攔截，可以在測(cè)試白名單填寫(xiě)您的手機(jī)號(hào)。

二、調(diào)通短信接口

閱讀文檔了解 API，下載 SDK 快速使用。
選擇合適的發(fā)送接口

批量發(fā)送接口

方法一：直接使用 API

附注： 因?yàn)檫\(yùn)營(yíng)商政策，請(qǐng)先在后臺(tái)完成報(bào)備簽名、模板及做相關(guān)設(shè)置(詳見(jiàn)接入引導(dǎo))，再開(kāi)發(fā) API。

HTTP 頭信息:

Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;

請(qǐng)求

URL：https://sms.yunpian.com/v2/sms/batch_send.json

注意：海外服務(wù)器地址 us.yunpian.com
訪問(wèn)方式：POST
支持 https 與 http 兩種訪問(wèn)，建議使用 https

請(qǐng)求參數(shù)

附注：如需使用"extend"參數(shù)，可免費(fèi)向客服申請(qǐng)。

請(qǐng)求示例

/**
* 批量發(fā)送短信,相同內(nèi)容多個(gè)號(hào)碼,智能匹配短信模板
*
* @param apikey 成功注冊(cè)后登錄云片官網(wǎng),進(jìn)入后臺(tái)可查看
* @param text 需要使用已審核通過(guò)的模板或者默認(rèn)模板
* @param mobile 接收的手機(jī)號(hào),多個(gè)手機(jī)號(hào)用英文逗號(hào)隔開(kāi)
* @return json格式字符串
*/
public static String batchSend(String apikey, String text, String mobile) {
    Map<String, String> params = new HashMap<String, String>();//請(qǐng)求參數(shù)集合
    params.put("apikey", apikey);
    params.put("text", text);
    params.put("mobile", mobile);
    return post("https://sms.yunpian.com/v2/sms/batch_send.json", params);//請(qǐng)自行使用post方式請(qǐng)求,可使用Apache HttpClient
}

響應(yīng)

Json 響應(yīng)示例

{
  "total_count": 2,
  "total_fee": "0.2000",
  "unit": "RMB",
  "data": [
    {
      "code": 0,
      "msg": "發(fā)送成功",
      "count": 1,
      "fee": 0.05,
      "unit": "RMB",
      "mobile": "13000000000",
      "sid": 3310228964
    },
    {
      "code": 0,
      "msg": "發(fā)送成功",
      "count": 1,
      "fee": 0.05,
      "unit": "RMB",
      "mobile": "13000000001",
      "sid": 3310228968
    }
  ]
}

方法二：下載、導(dǎo)入 SDK，并配置。

目前云片提供 JAVA/PHP/Python/C#/Golang 5 種語(yǔ)言 SDK、如果您的編程語(yǔ)言云片未提供 SDK，您可以根據(jù)文檔自行對(duì)接。
SDK 下載地址（JAVA/PHP/Python/C#/GOLANG）：去下載

SDK 示例

/**
* 使用JDK發(fā)送批量短信,智能匹配短信模板
*
* @param apikey 成功注冊(cè)后登錄云片官網(wǎng),進(jìn)入后臺(tái)可查看
* @param text 需要使用已審核通過(guò)的模板或者默認(rèn)模板
* @param mobile 接收的手機(jī)號(hào),多個(gè)用英文逗號(hào)隔開(kāi)
*/
public static void testSendSms(String apikey, String mobile, String text) {

    //初始化client,apikey作為所有請(qǐng)求的默認(rèn)值(可以為空)
    YunpianClient clnt = new YunpianClient("apikey").init();

    Map<String, String> param = clnt.newParam(2);
    param.put(YunpianClient.MOBILE, mobile);
    param.put(YunpianClient.TEXT, "【云片網(wǎng)】您的驗(yàn)證碼是1234");
    Result<SmsBatchSend> r = clnt.sms().batch_send(param);
    //獲取返回結(jié)果，返回碼:r.getCode(),返回碼描述:r.getMsg(),API結(jié)果:r.getData(),其他說(shuō)明:r.getDetail(),調(diào)用異常:r.getThrowable()
    r.getData();
    //賬戶:clnt.user().* 簽名:clnt.sign().* 模版:clnt.tpl().* 短信:clnt.sms().* 語(yǔ)音:clnt.voice().* 流量:clnt.flow().* 隱私通話:clnt.call().*

    //最后釋放client
    clnt.close()

}

三、實(shí)現(xiàn)業(yè)務(wù)邏輯

調(diào)用接口發(fā)送短信

• 短信內(nèi)容需和通過(guò)審核的模板匹配上才能發(fā)送，如不匹配接口會(huì)返回報(bào)錯(cuò)信息，報(bào)錯(cuò)記錄在后臺(tái)失敗請(qǐng)求頁(yè)可以看到。

• 模板審核時(shí)間一般半小時(shí)內(nèi)，如果需群發(fā)活動(dòng)通知等。建議提前審核好模板。

四、按需開(kāi)發(fā)功能

• 對(duì)短信發(fā)送狀態(tài)做實(shí)時(shí)監(jiān)控
  如果您需要通過(guò)程序?qū)Χ绦诺陌l(fā)送狀態(tài)做實(shí)時(shí)監(jiān)控，可以開(kāi)發(fā)“推送/獲取狀態(tài)報(bào)告”接口。
  如果只是想了解短信發(fā)送狀態(tài)，無(wú)實(shí)時(shí)監(jiān)控需求，"云片管理控制臺(tái)-國(guó)內(nèi)短信-數(shù)據(jù)統(tǒng)計(jì)" 可以看到實(shí)時(shí)及歷史的到達(dá)率、發(fā)送量、接口失敗原因等報(bào)表。

• 短信平臺(tái)/代理類客戶
  如果您是短信平臺(tái)/代理，需要管理眾多客戶的簽名及模板。您可能需要 “簽名提交 API”、 “模板管理 API”、 “賬戶 API”。 從而通過(guò) API 接口輕松管理簽名、模板、賬戶。

• 獲取上行短信
  如果您的業(yè)務(wù)中，需獲取用戶回復(fù)的上行短信，可以開(kāi)發(fā)“推送回復(fù)短信 API”。通過(guò)這個(gè)接口，如果用戶回復(fù)了您的短信，云片會(huì)第一時(shí)間推送給您。

• 國(guó)外地區(qū)使用海外服務(wù)器
  如海外用戶可以調(diào)用海外服務(wù)器地址us.yunpian.com,獲得更快的請(qǐng)求和處理速度。例如使用短信接口時(shí)，將sms.yunpian.com替換為us.yunpian.com即可。