2022版5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)_第1頁(yè)
2022版5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)_第2頁(yè)
2022版5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)_第3頁(yè)
2022版5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)_第4頁(yè)
2022版5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)_第5頁(yè)
已閱讀5頁(yè),還剩92頁(yè)未讀, 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說(shuō)明:本文檔由用戶(hù)提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡(jiǎn)介

5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)文檔版本 01發(fā)布日期 2022-09-28華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)01(2022-09-28)PAGE\*roman01(2022-09-28)PAGE\*romaniii 目錄快速入門(mén) 1注冊(cè)華為賬號(hào)并完成認(rèn)證 2購(gòu)買(mǎi)5G消息標(biāo)準(zhǔn)版服務(wù) 7申請(qǐng)5G消息標(biāo)準(zhǔn)版簽名 14通過(guò)門(mén)戶(hù)申請(qǐng)5G消息標(biāo)準(zhǔn)版模板并發(fā)送 19申請(qǐng)5G消息標(biāo)準(zhǔn)版模板 19體驗(yàn)?zāi)0灏l(fā)送管理(可選) 22發(fā)送視頻短信 24通過(guò)AppCube申請(qǐng)5G消息標(biāo)準(zhǔn)版模板并發(fā)送 26創(chuàng)建5G消息應(yīng)用并配置通道信息 26制作5G消息標(biāo)準(zhǔn)版 29創(chuàng)建群發(fā)視頻短信任務(wù) 37通過(guò)調(diào)用API接口發(fā)送5G消息標(biāo)準(zhǔn)版 39新手必備 39開(kāi)發(fā)準(zhǔn)備 41API參考 417.3.1概述 41接口范圍說(shuō)明 41術(shù)語(yǔ)與縮略圖 42總體規(guī)范 42接口簡(jiǎn)介 42接口格式說(shuō)明 42訪問(wèn)認(rèn)證說(shuō)明 42通用請(qǐng)求消息頭定義 42接口說(shuō)明 43模板創(chuàng)建 43模板查詢(xún) 50視頻短信發(fā)送任務(wù) 55發(fā)送任務(wù)列表查詢(xún) 61發(fā)送任務(wù)狀態(tài)報(bào)告查詢(xún) 65模板審核結(jié)果通知 68發(fā)送任務(wù)狀態(tài)報(bào)告回調(diào) 70上行消息推送接口 74代碼樣例 76JAVA 767.3.5附錄 84通用結(jié)果碼 84模板類(lèi)型定義 85發(fā)送手機(jī)號(hào)碼規(guī)則定義 85規(guī)則與標(biāo)準(zhǔn) 86視頻短信封禁規(guī)則 86視頻短信模板內(nèi)容定義 87視頻短信內(nèi)容審核標(biāo)準(zhǔn) 88視頻短信簽名審核標(biāo)準(zhǔn) 89發(fā)送手機(jī)號(hào)碼規(guī)則定義 91992視頻短信發(fā)送能力如何? 92提交模板審核被駁回,提示“貼尾檢測(cè),模板最后文本幀不能包含:退訂、免流”是什么意思? 92視頻短信發(fā)送成功,有時(shí)手機(jī)未收到是什么原因? 92視頻短信模板提交后,一般多久可以審核結(jié)束? 92模板審核狀態(tài)回調(diào),發(fā)送任務(wù)狀態(tài)報(bào)告回調(diào)接口必須按照接口文檔開(kāi)發(fā),保持一致么? 93如客戶(hù)側(cè)服務(wù)異常,導(dǎo)致華為推送模板審核狀態(tài)和發(fā)送任務(wù)狀態(tài)報(bào)告失敗后,該如何獲取相關(guān)數(shù)據(jù)? 93模板創(chuàng)建時(shí)中的source和type有什么區(qū)別? 93有哪些常見(jiàn)的狀態(tài)碼? 93華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)1快速入門(mén)01(2022-09-28)PAGE01(2022-09-28)PAGE1 1快速入門(mén)5G消息標(biāo)準(zhǔn)版(即視頻短信)是華為inTouchAggregator提供的一種通信服務(wù)的能力。本文檔用于指導(dǎo)用戶(hù)如何購(gòu)買(mǎi)及發(fā)送5G消息標(biāo)準(zhǔn)版業(yè)務(wù)。入駐華為云在購(gòu)買(mǎi)5G消息標(biāo)準(zhǔn)版服務(wù)前需要注冊(cè)華為賬號(hào),完成企業(yè)認(rèn)證,請(qǐng)參考注冊(cè)華為賬號(hào)并進(jìn)行認(rèn)證。購(gòu)買(mǎi)5G消息標(biāo)準(zhǔn)版服務(wù)云市場(chǎng)如何購(gòu)買(mǎi)5G消息標(biāo)準(zhǔn)版,請(qǐng)參考購(gòu)買(mǎi)5G消息標(biāo)準(zhǔn)版服務(wù)。申請(qǐng)5G消息標(biāo)準(zhǔn)版簽名5G消息標(biāo)準(zhǔn)版簽名是指短信發(fā)送方的署名,標(biāo)識(shí)發(fā)送方的身份。請(qǐng)參考申請(qǐng)5G消息標(biāo)準(zhǔn)版簽名。5G消息標(biāo)準(zhǔn)版模板5G消息標(biāo)準(zhǔn)版模板是指發(fā)送方發(fā)送5G請(qǐng)參考視頻短信模板內(nèi)容定義及視頻短信內(nèi)容審核標(biāo)準(zhǔn)。申請(qǐng)5G消息標(biāo)準(zhǔn)版模板,有2種方式可供選擇:通過(guò)門(mén)戶(hù)申請(qǐng)視頻短信模板通過(guò)AppCube申請(qǐng)視頻短信模板發(fā)送5G消息標(biāo)準(zhǔn)版發(fā)送5G消息標(biāo)準(zhǔn)版,有3種方式可供選擇:通過(guò)門(mén)戶(hù)提供的發(fā)送任務(wù)去發(fā)送視頻短信(只針對(duì)直客用戶(hù))通過(guò)AppCube提供的投放任務(wù)去群發(fā)視頻短信通過(guò)調(diào)用提供的API接口發(fā)送視頻短信華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)2注冊(cè)華為賬號(hào)并完成認(rèn)證01(2022-09-28)PAGE01(2022-09-28)PAGE2 2注冊(cè)華為賬號(hào)并完成認(rèn)證背景信息

華為帳號(hào)是用戶(hù)訪問(wèn)華為各網(wǎng)站的統(tǒng)一“身份標(biāo)識(shí)”,您只需注冊(cè)一個(gè)華為帳號(hào),即可訪問(wèn)所有華為服務(wù),如:華為云、終端云、華為手機(jī)等終端、華為開(kāi)發(fā)者聯(lián)盟等。操作步驟步驟1進(jìn)入華為云官網(wǎng)。步驟2注冊(cè)華為賬號(hào)。單擊頁(yè)面右上角的“注冊(cè)”,進(jìn)入“華為賬號(hào)注冊(cè)”頁(yè)面。圖2-1華為賬號(hào)注冊(cè)輸入手機(jī)號(hào)。請(qǐng)使用中國(guó)大陸的手機(jī)號(hào)碼。一個(gè)手機(jī)號(hào)可以注冊(cè)3個(gè)華為帳號(hào),如帳號(hào)數(shù)量已達(dá)到3手機(jī)號(hào)注冊(cè)新的華為帳號(hào)。獲取并輸入手機(jī)收到的驗(yàn)證碼。設(shè)置帳號(hào)密碼。至少包含8個(gè)字符。至少包含字母和數(shù)字,不能包含空格。步驟3開(kāi)通華為云。華為云賬號(hào)注冊(cè)完成后,系統(tǒng)進(jìn)入“開(kāi)通華為云”頁(yè)面。圖2-2開(kāi)通華為云系統(tǒng)提示開(kāi)通成功。開(kāi)通成功即可通過(guò)該華為帳號(hào)登錄華為云。圖2-3華為云開(kāi)通成功步驟4企業(yè)實(shí)名認(rèn)證。圖2-4實(shí)名認(rèn)證說(shuō)明登錄華為云官網(wǎng)后,通過(guò)單擊頁(yè)面右上角的用戶(hù)名,選擇“賬號(hào)中心”,在認(rèn)證信息后面單擊“認(rèn)證”,也可進(jìn)入圖4實(shí)名認(rèn)證頁(yè)面。選擇企業(yè)認(rèn)證,根據(jù)頁(yè)面提示完成認(rèn)證。詳細(xì)認(rèn)證操作請(qǐng)參考企業(yè)賬號(hào)如何完成實(shí)名認(rèn)證。步驟5綁定郵箱。圖2-5基本信息圖2-6賬號(hào)中心單擊“綁定”,按照頁(yè)面提示驗(yàn)證身份。輸入“綁定郵箱”,獲取郵箱驗(yàn)證碼并輸入,完成郵箱的綁定。結(jié)束華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)35G消息標(biāo)準(zhǔn)版服務(wù)01(2022-09-28)PAGE01(2022-09-28)PAGE10 35G消息標(biāo)準(zhǔn)版服務(wù)使用5G消息標(biāo)準(zhǔn)版服務(wù)前,您需要先登錄華為云云市場(chǎng)購(gòu)買(mǎi)5G消息標(biāo)準(zhǔn)版服務(wù)。因云市場(chǎng)的5G消息標(biāo)準(zhǔn)版為嚴(yán)選自營(yíng)產(chǎn)品,涉及服務(wù)監(jiān)管,所以需要先購(gòu)買(mǎi),然后執(zhí)行服務(wù)監(jiān)管。購(gòu)買(mǎi)步驟1登錄華為云。進(jìn)入華為云官網(wǎng)。單擊頁(yè)面右上角的“登錄”,進(jìn)入登錄頁(yè)面。圖3-1登錄頁(yè)面輸入已注冊(cè)并開(kāi)通華為云的華為賬號(hào)、帳號(hào)密碼,單擊“登錄”。說(shuō)明若您需要使用其他方式登錄華為云,請(qǐng)參考登錄華為云。步驟2購(gòu)買(mǎi)5G消息標(biāo)準(zhǔn)版服務(wù)。在頁(yè)面頂端搜索欄搜索您需要購(gòu)買(mǎi)的產(chǎn)品:5G消息云服務(wù)。單擊產(chǎn)品名稱(chēng),進(jìn)入詳情頁(yè)面。圖3-25G消息云服務(wù)查看商品詳情,然后選擇需要購(gòu)買(mǎi)產(chǎn)品的規(guī)格、套餐包規(guī)格、套數(shù)、購(gòu)買(mǎi)時(shí)長(zhǎng)。圖3-35G消息云服務(wù)服務(wù)監(jiān)管

