回執(zhí)消息簡(jiǎn)介與配置流程
當(dāng)您使用隱私號(hào)碼服務(wù)綁定一組隱私關(guān)系后，可以通過輕量消息隊(duì)列（原MNS）消費(fèi)模式或HTTP批量推送模式來(lái)接收話單回執(zhí)消息。話單回執(zhí)消息記錄了所有的通話記錄行為。
注意事項(xiàng)
如果出現(xiàn)網(wǎng)絡(luò)異常、響應(yīng)超時(shí)等情況，可能導(dǎo)致回執(zhí)消息推送重復(fù)。
HTTP批量推送模式的響應(yīng)超時(shí)時(shí)間為700 ms。
使用SDK拉取輕量消息隊(duì)列（原MNS）回執(zhí)消息，詳情請(qǐng)參見消息回執(zhí)API Demo。
回執(zhí)消息不保證冪等性，如果開發(fā)者后續(xù)處理邏輯需要考慮冪等性，需要根據(jù)業(yè)務(wù)場(chǎng)景做合適的冪等處理。
回執(zhí)消息模式
接收回執(zhí)消息的模式有輕量消息隊(duì)列（原MNS）消費(fèi)模式和HTTP批量推送模式兩種，您可根據(jù)實(shí)際情況選擇合適的模式接收回執(zhí)消息。
輕量消息隊(duì)列（原MNS）消費(fèi)模式
輕量消息隊(duì)列（原MNS）消費(fèi)模式表示通過輕量消息隊(duì)列（原MNS）的Queue模型來(lái)接收回執(zhí)消息。云通信的所有業(yè)務(wù)消息都用過輕量消息隊(duì)列（原MNS）向外發(fā)送。用戶在號(hào)碼隱私保護(hù)控制臺(tái)啟用輕量消息隊(duì)列（原MNS）訂閱指定的消息類型時(shí)，系統(tǒng)會(huì)自動(dòng)生成該類型的獨(dú)立消息隊(duì)列及名稱（QueueName）。您可以使用此消息隊(duì)列名稱和消息類型，通過阿里云AccessKey信息換取的臨時(shí)Token來(lái)獲取隊(duì)列中的詳細(xì)內(nèi)容。
HTTP批量推送模式
HTTP批量推送模式表示通過HTTP和POST方式發(fā)送消息到指定的Web URL。在號(hào)碼隱私保護(hù)控制臺(tái)設(shè)置HTTP回調(diào)URL（callback_url）后，當(dāng)業(yè)務(wù)消息產(chǎn)生時(shí)，系統(tǒng)會(huì)使用HTTP請(qǐng)求以POST方式將業(yè)務(wù)消息發(fā)送到指定的回調(diào)URL上，用戶可直接接收此消息。
回執(zhí)消息類型
號(hào)碼隱私保護(hù)提供的回執(zhí)消息類型（MessageType）如下，您可根據(jù)業(yè)務(wù)需要進(jìn)行選擇。
名稱 | 描述 | 輕量消息隊(duì)列（原MNS）消費(fèi)模式 | HTTP批量推送模式 |
SecretStartReport（呼叫發(fā)起時(shí)話單報(bào)告） | 呼叫發(fā)起時(shí)立即獲取到通話記錄信息，包括通話開始時(shí)間、主被叫號(hào)碼等，便于平臺(tái)進(jìn)行預(yù)判處理。 | ||
SecretRingReport（呼叫響鈴時(shí)報(bào)告） | 呼叫響鈴時(shí)獲取呼叫過程中的響鈴信息，包括呼叫號(hào)碼、呼叫類型、響鈴時(shí)間等。 | ||
SecretPickUpReport（呼叫接聽時(shí)報(bào)告） | 呼叫接聽時(shí)獲取呼叫過程中的摘機(jī)信息，包括號(hào)碼信息、號(hào)碼類型、接聽時(shí)間等。 | ||
SecretReport（呼叫結(jié)束后話單報(bào)告） | 呼叫結(jié)束后獲取通話記錄信息，包括通話開始時(shí)間、通話結(jié)束時(shí)間、主被叫號(hào)碼等，便于平臺(tái)進(jìn)行管理。 | ||
SecretRecording（錄音狀態(tài)報(bào)告） | 通話結(jié)束后獲取通話的錄音記錄。 | ||
SecretAsrReport（錄音ASR狀態(tài)報(bào)告） | 獲取通話中的實(shí)時(shí)文本轉(zhuǎn)換結(jié)果。 | ||
SecretExceptionPhoneReport（異常號(hào)碼狀態(tài)推送） | 檢測(cè)當(dāng)前號(hào)碼異常狀態(tài)，對(duì)異常號(hào)碼實(shí)行策略降級(jí)。 | - | |
SmartLogisticsReport（電商物流詳細(xì)報(bào)告） | 獲取電商物流節(jié)點(diǎn)詳情。 說(shuō)明 開通電商物流詳細(xì)報(bào)告消息功能，詳情請(qǐng)咨詢您的商務(wù)經(jīng)理。 | ||
NumberManagementReport（號(hào)碼管理信息） | 實(shí)現(xiàn)號(hào)碼線上化管理。 |
配置回執(zhí)消息接收模式
如果您需要接收回執(zhí)消息，必須先在號(hào)碼隱私保護(hù)控制臺(tái)上開啟消息接收。
在概覽頁(yè)面中找到云通信消息接收區(qū)域。
在云通信消息接收區(qū)域，找到需要訂閱的消息類型，并選擇所需的消息發(fā)送模式。
輕量消息隊(duì)列（原MNS）消費(fèi)模式。
開啟輕量消息隊(duì)列（原MNS）消費(fèi)模式左側(cè)的功能開關(guān)。
單擊新建隊(duì)列。
設(shè)置隊(duì)列名稱并勾選關(guān)聯(lián)的號(hào)碼池。
重要初始狀態(tài)下，沒有關(guān)聯(lián)過隊(duì)列的號(hào)碼池統(tǒng)一使用默認(rèn)隊(duì)列接收消息。
單擊確定。
HTTP批量推送模式。
開啟HTTP批量推送模式的功能開關(guān)。
說(shuō)明部分消息類型沒有HTTP批量推送模式，請(qǐng)以控制臺(tái)顯示的消息類型為準(zhǔn)。如：異常號(hào)碼狀態(tài)推送無(wú)HTTP批量推送模式。
填寫接收地址，地址示例：http://push.example.com/contextpath/receive.do。
單擊保存。