語音通知API接口文檔主要用于指導(dǎo)開發(fā)者對接互億無線語音通知服務(wù)接口。開發(fā)者可以通過 HTTP/HTTPS 協(xié)議，調(diào)用互億平臺(tái)提供的語音通知發(fā)送、余額查詢、模板管理和回執(zhí)推送等功能，實(shí)現(xiàn)語音類業(yè)務(wù)通知的自動(dòng)化。

一、接口功能簡介

語音發(fā)送功能
支持通過 POST 或 GET 請求提交語音內(nèi)容，發(fā)送至中國內(nèi)地手機(jī)或固話號(hào)碼。僅支持單個(gè)號(hào)碼發(fā)送，內(nèi)容需基于審核通過的語音模板。內(nèi)容格式采用 UTF-8 編碼，接口返回發(fā)送結(jié)果及流水號(hào)。

余額查詢功能
提供實(shí)時(shí)查詢語音服務(wù)剩余條數(shù)的接口，便于開發(fā)者在發(fā)送前評估賬號(hào)資源使用情況。

模板管理功能
開發(fā)者可通過接口提交語音通知模板，模板需提取變量后報(bào)備審核；審核通過后方可使用。支持通過接口刪除模板，也支持模板審核狀態(tài)的回調(diào)通知。

回執(zhí)推送功能
在語音通知發(fā)送后，平臺(tái)會(huì)將通話結(jié)果（如接聽狀態(tài)、時(shí)長、失敗原因等）通過 POST 方式推送到開發(fā)者配置的接收地址。推送包含通話狀態(tài)碼與時(shí)間信息，便于后續(xù)處理和數(shù)據(jù)分析。

加密方式與驗(yàn)證機(jī)制
接口采用 HTTPS 協(xié)議進(jìn)行數(shù)據(jù)傳輸，配合 MD5 動(dòng)態(tài)簽名進(jìn)行參數(shù)加密，確保通信過程的安全性。所有接口均需使用在用戶中心獲取的 APIID 與 APIKEY。

二、適用場景舉例

• 訂單通知：系統(tǒng)自動(dòng)撥打語音電話提醒客戶訂單已發(fā)貨。
• 客戶提醒：自動(dòng)語音提示客戶即將到期的服務(wù)或合同。
• 節(jié)日祝福：按模板批量發(fā)送個(gè)性化語音祝福。
• 安全驗(yàn)證：通過語音發(fā)送驗(yàn)證碼進(jìn)行身份確認(rèn)。

下載語音通知API接口文檔