核對(duì)訂單詳情,填寫(xiě)訂單推薦的經(jīng)銷(xiāo)商賬號(hào)或者客戶(hù)經(jīng)理賬號(hào)(如涉及),“協(xié)議及授權(quán)”,單擊“去支付”。待經(jīng)銷(xiāo)商/購(gòu)買(mǎi)成功的產(chǎn)品可在已購(gòu)買(mǎi)的服務(wù)中查看。結(jié)束5G消息標(biāo)準(zhǔn)版服務(wù)涉及服務(wù)監(jiān)管,需要按照服務(wù)監(jiān)管流程執(zhí)行操作。服務(wù)監(jiān)管流程如下:用戶(hù)購(gòu)買(mǎi)的SaaS類(lèi)商品支付成功后,需要進(jìn)入“我的云市場(chǎng)>服務(wù)監(jiān)管”頁(yè)面提交需求,并及時(shí)跟進(jìn)訂單服務(wù)的進(jìn)度。如服務(wù)監(jiān)管流程在服務(wù)商處未處理,用戶(hù)可聯(lián)系服務(wù)商溝通交付問(wèn)題。服務(wù)監(jiān)管流程未完成的訂單,訂單狀態(tài)為“處理中”,待用戶(hù)確認(rèn)驗(yàn)收后3個(gè)小時(shí)內(nèi),訂單狀態(tài)會(huì)同步為“已完成”,代表訂單全流程已完成。圖3-4嚴(yán)選自營(yíng)商品服務(wù)監(jiān)管流程服務(wù)監(jiān)管流程中,用戶(hù)可以執(zhí)行以下操作:購(gòu)買(mǎi)服務(wù)后,在“我的云市場(chǎng)>服務(wù)監(jiān)管”處提交需求。服務(wù)商反饋服務(wù)已完成后,用戶(hù)可以在“我的云市場(chǎng)>服務(wù)監(jiān)管認(rèn)已完成。服務(wù)商實(shí)施需求后,若用戶(hù)對(duì)服務(wù)結(jié)果不滿意,可以執(zhí)行“駁回”操作。說(shuō)明服務(wù)監(jiān)管過(guò)程中,如服務(wù)商方流程停留超過(guò)5天或駁回次數(shù)超過(guò)3次,用戶(hù)可執(zhí)行“申訴”操作,詳情請(qǐng)參見(jiàn)服務(wù)監(jiān)管申訴說(shuō)明。服務(wù)監(jiān)管操作步驟如下:步驟1提交需求。登錄華為云云市場(chǎng)首頁(yè),進(jìn)入買(mǎi)家中心“我的云市場(chǎng)>服務(wù)監(jiān)管”頁(yè)面。設(shè)置查詢(xún)條件,選擇目標(biāo)服務(wù)交易記錄,單擊操作列的“提交需求”。填寫(xiě)需求信息,單擊“提交需求”。說(shuō)明需求附件可以參考需求模板提交。提交需求成功后,用戶(hù)可以在服務(wù)監(jiān)管頁(yè)面查看服務(wù)狀態(tài)及歷史記錄。在系統(tǒng)顯示的彈框頁(yè)面,單擊“確認(rèn)”。步驟2確認(rèn)驗(yàn)收。登錄華為云云市場(chǎng)首頁(yè),進(jìn)入買(mǎi)家中心“我的云市場(chǎng)>服務(wù)監(jiān)管”頁(yè)面。設(shè)置查詢(xún)條件,選擇目標(biāo)服務(wù)交易記錄,單擊操作列的“確認(rèn)驗(yàn)收”。若服務(wù)已完成,單擊“確認(rèn)驗(yàn)收”。說(shuō)明服務(wù)商反饋服務(wù)完成后,確認(rèn)該服務(wù)已完成或者駁回給服務(wù)商,駁回次數(shù)超過(guò)3次,用戶(hù)可在第4次操作時(shí)發(fā)起申訴。在系統(tǒng)顯示的彈框頁(yè)面,單擊“確認(rèn)”。說(shuō)明嚴(yán)選自營(yíng)商品用戶(hù)申訴說(shuō)明:服務(wù)監(jiān)管過(guò)程中,在用戶(hù)方操作流程(用戶(hù)提交需求/用戶(hù)確認(rèn)驗(yàn)收)駁回次數(shù)超過(guò)3用戶(hù)可在第4次操作時(shí)發(fā)起申訴。都不可再進(jìn)行操作。當(dāng)運(yùn)營(yíng)經(jīng)理處理完申訴后,服務(wù)監(jiān)管恢復(fù)為可操作狀態(tài)。服務(wù)監(jiān)管流程關(guān)閉前15天內(nèi),不允許發(fā)起申訴。結(jié)束退訂用戶(hù)購(gòu)買(mǎi)后,系統(tǒng)支持退訂。退訂申請(qǐng)?zhí)峤缓?,需服?wù)商審核通過(guò)后,才能退訂成功,故請(qǐng)謹(jǐn)慎操作。步驟1進(jìn)入買(mǎi)家中心>我的云市場(chǎng)頁(yè)面。步驟2單擊“退訂管理”,查看您可以退訂的商品列表。步驟3選擇需要退訂的商品,單擊右側(cè)操作列的“退訂”。圖3-5退訂步驟4輸入“退訂金額”,選擇退訂原因,單擊右下角“退訂”。圖3-6退訂詳情步驟5在系統(tǒng)彈框中,單擊“是”。提交成功后,需要服務(wù)商審核,您可以在中關(guān)注退訂狀態(tài)。結(jié)束華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)45G消息標(biāo)準(zhǔn)版簽名01(2022-09-28)PAGE01(2022-09-28)PAGE14 45G消息標(biāo)準(zhǔn)版簽名背景信息 須知 5G消息標(biāo)準(zhǔn)版,又稱(chēng)視頻短信,在iTA門(mén)戶(hù)操作中,所提到的視頻短信即為5G消息標(biāo)準(zhǔn)版。申請(qǐng)5G消息標(biāo)準(zhǔn)版(視頻短信)簽名操作,需要您使用已注冊(cè)并完成認(rèn)證賬號(hào)登錄門(mén)戶(hù)完成。5G消息標(biāo)準(zhǔn)版(視頻短信)請(qǐng)企業(yè)簽名備案,待審批通過(guò)后,才可用于5G消息標(biāo)準(zhǔn)版(視頻短信)操作步驟步驟1登錄iTA門(mén)戶(hù)。使用已注冊(cè)認(rèn)證的華為云賬號(hào)登錄網(wǎng)站。iTA網(wǎng)站地址:?jiǎn)螕簟叭A為云賬號(hào)登錄”,根據(jù)界面提示輸入賬號(hào)名/郵箱和密碼。單擊“登錄”。步驟2選擇“控制臺(tái)>消息>視頻短信”,系統(tǒng)彈出備案視頻短信簽名頁(yè)面。圖4-1視頻短信簽名認(rèn)證提醒說(shuō)明選擇視頻短信后,系統(tǒng)會(huì)校驗(yàn)客戶(hù)在iTA系統(tǒng)中是否已有成功企業(yè)簽名備案記錄,如果沒(méi)有,則會(huì)提示客戶(hù)進(jìn)行備案注冊(cè)。步驟3單擊“確定”,頁(yè)面跳轉(zhuǎn)到圖4-2。圖4-2視頻短信企業(yè)簽名備案確認(rèn)步驟4勾選“我已閱讀并同意《國(guó)內(nèi)視頻短信服務(wù)使用聲明》”,單擊“立即開(kāi)通”,頁(yè)面跳轉(zhuǎn)至圖3。圖4-3企業(yè)簽名備案步驟5單擊“新增”,進(jìn)入圖4-4,根據(jù)界面提示完成參數(shù)填寫(xiě)。圖4-4新增企業(yè)簽名備案界面參數(shù)說(shuō)明如下:表4-1新增企業(yè)簽名備案頁(yè)面參數(shù)說(shuō)明參數(shù)說(shuō)明簽名所屬企業(yè)名稱(chēng)企業(yè)名稱(chēng)。請(qǐng)按照頁(yè)面提示進(jìn)行填寫(xiě)。行業(yè)類(lèi)型企業(yè)所屬行業(yè)。在下拉列表中選擇。簽名來(lái)源企業(yè)簽名的來(lái)源。參數(shù)說(shuō)明是否涉及第三方權(quán)益是涉及第三方權(quán)益時(shí),需要上傳企事業(yè)單位的企業(yè)營(yíng)業(yè)執(zhí)照和企事業(yè)單位的授權(quán)委托書(shū)。否不涉及第三方權(quán)益時(shí),只需上傳營(yíng)業(yè)執(zhí)照。是否涉及第三方權(quán)益,請(qǐng)參見(jiàn)第三方權(quán)益。信息服務(wù)簽名需要申請(qǐng)的企業(yè)簽名。簽名要求請(qǐng)參見(jiàn)格式限制。簽名授權(quán)委托書(shū)企業(yè)簽名授權(quán)委托書(shū)。通過(guò)單擊“上傳”按鈕進(jìn)行上傳。需要提供的簽名申請(qǐng)材料請(qǐng)參見(jiàn)簽名申請(qǐng)材料。企事業(yè)單位的營(yíng)業(yè)執(zhí)照企事業(yè)單位的營(yíng)業(yè)執(zhí)照。通過(guò)單擊“上傳”按鈕進(jìn)行上傳。需要提供的簽名申請(qǐng)材料請(qǐng)參見(jiàn)簽名申請(qǐng)材料。其他當(dāng)以上材料不能體現(xiàn)簽名和企業(yè)關(guān)系時(shí),需要補(bǔ)充上傳其他證明材料。說(shuō)明視頻短信簽名需遵循相應(yīng)的審核標(biāo)準(zhǔn),詳情參見(jiàn)視頻短信簽名審核標(biāo)準(zhǔn)。通知。視頻短信簽名申請(qǐng)后需要審核通過(guò)才可以使用,工作日提交申請(qǐng),預(yù)計(jì)2法定節(jié)假日順延,請(qǐng)耐心等待。如有疑問(wèn),請(qǐng)聯(lián)系客服。根據(jù)所選擇的行業(yè)不同,要提交的資料項(xiàng)不同,表2細(xì)信息。表4-2行業(yè)對(duì)應(yīng)資料項(xiàng)所屬行業(yè)簽名來(lái)源是否涉及第三方權(quán)益申請(qǐng)要求所有行業(yè)所有簽名來(lái)源否企事業(yè)單位的營(yíng)業(yè)執(zhí)照簽名授權(quán)委托書(shū)所有行業(yè)所有簽名來(lái)源是簽名歸屬方企事業(yè)單位的營(yíng)業(yè)執(zhí)照所屬行業(yè)簽名來(lái)源是否涉及第三方權(quán)益申請(qǐng)要求簽名歸屬方授權(quán)委托書(shū)所有行業(yè)工信部備案網(wǎng)站的全稱(chēng)或簡(jiǎn)稱(chēng)都需要ICP備案查詢(xún)截圖所有行業(yè)APP應(yīng)用的全稱(chēng)或簡(jiǎn)稱(chēng)都需要應(yīng)用市場(chǎng)下載截圖所有行業(yè)商標(biāo)名的全稱(chēng)或簡(jiǎn)稱(chēng)都需要商標(biāo)注冊(cè)證食品行業(yè)所有簽名來(lái)源都需要食品經(jīng)營(yíng)許可證游戲行業(yè)所有簽名來(lái)源都需要計(jì)算機(jī)軟件著作權(quán)登記證都需要游戲版號(hào)步驟6填寫(xiě)完成后,單擊“提交”,界面彈出“尊敬的用戶(hù):您的視頻短信簽名備案已提交成功!”的提示信息。視頻短信簽名申請(qǐng)后,可以在圖3“備案狀態(tài)”列查看審核狀態(tài),不同狀態(tài)下的模板支持不同的操作:審批中:不可修改,不可刪除。已通過(guò):不可修改,可以刪除。未通過(guò):可以修改,可以刪除。結(jié)束華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)55G消息標(biāo)準(zhǔn)版模板并發(fā)送01(2022-09-28)PAGE01(2022-09-28)PAGE1955G消息標(biāo)準(zhǔn)版模板并發(fā) 送 須知 5G消息標(biāo)準(zhǔn)版,又稱(chēng)視頻短信,在iTA門(mén)戶(hù)操作中,所提到的視頻短信即為5G消息標(biāo)準(zhǔn)版。申請(qǐng)5G消息標(biāo)準(zhǔn)版模板模板是什么

5G消息標(biāo)準(zhǔn)版模板是用戶(hù)發(fā)送5G消息標(biāo)準(zhǔn)版時(shí)使用的內(nèi)容模板。模板規(guī)則請(qǐng)查看視頻短信模板內(nèi)容定義。新建模板步驟1登錄ITA門(mén)戶(hù)。步驟2選擇“控制臺(tái)>消息>視頻短信>模板中心”,進(jìn)入模板中心頁(yè)面。圖5-1模板中心步驟3選擇“模板名稱(chēng)”,輸入模板的名稱(chēng),或單擊下拉按鈕選擇“模板編號(hào)”,輸入模板的編號(hào),單擊搜索按鈕,可查詢(xún)對(duì)應(yīng)模板信息。鼠標(biāo)移動(dòng)到模板上,模板的中心會(huì)出現(xiàn)4個(gè)圖標(biāo),說(shuō)明如下:預(yù)覽圖標(biāo):?jiǎn)螕艉?,展示發(fā)送終端顯示的模板效果。用。待用戶(hù)補(bǔ)充其他信息后,即可執(zhí)行發(fā)送任務(wù)。步驟4申請(qǐng)視頻短信模板。單擊“新建模板”,進(jìn)入新建模板頁(yè)面。配置模板的基本信息。選擇“企業(yè)名稱(chēng)”,頁(yè)面會(huì)自動(dòng)關(guān)聯(lián)顯示對(duì)應(yīng)的企業(yè)簽名。說(shuō)明若“模板類(lèi)型”選擇“動(dòng)態(tài)參數(shù)模板”,則還需要設(shè)置是否“攜帶chatbot服務(wù)號(hào)”。配置消息內(nèi)容。輸入“消息標(biāo)題”,單擊“添加內(nèi)容”,選擇添加文本或多媒體內(nèi)容,然后選擇“退訂標(biāo)簽選擇”。添加的內(nèi)容會(huì)實(shí)時(shí)顯示在右側(cè)的預(yù)覽效果中。多媒體內(nèi)容支持上傳圖片、音頻和視頻,支持本地上傳和素材庫(kù)上傳兩種形式。素材庫(kù)的管理詳見(jiàn)素材庫(kù)管理。圖5-2已配置的模板樣例說(shuō)明視頻短信模板的內(nèi)容支持文本、圖片和視頻格式,內(nèi)容大小建議在660KB-1.9MB之間。單個(gè)模板最多支持添加8幀,每一幀包含一種內(nèi)容,即文本、音頻或視頻中的一種。模板消息內(nèi)容必須包含文本內(nèi)容,另外還需要包含圖片/視頻/幀文本中需要在文字前面添加企業(yè)簽名。對(duì)于固定參數(shù)模板和動(dòng)態(tài)參數(shù)模板,支持文本變量數(shù)量最多為10個(gè)。填寫(xiě)的模板內(nèi)容需遵循相應(yīng)的標(biāo)準(zhǔn),詳情參見(jiàn)視頻短信內(nèi)容審核標(biāo)準(zhǔn)審核通過(guò)才可以使用。配置完成,單擊“提交”,完成視頻短信模板的新建,等待審核。對(duì)于審核通過(guò)的模板,系統(tǒng)支持通過(guò)新建發(fā)送任務(wù)來(lái)實(shí)現(xiàn)視頻短信的發(fā)送,詳見(jiàn)發(fā)送視頻短信。結(jié)束素材庫(kù)管理步驟1在左側(cè)導(dǎo)航欄中選擇“視頻短信>素材庫(kù)管理”,進(jìn)入素材庫(kù)管理頁(yè)面。圖5-3素材庫(kù)管理步驟2企業(yè)用戶(hù)可根據(jù)需要,選擇圖片、視頻和音頻三個(gè)維度本地上傳或刪除多媒體素材。結(jié)束體驗(yàn)?zāi)0灏l(fā)送管理(可選)在使用已購(gòu)買(mǎi)的視頻短信服務(wù)之前,用戶(hù)可以實(shí)際情況,選擇使用體驗(yàn)?zāi)0暹M(jìn)行發(fā)送的測(cè)試和體驗(yàn)。操作步驟步驟1登錄ITA門(mén)戶(hù)。步驟2選擇“控制臺(tái)>消息>視頻短信>體驗(yàn)?zāi)0灏l(fā)送管理”,進(jìn)入體驗(yàn)?zāi)0灏l(fā)送管理頁(yè)面。可根據(jù)“模板名稱(chēng)”,“模板編號(hào)”對(duì)模板進(jìn)行查詢(xún)。圖5-4體驗(yàn)?zāi)0灏l(fā)送管理說(shuō)明發(fā)送范圍:移動(dòng),聯(lián)通,電信。步驟3圖1中單擊“發(fā)送”,進(jìn)入單條測(cè)試頁(yè)面。圖5-5單條測(cè)試步驟4輸入測(cè)試號(hào)碼(即手機(jī)號(hào)碼),單擊“獲取驗(yàn)證碼”,填寫(xiě)已獲取的驗(yàn)證碼,單擊“發(fā)送”,完成體驗(yàn)?zāi)0宓陌l(fā)送。說(shuō)明體驗(yàn)?zāi)0逯荒軉螚l發(fā)送,只有測(cè)試號(hào)碼和短信驗(yàn)證碼填寫(xiě)正確,才能進(jìn)行發(fā)送。結(jié)束發(fā)送視頻短信前提條件

用戶(hù)已購(gòu)買(mǎi)視頻短信服務(wù),并完成服務(wù)監(jiān)管。用戶(hù)已申請(qǐng)視頻短信簽名,并審批通過(guò)。用戶(hù)已申請(qǐng)視頻短信模板,并審批通過(guò)。操作步驟步驟1登錄iTA門(mén)戶(hù)。步驟2選擇“控制臺(tái)>消息>視頻短信>發(fā)送任務(wù)管理”,進(jìn)入發(fā)送任務(wù)管理頁(yè)面。可根據(jù)任務(wù)創(chuàng)建時(shí)間范圍、任務(wù)名稱(chēng)和模板類(lèi)型查詢(xún)歷史發(fā)送任務(wù)。圖5-6發(fā)送任務(wù)管理操作列中單擊“查看”,可以查看發(fā)送任務(wù)的詳情。操作列中單擊“預(yù)覽”,可以預(yù)覽待發(fā)送的任務(wù)信息。操作列中單擊“查看發(fā)送詳情”,在彈出頁(yè)面中,可進(jìn)行如下操作:輸入“手機(jī)號(hào)碼”,可查詢(xún)單個(gè)號(hào)碼的發(fā)送詳情。單擊“導(dǎo)出全部號(hào)碼”,可導(dǎo)出發(fā)送任務(wù)中全部用戶(hù)的下發(fā)詳情。單擊“導(dǎo)出失敗號(hào)碼”,可導(dǎo)出發(fā)送任務(wù)中失敗用戶(hù)的下發(fā)詳情。操作列中單擊“撤銷(xiāo)”,可以撤銷(xiāo)待發(fā)送的任務(wù)。只有“任務(wù)狀態(tài)”為“待發(fā)送”,且發(fā)送時(shí)間距離當(dāng)前時(shí)大于5分鐘的任務(wù),才可以撤銷(xiāo)。操作列中單擊“刪除”,可以刪除已撤銷(xiāo)的發(fā)送任務(wù)。步驟3單擊“新建發(fā)送任務(wù)”按鈕,進(jìn)入“新建發(fā)送任務(wù)”頁(yè)面。圖5-7新建發(fā)送任務(wù)步驟4輸入“任務(wù)名稱(chēng)”,選擇相應(yīng)模板,模板類(lèi)型會(huì)自動(dòng)關(guān)聯(lián)顯示。當(dāng)選擇"立即發(fā)送"碼。單擊“提交”,界面彈出“提交成功!”提示信息。規(guī)則實(shí)時(shí)變化,實(shí)際下發(fā)結(jié)果以定時(shí)下發(fā)后的狀態(tài)報(bào)告為準(zhǔn)”提示信息。說(shuō)明任務(wù)提交時(shí)(不管立即發(fā)送還是定時(shí)發(fā)送),針對(duì)基礎(chǔ)的號(hào)碼格式校驗(yàn),當(dāng)前單個(gè)文件校驗(yàn)限制最多5000個(gè)號(hào)碼,超過(guò)限制提交會(huì)出錯(cuò)。結(jié)束華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)6AppCube5G消息標(biāo)準(zhǔn)版模板并發(fā)送01(2022-09-28)PAGE01(2022-09-28)PAGE266AppCube5G消息標(biāo)準(zhǔn)版模板并發(fā) 送創(chuàng)建5G消息應(yīng)用并配置通道信息在申請(qǐng)5G消息標(biāo)準(zhǔn)版模板前,需要先創(chuàng)建5G消息應(yīng)用,并配置通道信息。5G消息應(yīng)用開(kāi)發(fā)平臺(tái)提供以下3種方式創(chuàng)建應(yīng)用,一個(gè)應(yīng)用對(duì)應(yīng)一個(gè)ChatBot服務(wù)號(hào):創(chuàng)建空白應(yīng)用導(dǎo)入應(yīng)用基于模板創(chuàng)建創(chuàng)建5G消息應(yīng)用步驟1進(jìn)入5G消息應(yīng)用開(kāi)發(fā)平臺(tái)。使用企業(yè)帳號(hào)登錄華為云網(wǎng)站控制臺(tái)。在左側(cè)導(dǎo)航欄上方,單擊,選擇服務(wù)實(shí)例所在的區(qū)域項(xiàng)目。單擊 ,在查找中搜索“應(yīng)用魔方”。單擊查找出的結(jié)果,進(jìn)入AppCube管理控制臺(tái)。在AppCube管理控制臺(tái),單擊“進(jìn)入運(yùn)行環(huán)境”。單擊頁(yè)面頂部“5G消息”,進(jìn)入5G消息應(yīng)用開(kāi)發(fā)平臺(tái)。圖6-15G消息應(yīng)用開(kāi)發(fā)平臺(tái)步驟2創(chuàng)建5G消息應(yīng)用。5G消息應(yīng)用開(kāi)發(fā)平臺(tái)提供以下3種方式創(chuàng)建應(yīng)用,一個(gè)應(yīng)用對(duì)應(yīng)一個(gè)ChatBot服務(wù)號(hào):創(chuàng)建空白應(yīng)用在5G消息應(yīng)用開(kāi)發(fā)平臺(tái)右上角單擊“新建應(yīng)用+”。即可進(jìn)入5G消息應(yīng)用開(kāi)發(fā)界面。導(dǎo)入應(yīng)用該方式適用于不同環(huán)境中應(yīng)用的遷移,即將環(huán)境A中開(kāi)發(fā)好的5G消息應(yīng)用遷移導(dǎo)入到環(huán)境B中。獲取要導(dǎo)入的5G消息應(yīng)用包。圖6-2,在環(huán)境A的5G應(yīng)用界面,單擊應(yīng)用列表后的導(dǎo)出按鈕,導(dǎo)出應(yīng)用包。圖6-2導(dǎo)出應(yīng)用在環(huán)境B的5G消息應(yīng)用開(kāi)發(fā)平臺(tái)右上角單擊“新建應(yīng)用+”。設(shè)置應(yīng)用名稱(chēng),單擊“導(dǎo)入應(yīng)用”。將1即可進(jìn)入5G消息應(yīng)用開(kāi)發(fā)界面?;谀0鍎?chuàng)建在5G消息應(yīng)用開(kāi)發(fā)平臺(tái)右上角單擊“新建應(yīng)用+”。設(shè)置應(yīng)用名稱(chēng),單擊“基于模板創(chuàng)建”。即可進(jìn)入5G消息應(yīng)用開(kāi)發(fā)界面。結(jié)束配置通道信息

采用上面任一方式創(chuàng)建5G消息應(yīng)用后,需要參考如下步驟,配置通道信息。步驟1在菜單欄中,選擇“應(yīng)用配置>通道配置”。步驟2選擇“視頻短信”頁(yè)簽,配置視頻短信通道信息。配置值從1中申請(qǐng)通過(guò)后收到的郵件中獲取。其中“視頻短信地址”為iTA的發(fā)送視頻短信接口地址。結(jié)束制作5G消息標(biāo)準(zhǔn)版AppCube支持發(fā)送5G消息標(biāo)準(zhǔn)版。首先您需要新建5G消息標(biāo)準(zhǔn)版簽名和模板,然后通過(guò)投放任務(wù)發(fā)送給終端用戶(hù)。場(chǎng)景描述

例如,某外賣(mài)品牌推出了工作團(tuán)餐,通過(guò)AppCube制作如圖1所示促銷(xiāo)5G消息標(biāo)準(zhǔn)版內(nèi)容,使用群發(fā)的方式投放至終端用戶(hù)。圖6-3推廣工作團(tuán)餐前提條件

在制作5G消息標(biāo)準(zhǔn)版之前,需已完成如下操作:注冊(cè)華為賬號(hào)并完成認(rèn)證5G消息標(biāo)準(zhǔn)版服務(wù)5G消息標(biāo)準(zhǔn)版簽名簽名申請(qǐng)成功后,業(yè)務(wù)開(kāi)通結(jié)果以及接入賬號(hào)密碼和簽名等信息會(huì)通過(guò)郵件的形式通知。申請(qǐng)使用5G消息。使用企業(yè)帳號(hào)登錄5G消息產(chǎn)品頁(yè),單擊“公測(cè)體驗(yàn)”,進(jìn)入5G消息控制臺(tái)。單擊“立即申請(qǐng)”,申請(qǐng)使用5G消息功能。企業(yè)用戶(hù)按照界面提供的模板填寫(xiě)申請(qǐng)信息,申請(qǐng)通過(guò)后會(huì)收到郵件,郵件中包含服務(wù)號(hào)信息。企業(yè)用戶(hù)需要提供如下信息給工程師在戶(hù)才可使用5G消息功能。視頻短信模板審核通知回調(diào)地址:/fgsms/v1/vms/{chatbotid}/template-audit-notice視頻短信狀態(tài)報(bào)告回調(diào)地址:/fgsms/v1/vms/{chatbotid}/status-report-noticefgsms/v1/smschannel/{chatbotid}/inboundfgsms/v1/smschannel/{chatbotid}/deliveryinfonotification5G消息撤銷(xiāo)狀態(tài)通知地址:/fgsms/v1/smschannel/{chatbotid}/revokemessagestatusnotification5G消息媒體審核通知地址:/fgsms/v1/vms/{chatbotid}/audit-notification。由于5G多媒體文件。審核結(jié)果會(huì)下發(fā)到企業(yè)用戶(hù)。在這之前,華為云企業(yè)用戶(hù)需要將AppCube的如下回調(diào)地址提供給工程師在管理臺(tái)配置后,審核結(jié)果才會(huì)自動(dòng)下發(fā)到企業(yè)用戶(hù)。其中,{chatbotid}為ChatBotID,企業(yè)用戶(hù)參考1登錄AppCube運(yùn)行環(huán)境,打開(kāi)5G消息應(yīng)用,在瀏覽器網(wǎng)址中可獲取到該值。圖6-4獲取ChatBotID說(shuō)明業(yè)務(wù)開(kāi)通結(jié)果以及接入帳號(hào)密碼和簽名等信息會(huì)通過(guò)郵件的形式通知申請(qǐng)人。AppCube服務(wù),請(qǐng)參考購(gòu)買(mǎi)商用租戶(hù)。在應(yīng)用魔方AppCube運(yùn)行環(huán)境可以創(chuàng)建并開(kāi)發(fā)5G消息應(yīng)用。一個(gè)5G消息應(yīng)用對(duì)應(yīng)一個(gè)ChatBot服務(wù)號(hào)。您可以在5G消息應(yīng)用中開(kāi)發(fā)5G消息內(nèi)容、編排ChatBot服務(wù)號(hào)中的智能對(duì)話。創(chuàng)建5G消息應(yīng)用并配置通道信息已完成。制作視頻短信步驟1創(chuàng)建企業(yè)簽名。企業(yè)簽名用于在視頻短信中攜帶,用于標(biāo)識(shí)發(fā)送的企業(yè)。如圖6-5所示,短信中【X外賣(mài)】即企業(yè)簽名。圖6-5企業(yè)簽名在5G>企業(yè)簽名”。圖6-6選擇企業(yè)簽名圖6-7創(chuàng)建企業(yè)簽名表6-1企業(yè)簽名參數(shù)說(shuō)明參數(shù)說(shuō)明*企業(yè)名稱(chēng)企業(yè)的名稱(chēng)。和申請(qǐng)5G消息標(biāo)準(zhǔn)版簽名時(shí)填入的企業(yè)名稱(chēng)保持一致。*企業(yè)信息簽名視頻短信中攜帶的簽名內(nèi)容,格式【xxxx】。和申請(qǐng)5G消息標(biāo)準(zhǔn)版簽名時(shí)填入的“信息服務(wù)簽名”保持一致。*企業(yè)ID企業(yè)的ID。和申請(qǐng)5G消息標(biāo)準(zhǔn)版簽名成功后,發(fā)送通知郵件中的企業(yè)ID保持一致。描述描述信息。步驟2在5G消息應(yīng)用開(kāi)發(fā)界面上方選擇“內(nèi)容制作”,在“我的視頻短信”頁(yè)簽單擊“+新建視頻短信”。圖6-8新建視頻短信步驟3配置視頻短信。設(shè)置視頻短信名稱(chēng),例如“X圖6-9設(shè)置名稱(chēng)設(shè)置主題,例如“X外賣(mài),值得信賴(lài)”。圖6-10設(shè)置主題容。圖6-11設(shè)置短信內(nèi)容類(lèi)型有以下三種:靜態(tài)模板:短信內(nèi)容不攜帶變量。短信內(nèi)容示例為“我們?cè)谌珖?guó)范圍內(nèi)推出了工作團(tuán)餐,最低25元起,您可以微信關(guān)注X日的最大出餐量可達(dá)1萬(wàn)份,緩解疫情期間線下用餐的公共衛(wèi)生壓力。許多崗位,陸陸續(xù)續(xù)已經(jīng)開(kāi)始復(fù)工,但目前仍然是防疫、抗疫的關(guān)鍵時(shí)期,您身體的安好,是我們始終的希望,吃上一頓好飯,也是我們始終的堅(jiān)守,X外賣(mài),隨時(shí)為您提供一頓好飯。不用回復(fù)~”。固定參數(shù)動(dòng)態(tài)模板:短信內(nèi)容中需要攜帶動(dòng)態(tài)變量參數(shù)。動(dòng)態(tài)變量參數(shù)請(qǐng)使N<=10在全國(guó)范圍內(nèi)推出了工作團(tuán)餐,最低#p_1#元起”。個(gè)性化參數(shù)動(dòng)態(tài)模板:短信內(nèi)容中需要攜帶動(dòng)態(tài)變量參數(shù)。且動(dòng)態(tài)變量參數(shù)可能根據(jù)發(fā)送手機(jī)號(hào)碼不同而變動(dòng)。例如用戶(hù)A余額100元”,用戶(hù)B收到短信內(nèi)容為“您的話費(fèi)余額80元”,具體話費(fèi)需要?jiǎng)討B(tài)展示,則該短信需要配置為“個(gè)性化參數(shù)動(dòng)態(tài)模板”。在后續(xù)配置投放任務(wù)時(shí)下載模板填寫(xiě)號(hào)碼和參數(shù)。選擇步驟1中創(chuàng)建的企業(yè)簽名,可根據(jù)需要決定是否勾選“簽名信息單獨(dú)一行”。在左側(cè)選擇“素材”,在“我的素材”中上傳素材。選中合適的素材(視頻)拖入到右側(cè)編輯框中。您也可選擇“素材市場(chǎng)”,選用環(huán)境中已有的素材。圖6-12選擇素材次單擊上方,保存并提交審核步驟4單擊左上角“5G”,可返回視頻短信首頁(yè)。圖6-13返回視頻短信首頁(yè)說(shuō)明鼠標(biāo)放在已創(chuàng)建好的視頻短信,單擊消息上的圖標(biāo),可預(yù)覽、編輯、拷貝和刪除該視頻短信。圖6-14我的視頻短信結(jié)束創(chuàng)建群發(fā)視頻短信任務(wù)制作完視頻短信,用戶(hù)可通過(guò)創(chuàng)建投放任務(wù)給終端用戶(hù)發(fā)送視頻短信,支持群發(fā)。前提條件

制作5G消息標(biāo)準(zhǔn)版已完成。創(chuàng)建群發(fā)視頻短信任務(wù)步驟1創(chuàng)建群發(fā)的投放任務(wù)。在5G>圖6-15選擇投放任務(wù)參數(shù)說(shuō)明*任務(wù)名稱(chēng)任務(wù)的名稱(chēng)。描述任務(wù)描述信息。投放計(jì)劃支持“立即投放”和“定時(shí)投放”。若選擇“定時(shí)投放”,需要設(shè)置投放任務(wù)的啟動(dòng)時(shí)間。*投放內(nèi)容選擇審核通過(guò)的視頻短信。參數(shù)說(shuō)明*任務(wù)名稱(chēng)任務(wù)的名稱(chēng)。描述任務(wù)描述信息。投放計(jì)劃支持“立即投放”和“定時(shí)投放”。若選擇“定時(shí)投放”,需要設(shè)置投放任務(wù)的啟動(dòng)時(shí)間。*投放內(nèi)容選擇審核通過(guò)的視頻短信。*投放對(duì)象請(qǐng)輸入接收方手機(jī)號(hào)碼,若有多個(gè)號(hào)碼,以英文逗號(hào)“,下載后填寫(xiě)信息再單擊“上傳文件”進(jìn)行上傳。結(jié)束華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)華為云市場(chǎng)5G消息標(biāo)準(zhǔn)版(視頻短信)用戶(hù)手冊(cè)7API5G消息標(biāo)準(zhǔn)版01(2022-09-28)PAGE01(2022-09-28)PAGE39 7API5G消息標(biāo)準(zhǔn)版本章節(jié)所提到的視頻短信,即5G消息標(biāo)準(zhǔn)版。新手必備業(yè)務(wù)流程

視頻短信二次開(kāi)發(fā)業(yè)務(wù)整體流程如下:圖7-1二次開(kāi)發(fā)業(yè)務(wù)流程參考開(kāi)發(fā)準(zhǔn)備,獲取調(diào)用視頻短信API的關(guān)聯(lián)數(shù)據(jù)。創(chuàng)建視頻短信模板并提交審核。查看模板審核狀態(tài)報(bào)告。有兩種方法:調(diào)用模板審核結(jié)果通知接口,將模板審核的結(jié)果通知客戶(hù)??蛻?hù)自己調(diào)用模板查詢(xún)接口查詢(xún)結(jié)果。根據(jù)審核結(jié)果,判斷審核是否成功。若審核成功,則執(zhí)行5。若審核失敗,則參考通用結(jié)果碼修改后重新執(zhí)行2。參考代碼樣例調(diào)用視頻短信API,發(fā)起視頻短信發(fā)送請(qǐng)求。根據(jù)請(qǐng)求響應(yīng)消息,判斷請(qǐng)求是否成功。若請(qǐng)求成功,則執(zhí)行7。若請(qǐng)求失敗,則參考通用結(jié)果碼修改后重新執(zhí)行5。根據(jù)狀態(tài)報(bào)告通知,判斷視頻短信是否發(fā)送成功。若發(fā)送成功,則流程結(jié)束。若發(fā)送失敗,則參考通用結(jié)果碼修改后重新執(zhí)行5。開(kāi)發(fā)準(zhǔn)備參數(shù)名取值樣例描述信息視頻短信接入域地址:12800參數(shù)名取值樣例描述信息視頻短信接入域地址:12800用戶(hù)發(fā)送視頻短信的接入域地址。accountZhike下發(fā)賬號(hào)。請(qǐng)根據(jù)實(shí)際情況進(jìn)行填寫(xiě)。passwordZhike_123賬號(hào)明文密碼。請(qǐng)根據(jù)實(shí)際情況進(jìn)行填寫(xiě)。簽名信息test01企業(yè)審核通過(guò)的簽名信息。企業(yè)名稱(chēng)test02企業(yè)名稱(chēng)。請(qǐng)根據(jù)實(shí)際情況進(jìn)行填寫(xiě)。企業(yè)ID451df27d768849bea6370a31f61657cc企業(yè)ID。請(qǐng)根據(jù)實(shí)際情況進(jìn)行填寫(xiě)。API參考概述接口范圍說(shuō)明本文檔提供的接口為華為視頻短信接入平臺(tái)對(duì)外開(kāi)放的接口規(guī)范說(shuō)明。術(shù)語(yǔ)與縮略圖縮略語(yǔ)全稱(chēng)中文譯名說(shuō)明CPContentProvider內(nèi)容提供商-SPServiceProvider業(yè)務(wù)服務(wù)提供商-總體規(guī)范接口簡(jiǎn)介華為視頻短信平臺(tái)接入服務(wù)API接口為企業(yè)用戶(hù)提供了簡(jiǎn)單易用的API調(diào)用服務(wù),為開(kāi)發(fā)者在應(yīng)用內(nèi)快速、高效、低成本集成視頻短信提供了一站式服務(wù)。API采用了當(dāng)前流行的REST風(fēng)格設(shè)計(jì)和實(shí)現(xiàn),簡(jiǎn)潔易懂,支持多種主流開(kāi)發(fā)語(yǔ)言的調(diào)用,支持JSON數(shù)據(jù)傳遞方式,兼容了大部分用戶(hù)對(duì)API接口的需求。本API接口說(shuō)明規(guī)定了華為視頻短信平臺(tái)https接口的相關(guān)功能及協(xié)議,主要包括視頻模板創(chuàng)建,模板查詢(xún),創(chuàng)建發(fā)送視頻短信發(fā)送任務(wù)等等。接口格式說(shuō)明華為視頻短信接入平臺(tái)對(duì)外提供的接口統(tǒng)一為restful接口(HTTPS+JSON)訪問(wèn)認(rèn)證說(shuō)明華為視頻短信平臺(tái)接入服務(wù)會(huì)對(duì)HTTPS請(qǐng)求的頭域進(jìn)行校驗(yàn),調(diào)用客戶(hù)端需要將業(yè)務(wù)開(kāi)通時(shí)分配的用戶(hù)名和密碼以明文的方式封裝在請(qǐng)求header中的Authorization參數(shù),同時(shí)為了防止重放攻擊,業(yè)務(wù)請(qǐng)求發(fā)送時(shí),獲取的系統(tǒng)時(shí)間戳值也需要封裝在Authorization中的Timestamp參數(shù),統(tǒng)一采用UTC時(shí)間(世界協(xié)調(diào)時(shí))制式,格式為"yyyymmddhhmmss",即年月日時(shí)分秒(24小時(shí)制式),定長(zhǎng)14位。 注意過(guò)業(yè)務(wù)申請(qǐng)方注冊(cè)的郵箱地址進(jìn)行通知,需要妥善保存,防止泄露和遺失。生成的時(shí)間戳參數(shù)要為時(shí)間。器會(huì)拒絕接入請(qǐng)求。服務(wù)器時(shí)間誤差允許范圍為5分鐘。通用請(qǐng)求消息頭定義參數(shù)名類(lèi)型選項(xiàng)描述信息Content-TypeString必選取值為:application/json;charset=UTF-8參數(shù)名類(lèi)型選項(xiàng)描述信息AuthorizationString必選鑒權(quán)參數(shù)包含用戶(hù)名,密碼,時(shí)間戳信息,以逗號(hào)分隔,具體樣例參考如下Username="********",Password="********",Timestamp="20210114150300"消息頭樣例:Content-Type:application/json;charset=UTF-8Content-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"接口說(shuō)明模板創(chuàng)建接口描述通過(guò)該接口,調(diào)用客戶(hù)端可以上傳發(fā)送由一個(gè)或多個(gè)圖片、音頻、視頻資源文件組成的模板,上傳的資源文件支持BASE64編碼的內(nèi)容文件流。上傳成功后將獲得唯一的模板Id,在模板審核通過(guò)后,可將模板id+參數(shù)+發(fā)送號(hào)碼進(jìn)行視頻短信任務(wù)發(fā)送。為匹配不同省份運(yùn)營(yíng)商規(guī)則,模板大小建議在660KB-1.9MB之間,否則模板審核可能會(huì)被拒絕。支持上傳發(fā)送的素材資源類(lèi)型包括如下:文字text:txt(utf-8編碼的文字)圖片image:jpg/png/gif音頻audio:mp3請(qǐng)求方式POST請(qǐng)求URLhttps://{ServerRoot}/dmas/v1/video-message/north-access/create-template其中ServerRoot為接入客戶(hù)提供的主機(jī)IP或者域名+端口號(hào)。請(qǐng)求參數(shù)表7-2請(qǐng)求消息頭參數(shù)名類(lèi)型選項(xiàng)描述信息Content-TypeString必選取值為:application/json;charset=UTF-8參數(shù)名類(lèi)型選項(xiàng)描述信息AuthorizationString必選鑒權(quán)參數(shù)包含用戶(hù)名,密碼,時(shí)間戳信息,以逗號(hào)分隔,其中時(shí)間戳采用時(shí)間(世界協(xié)調(diào)時(shí))下Username="********",Password="********",Timestamp="20210114150300"表7-3請(qǐng)求消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息enterprise_idString32必選企業(yè)ID信息,由接入客戶(hù)在業(yè)務(wù)開(kāi)通時(shí)系統(tǒng)統(tǒng)一生成,通過(guò)郵件發(fā)送給接入客戶(hù)。如果接入客戶(hù)有代理多個(gè)企業(yè),則華為視頻短信平臺(tái)需要根據(jù)傳入的企業(yè)ID信息進(jìn)行業(yè)務(wù)交互和處理template_nameString100必選模板名稱(chēng)。注意:模板名稱(chēng)不能超過(guò)100個(gè)字符。template_typeInteger8必選模板類(lèi)型。1:靜態(tài)模板2:固定參數(shù)動(dòng)態(tài)模板3:個(gè)性化參數(shù)動(dòng)態(tài)模板具體使用場(chǎng)景參考模板類(lèi)型定義章節(jié)描述template_detailTemplateDetailInfo必選參考表7-4描述oper_typeInteger8必選操作類(lèi)型1:新增submit_typeInteger8必選提交類(lèi)型1:提交審核表7-4TemplateDetailInfo參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息message_tiString15必選短信標(biāo)題,最大不超過(guò)15個(gè)字符,若tle使用中文需經(jīng)過(guò)utf-8編碼。注意:標(biāo)題不能包含【】和其他特殊字符,否則會(huì)導(dǎo)致審核不通過(guò)。參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息res_listList<TemplateResource>必選資源列表信息,具體參考表7-5結(jié)構(gòu)描述,一個(gè)代表一幀,當(dāng)前單個(gè)模板最大只支持8幀內(nèi)容,一幀內(nèi)容中最多可以包含兩個(gè)元素,包含文本,圖片,視頻,音頻其中的一種。如果該幀內(nèi)容有兩個(gè)元素時(shí),其中有一個(gè)元素必須為文本。注意:1.模板上傳不支持單一文字,必須包含圖片,視頻或者音頻中的一種。2.不能留有空幀(超過(guò)將導(dǎo)致終端展示失?。?.第一副文本幀前面必須帶上簽名。4.模板內(nèi)容不能超過(guò)2M表7-5TemplateResource參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息indexString8必選一幀內(nèi)容中最多可以包含兩個(gè)元本。幀數(shù)序號(hào)從1開(kāi)始,如第一幀第一個(gè)元素index為1-1,第二個(gè)元素index為1-2,第二幀index為2-1,第二個(gè)元素index為2-2,第三幀第一個(gè)元素為3-1,第二個(gè)元素為3-2依次進(jìn)行類(lèi)推。typeString16必選資源類(lèi)型類(lèi)型為文字填:txt,類(lèi)型為圖片填:jpg/png/gif,類(lèi)型為音頻填:mp3,類(lèi)型為視頻填:mp4。注意:統(tǒng)一小寫(xiě)nameString32可選資源名稱(chēng)。sourceString8必選該字段表示資源是來(lái)自于文字還是文件流,txt表示資源內(nèi)容是純文字file:表示資源內(nèi)容來(lái)源于文件流。參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息contentString必選資源內(nèi)容。當(dāng)source=txt時(shí),填寫(xiě)經(jīng)過(guò)utf-8碼的文字;當(dāng)source=file時(shí),填寫(xiě)經(jīng)過(guò)base64編碼的文件流。模板創(chuàng)建支持在文本信息中攜帶變量發(fā)送,所以可以在文本中使用符號(hào)#p_n#進(jìn)行占位,其中n代表為1-10的整數(shù),如#p_1#,#p_2#..當(dāng)前最大支持10個(gè)動(dòng)態(tài)變量參數(shù)(模板中所有的文本信息)。注意:模板上傳不支持單一文字,必須包含圖片,視頻或者音頻中的一種。表7-6請(qǐng)求消息樣例類(lèi)型樣例json1.一幀一元素樣例:POST/dmas/v1/video-message/north-access/create-templateContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210122174500"Host:{"enterprise_id":"12334445","template_name":"模板名稱(chēng)","template_type":3,"template_detail":{"message_title":"華北地區(qū)優(yōu)惠贈(zèng)送","res_list":[{"index":"1-1","type":"txt","name":"文本.txt","source":"txt","content":"【華為云商城】尊敬的#p_1#你好,你#p_2#月的賬單如下:"},{"index":"2-1","type":"jpg","name":"圖片.jpg","source":"file","content":"圖片文件流的base64編碼字符串"},{"index":"3-1","type":"mp3","name":"聲音.mp3","source":"file","content":"聲音文件流的base64編碼字符串"},{"index":"4-1","type":"mp4","name":"視頻.mp4",類(lèi)型樣例"source":"file","content":"視頻文件流的base64編碼字符串"}]}2.一幀兩元素樣例:POST/dmas/v1/video-message/north-access/create-templateContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210122174500"Host:{"enterprise_id":"12334445","template_name":"模板名稱(chēng)","template_type":3,"template_detail":{"message_title":"華北地區(qū)優(yōu)惠贈(zèng)送"res_list":[{"index":"1-1","type":"txt","name":"文本.txt","source":"txt","content":"【華為云商城】尊敬的#p_1#你好,你#p_2#月的賬單如下:"},{"index":"1-2","type":"jpg","name":"圖片.jpg","source":"file","content":"圖片文件流的base64編碼字符串"},{"index":"2-1","type":"txt","name":"文本.txt","source":"txt","content":"【華為云商城】尊敬的#p_1#你好,你#p_2#月的賬單如下:"},類(lèi)型樣例{"index":"2-2","type":"mp4","name":"視頻.mp4","source":"file","content":"視頻文件流的base64編碼字符串"}]},"oper_type":1,"submit_type":1}響應(yīng)參數(shù)表7-7響應(yīng)消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_codeString16必選返回碼,0表示成功,其他表示失敗,失敗錯(cuò)誤碼參考其他描述rtn_descString256可選錯(cuò)誤碼描述template_idString32可選華為視頻短信接入服務(wù)生成的模板ID表7-8響應(yīng)消息樣例類(lèi)型樣例json返回消息示例:成功返回:{"rtn_code":"0","rtn_desc":"success","template_id":"808405902"}失敗返回:{"rtn_code":"00111010","rtn_desc":"模板幀數(shù)超出最大限制(8幀)"}模板查詢(xún)接口描述可以根據(jù)條件指定模板id或者模板id列表查詢(xún)模板的詳細(xì)信息,如審核結(jié)果和模板狀態(tài)等等,該接口支持單個(gè)模板查詢(xún),也支持批量模板列表查詢(xún)。請(qǐng)求方式POST請(qǐng)求URLhttps://{ServerRoot}/dmas/v1/video-message/north-access/query-templates-list其中ServerRoot為接入客戶(hù)提供的主機(jī)IP或者域名+端口號(hào)。請(qǐng)求參數(shù)表7-9請(qǐng)求消息頭參數(shù)名類(lèi)型選項(xiàng)描述信息Content-TypeString必選取值為:application/json;charset=UTF-8AuthorizationString必選鑒權(quán)參數(shù)包含用戶(hù)名,密碼,時(shí)間戳信息,以逗號(hào)分隔,其中時(shí)間戳采用時(shí)間(世界協(xié)調(diào)時(shí))下Username="********",Password="********",Timestamp="20210114150300"表7-10請(qǐng)求消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息template_idsString10000可選模板id,如果支持多個(gè)查詢(xún)時(shí)需要以逗號(hào)分隔,最大支持100個(gè)批量查詢(xún),該字段如果有值時(shí),則優(yōu)先按照模板ID進(jìn)行查詢(xún)匹配。distinguish_operatorsInteger8可選是否需要分運(yùn)營(yíng)商呈現(xiàn),0表示不區(qū)分,1表示區(qū)分,默認(rèn)為0。currentInteger8必選分頁(yè)參數(shù),默認(rèn)為1page_sizeInteger8必選每頁(yè)最大個(gè)數(shù),默認(rèn)為20,最大支持100個(gè)表7-11請(qǐng)求消息樣例類(lèi)型樣例jsonPOST/dmas/v1/video-message/north-access/query-templates-listContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"Host:{"template_ids":"123344,1234677","distinguish_operators":0,"current":1,"page_size":20}響應(yīng)參數(shù)表7-12響應(yīng)消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_codeString8必選返回碼,0表示成功,其他表示失敗,失敗錯(cuò)誤碼參考其他描述參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_descString256可選錯(cuò)誤碼描述page_infoPage可選頁(yè)面數(shù)據(jù)信息,參考Page數(shù)據(jù)結(jié)構(gòu)定義template_info_listList<TemplateInfo>可選模板詳情列表信息,單個(gè)查詢(xún)時(shí),默認(rèn)只取第一條模板返回值,具體參考TemplateInfo數(shù)據(jù)結(jié)構(gòu)定義表7-13Page參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息currentInteger8必選分頁(yè)其實(shí)頁(yè),取值從為1開(kāi)始的整數(shù)page_sizeInteger8必選每頁(yè)包含條數(shù)。total_recordInteger8必選查詢(xún)匹配總記錄total_pageInteger8必選查詢(xún)匹配總頁(yè)數(shù)表7-14TemplateInfo參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息template_idString32必選模板idtemplate_nameString100必選模板名稱(chēng)template_typeInteger8必選模板類(lèi)型1:23:個(gè)性化參數(shù)動(dòng)態(tài)模板template_statusString8可選模板狀態(tài):1.模板啟用2:模板禁用3:草稿create_timeString32必選模板創(chuàng)建時(shí)間update_timeString32可選模板更新時(shí)間參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息audit_resultInteger8可選0:1:審核拒2:審核中3:未提交審核34:提交審核失敗reject_reasonString256可選審核拒絕原因template_detailTemplateDetailInfo必選模板詳情信息,具體參考TemplateDetailInfo數(shù)據(jù)結(jié)構(gòu)描述operator_statusString8可選以3狀態(tài)。通;第三位:電信填值,0表示審核中;1審核成功;2表示審核失敗。通道全部失敗記為2,任一送審?fù)ǖ浪蛯彸晒τ涗洖?,否則記錄為0。示例:102表示移動(dòng)有通道審核通過(guò),聯(lián)通尚無(wú)通道送審成功,但仍有通道送審中,電信全部通道送審失敗。表7-15響應(yīng)消息樣例類(lèi)型樣例json返回消息示例:成功返回:{"rtn_code":0,"rtn_desc":"success","page_info":{"current":1,"page_size":20,"total_record":2,"total_page":1},"template_info_list":[{"template_id":"123344","template_name":"電力賬單模板","template_type":3,"template_status":0,"create_time":"20200116095311","update_time":"20200116095311","audit_result":0,"reject_reason":"xxx","template_detail":{"message_title":"華北地區(qū)優(yōu)惠贈(zèng)送","res_list":[{"index":"1-1","type":"txt","name":"文本.txt","source":"txt","content":"尊敬的#p_1#你好,你#p_2#月的賬單如下:"},{"index":"2-1","type":"jpg","name":"圖片.jpg","source":"url","content":"圖片文件流BASE64編碼"}]}類(lèi)型樣例},{"template_id":"1234677","template_name":"促銷(xiāo)模板","template_type":1,"template_status":0,"create_time":"20200116095311","update_time":"20200116095311","audit_result":0,"reject_reason":"xxx","template_detail":{"message_title":"充100送200","res_list":[{"index":"1-1","type":"txt","name":"文本.txt","source":"txt","content":"迎賓大活動(dòng)正式揭幕"},{"index":"2-1","type":"jpg","name":"圖片.jpg","source":"file","content":"圖片文件流BASE64編碼"}]},"operator_status":""}]}視頻短信發(fā)送任務(wù)接口描述通過(guò)該接口可以直接使用模板Id+發(fā)送號(hào)碼+動(dòng)靜態(tài)參數(shù)發(fā)送視頻短信。對(duì)于不同的模板類(lèi)型,需要攜帶對(duì)應(yīng)的參數(shù)進(jìn)行發(fā)送,具體使用場(chǎng)景參考模板類(lèi)型定義章節(jié)描述。請(qǐng)求方式POST請(qǐng)求URLhttps://{ServerRoot}/dmas/v1/video-message/north-access/create-task其中ServerRoot為接入客戶(hù)提供的主機(jī)IP或者域名+端口號(hào)。請(qǐng)求參數(shù)表7-16請(qǐng)求消息頭參數(shù)名類(lèi)型選項(xiàng)描述信息Content-TypeString必選取值為:application/json;charset=UTF-8AuthorizationString必選鑒權(quán)參數(shù)包含用戶(hù)名,密碼,時(shí)間戳信息,以逗號(hào)分隔,其中時(shí)間戳采用時(shí)間(世界協(xié)調(diào)時(shí))下Username="********",Password="********",Timestamp="20210114150300"表7-17請(qǐng)求消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息enterprise_idString32必選企業(yè)ID信息,由接入客戶(hù)在業(yè)務(wù)開(kāi)通時(shí)系統(tǒng)統(tǒng)一生成,通過(guò)郵件發(fā)送給接入客戶(hù)。如果接入客戶(hù)有代理多個(gè)企業(yè),則華為視頻短信平臺(tái)需要根據(jù)傳入的企業(yè)ID信息進(jìn)行業(yè)務(wù)交互和處理task_nameString128必填任務(wù)名稱(chēng),需要保證唯一性。template_idString32必填關(guān)聯(lián)模板id,必須要是審核通過(guò)可以正常發(fā)送的模板task_send_modeInteger8必填發(fā)送模式1:立即發(fā)送task_send_mobilesTaskSendMobiles必填發(fā)送號(hào)碼信息,具體請(qǐng)參考TaskSendMobiles數(shù)據(jù)結(jié)構(gòu)定義表7-18TaskSendMobiles參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息send_template_typeInteger8必選1:2:3:個(gè)性化參數(shù)動(dòng)態(tài)模板send_mobilesString19可發(fā)送號(hào)碼時(shí)號(hào)碼填入該字段以00選逗號(hào)分隔,最大支持5000個(gè)號(hào)00碼注意:只有選擇發(fā)送模板類(lèi)型為1靜態(tài)模板和2固定參數(shù)模板時(shí),該字段需要填入發(fā)送號(hào)碼。send_contentsString10可固定參數(shù),當(dāng)發(fā)送任務(wù)的模板00選類(lèi)型選擇固定參數(shù)動(dòng)態(tài)模板時(shí)0有值。注意:send_contents字段為JSON字符串格式。dynamic_send_mList<DynamicSendI可只有選擇個(gè)性化參數(shù)動(dòng)態(tài)模板obilesnfo>選時(shí),需要填充該參數(shù),參考DynamicSendInfo數(shù)據(jù)結(jié)構(gòu)定義表7-19DynamicSendInfo參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息send_mobileString32可選發(fā)送的單個(gè)號(hào)碼注意發(fā)送模板類(lèi)型選擇3參數(shù)動(dòng)態(tài)模板時(shí),該字段需要填入發(fā)送號(hào)碼(單個(gè))。參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息para_valueMap<String,Object>可選填寫(xiě)需要給每個(gè)號(hào)碼分配的動(dòng)態(tài)參數(shù)值,采用Map<String,Object>結(jié)構(gòu),具體格式參考如下:{“p1”:object1,“p2”:object2}其中Object為json對(duì)象其屬性格式如下:{"type":"txt","source":"txt","content":"sss"}type和source是固定的txt,目前只支持txt文本的變量。其中sss為需要傳入的動(dòng)態(tài)參數(shù)值。表7-20請(qǐng)求消息樣例類(lèi)型樣例json靜態(tài)模板視頻短信發(fā)送:POST/dmas/v1/video-message/north-access/create-taskContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"Host:{"enterprise_id":"1234455","task_name":"河北地區(qū)發(fā)送","template_id":"1233456","task_send_mode":1,"task_send_time":"","task_send_mobiles":{"send_template_type":1,"send_mobiles":"138xxxxxxxx,137xxxxxxxx,136xxxxxxxx"}}固定參數(shù)動(dòng)態(tài)模板視頻短信發(fā)送POST/dmas/v1/video-message/north-access/create-taskContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"Host:{"enterprise_id":"1234455","task_name":"華北地區(qū)優(yōu)惠推廣","template_id":"453312233","task_send_mode":1,"task_send_mobiles":{"send_template_type":2,"send_mobiles":"138xxxxxxxx,137xxxxxxxx,136xxxxxxxx","send_contents":"{\"p1\":{\"content\":\"齊先生\",\"source\":\"txt\",\"type\":\"txt\"},\"p2\":{\"content\":\"二月份\",\"source\":\"txt\",\"type\":\"txt\"}}"}}個(gè)性化參數(shù)動(dòng)態(tài)模板視頻短信發(fā)送POST/dmas/v1/video-message/north-access/create-task類(lèi)型樣例Content-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"Host:{"enterprise_id":"1234455","task_name":"淘寶促銷(xiāo)推廣","template_id":"1237778","task_send_mode":1,"task_send_mobiles":{"send_template_type":3,"dynamic_send_mobiles":["para_value":{"p1":{"type":"txt","source":"txt","content":"sss"},"p2":{"type":"txt","source":"txt","p3":{"type":"txt","source":"txt","content":"xxxx"}}},"para_value":{"p1":{"type":"txt","source":"txt","content":"sss"},"p2":{"type":"txt","source":"txt","p3":{"type":"txt","source":"txt","content":"xxxx"}}}類(lèi)型樣例]}}響應(yīng)參數(shù)表7-21響應(yīng)消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_codeString32必選返回碼,0表示成功,其他表示失敗,失敗錯(cuò)誤碼參考其他描述rtn_descString256可選錯(cuò)誤碼描述task_idString32可選生成的任務(wù)ID表7-22響應(yīng)消息樣例類(lèi)型樣例json返回消息示例:成功返回:{"rtn_code":"0","rtn_desc":"success"}失敗返回:{"rtn_code":"00111019","rtn_desc":"發(fā)送號(hào)碼數(shù)超出指定個(gè)數(shù)(5000個(gè))"}發(fā)送任務(wù)列表查詢(xún)接口描述該接口用于查詢(xún)視頻短信發(fā)送任務(wù)列表記錄,由于數(shù)據(jù)量過(guò)大,目前系統(tǒng)只保存前面天數(shù)據(jù)。建議接入客戶(hù)自行利用狀態(tài)報(bào)告回調(diào)接口推送結(jié)果保存發(fā)送的詳細(xì)記錄信息。請(qǐng)求方式POST請(qǐng)求URLhttps://{ServerRoot}/dmas/v1/video-message/north-access/query-send-task-list其中ServerRoot為接入客戶(hù)提供的主機(jī)IP或者域名+端口號(hào)。請(qǐng)求參數(shù)表7-23請(qǐng)求消息頭參數(shù)名類(lèi)型選項(xiàng)描述信息Content-TypeString必選取值為:application/json;charset=UTF-8AuthorizationString必選鑒權(quán)參數(shù)包含用戶(hù)名,密碼,時(shí)間戳信息,以逗號(hào)分隔,其中時(shí)間戳采用時(shí)間(世界協(xié)調(diào)時(shí))下Username="********",Password="********",Timestamp="20210114150300"表7-24請(qǐng)求消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息task_idsString10000選填任務(wù)id列表,如果存在多個(gè)任務(wù)則用逗號(hào)分隔,最大支持100個(gè)批量查詢(xún),如果task_ids有值,優(yōu)先以該字段值作為查詢(xún)條件。currentinteger8選填當(dāng)前頁(yè),默認(rèn)為1page_sizeinteger8選填每頁(yè)顯示個(gè)數(shù),默認(rèn)為20個(gè),每頁(yè)最大返回100條。表7-25請(qǐng)求消息樣例類(lèi)型樣例jsonPOST/dmas/v1/video-message/north-access/query-send-task-listContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"Host:{"task_ids":"12345676,12334455","current":1,"page_size":20}響應(yīng)參數(shù)表7-26響應(yīng)消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_codeString32必選返回碼,0表示成功,其他表示失敗,失敗錯(cuò)誤碼參考其他描rtn_descString256可選錯(cuò)誤碼描述page_infoPage8可選頁(yè)面數(shù)據(jù)信息,參考Page數(shù)據(jù)結(jié)構(gòu)定義task_info_listList<TaskInfo>可選模板詳情列表信息,單個(gè)查詢(xún)時(shí),默認(rèn)只取第一條模板返回值,具體參考TaskInfo數(shù)據(jù)結(jié)構(gòu)定義表7-27TaskInfo參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息task_idString32必選任務(wù)idtask_nameString128必選任務(wù)名稱(chēng)template_nameString32必選關(guān)聯(lián)模板名稱(chēng)template_idString32必選關(guān)聯(lián)模板idtemplate_typeInteger8必選關(guān)聯(lián)模板類(lèi)型參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息task_send_modeInteger8必選任務(wù)發(fā)送模式:1立即發(fā)送task_send_statusInteger8必選任務(wù)發(fā)送狀態(tài):0發(fā)送成功1發(fā)送失敗2發(fā)送中3待發(fā)送task_submit_timeString32必選任務(wù)提交時(shí)間task_send_timeString32可選任務(wù)發(fā)送時(shí)間task_send_amountInteger8可選發(fā)送用戶(hù)數(shù)task_send_success_amountInteger8可選發(fā)送成功數(shù)量task_send_fail_amountInteger8可選發(fā)送失敗數(shù)量表7-28響應(yīng)消息樣例類(lèi)型樣例json返回消息示例:成功返回:{"rtn_code":"0","rtn_desc":"success","page_info":{"current":1,"page_size":20,"total_record":1,"total_page":1},"task_info_list":[{"task_id":"123456","task_name":"xxx","template_name":"yyy","template_id":"213344","template_type":1,"task_send_mode":2,"task_send_status":0,"task_submit_time":"20210122123300","task_send_time":"20210122133300","task_send_amount":1000,"task_send_fail_amount":0}]}發(fā)送任務(wù)狀態(tài)報(bào)告查詢(xún)接口描述根據(jù)指定的task_id獲取該發(fā)送任務(wù)發(fā)送狀態(tài)的詳細(xì)報(bào)告,包括發(fā)送任務(wù)中每個(gè)號(hào)碼的發(fā)送結(jié)果。該接口僅支持?jǐn)?shù)據(jù)業(yè)務(wù)量較少的中小企業(yè)查詢(xún),大型企業(yè)產(chǎn)生的發(fā)送任務(wù)狀態(tài)報(bào)告通過(guò)回調(diào)接口進(jìn)行推送。請(qǐng)求方式POST請(qǐng)求URLhttps://{ServerRoot}/dmas/v1/video-message/north-access/query-statics-report其中ServerRoot為接入客戶(hù)提供的主機(jī)IP或者域名+端口號(hào)。請(qǐng)求參數(shù)表7-29請(qǐng)求消息頭參數(shù)名類(lèi)型選項(xiàng)描述信息Content-TypeString必選取值為:application/json;charset=UTF-8AuthorizationString必選鑒權(quán)參數(shù)包含用戶(hù)名,密碼,時(shí)間戳信息,以逗號(hào)分隔,其中時(shí)間戳采用時(shí)間(世界協(xié)調(diào)時(shí))下Username="********",Password="********",Timestamp="20210114150300"表7-30請(qǐng)求消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息task_idString32必填任務(wù)ID,只支持單個(gè)查詢(xún)。表7-31請(qǐng)求消息樣例類(lèi)型樣例jsonPOST/dmas/v1/video-message/north-access/query-statics-reportContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"Host:{"task_id":"12356"}響應(yīng)參數(shù)表7-32響應(yīng)消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_codeString32必選返回碼,0表示成功,其他表示失敗,失敗錯(cuò)誤碼參考其他描述參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_descString256可選錯(cuò)誤碼描述task_idString32必選發(fā)送任務(wù)IDsend_total_amountInteger16必選發(fā)送總數(shù)send_success_amountInteger16必選發(fā)送成功數(shù)send_fail_amountInteger16必選發(fā)送失敗數(shù)mobile_send_status_listList<MobileSendStatus>必選發(fā)送任務(wù)列表狀態(tài),具體參考MobileSendStatus結(jié)構(gòu)定義。表7-33MobileSendStatus參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息mobile_numberString32必選發(fā)送號(hào)碼deliver_statusInteger8必選0成功1失敗如果還未生成狀態(tài)報(bào)告的號(hào)碼則不在該接口中返回。error_descString256可選失敗描述(發(fā)送結(jié)果為失敗時(shí)有值)表7-34響應(yīng)消息樣例類(lèi)型樣例json返回消息示例:成功返回:{"rtn_code":"0","rtn_desc":"success","task_id":"1234456","send_total_amount":2,"send_success_amount":1,"send_fail_amount":1,"mobile_send_status_list":[{"mobile_number":"176xxxxxxxx","deliver_status":0,"error_desc":""},{"mobile_number":"186xxxxxxxx","deliver_status":1,"error_desc":"發(fā)送號(hào)碼格式不正確"}]}模板審核結(jié)果通知接口描述接入客戶(hù)提交的模板完成審核后,由該接口通過(guò)回調(diào)的方式將模板審核的結(jié)果通知接入客戶(hù),接入客戶(hù)需要提供提供回調(diào)地址,建議參考下面請(qǐng)求URL格式定義。注意:該接口需要由接入客戶(hù)提供請(qǐng)求方式POST請(qǐng)求URLhttps://{ServerRoot}/dmas/v1/video-message/call-back/template-audit-notice其中ServerRoot為接入客戶(hù)提供的主機(jī)IP或者域名+端口號(hào)。請(qǐng)求參數(shù)表7-35請(qǐng)求消息頭參數(shù)名類(lèi)型選項(xiàng)描述信息Content-TypeString必選取值為:application/json;charset=UTF-8AuthorizationString必選鑒權(quán)參數(shù)包含用戶(hù)名,密碼,時(shí)間戳信息,以逗號(hào)分隔,其中時(shí)間戳采用時(shí)間(世界協(xié)調(diào)時(shí))下Username="********",Password="********",Timestamp="20210114150300"表7-36請(qǐng)求消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息template_idString32必填模板idtemplate_nameString128必填模板名稱(chēng)audit_resultInteger8必填審核結(jié)果:0:審核通過(guò)1:審核不通過(guò)2:審核失敗audit_reject_reasonString256選填審核拒絕原因remarkString256選填備注信息表7-37請(qǐng)求消息樣例類(lèi)型樣例jsonPOST/dmas/v1/video-message/call-back/template-audit-noticeContent-Type:application/json;charset=UTF-8Authorization:Username="********",Password="********",Timestamp="20210114150300"Host:{"template_id":"12356","template_name":"江蘇省推廣營(yíng)銷(xiāo)模板","audit_result":0,"audit_reject_reason":"","remark":""}響應(yīng)參數(shù)表7-38響應(yīng)消息體參數(shù)名稱(chēng)類(lèi)型長(zhǎng)度可選必選描述信息rtn_codeString32必選返回碼,0表示成功,其他表示失敗。rtn_descString256可選錯(cuò)誤碼描述表7-39響應(yīng)消息樣例類(lèi)型樣例json返回消息示例:成功返回:{"rtn_code":"0","rtn_desc":"success"}發(fā)送任務(wù)狀

溫馨提示

  • 1. 本站所有資源如無(wú)特殊說(shuō)明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶(hù)所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁(yè)內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒(méi)有圖紙預(yù)覽就沒(méi)有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶(hù)上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶(hù)上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶(hù)因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。

評(píng)論

0/150

提交評(píng)論