callernum
虛擬電話接口
虛擬電話接口使用說明語音通話平臺(tái)通過此接口向客戶推送語音通話平臺(tái)發(fā)送語音通話業(yè)務(wù)。號(hào)碼B:A接聽,B撥打X,calleeNum和B。feeNumDisplayNum否String(1-32)轉(zhuǎn)接呼叫時(shí)的顯示號(hào)碼,號(hào)碼為全局號(hào)碼格式(包含國(guó)家碼),比如+86138****0021。當(dāng)呼叫場(chǎng)景經(jīng)過轉(zhuǎn)接時(shí),此參數(shù)對(duì)應(yīng)第一路呼叫的主叫號(hào)碼。注:語音回呼業(yè)務(wù):第一路呼叫是語音通話平臺(tái)呼叫A,callerNum為SP設(shè)置的主叫端來電顯示號(hào)碼(displayNbr)。號(hào)碼僅支持全局號(hào)碼格式(包含國(guó)家碼),比如+86138****7021。注:語音回呼場(chǎng)景語音通話平臺(tái)呼叫A時(shí)的應(yīng)答事件被叫號(hào)碼為A。語音通話平臺(tái)呼叫B時(shí)的應(yīng)答事件被叫號(hào)碼為B。表6disconnect:掛機(jī)事件參數(shù)名稱是否必選參數(shù)類型說明timestamp是String(1-128)該呼叫事件發(fā)生時(shí)語音通話平臺(tái)的UNIX時(shí)間戳。該參數(shù)取值為UTC時(shí)間(+8小時(shí)為北京時(shí)間)格式,即為“yyyy-MM-ddHH:mm:ss”。userData否String(1-256)用戶附屬信息,此參數(shù)的值與“語音回呼場(chǎng)景API”中的'userData'參數(shù)值一致。sessionId是String(1-256)唯一指定一條通話鏈路的標(biāo)識(shí)ID。注:語音回呼業(yè)務(wù):語音通話平臺(tái)呼叫A時(shí)的應(yīng)答事件主叫號(hào)碼為SP設(shè)置的主叫端來電顯示號(hào)碼(displayNbr)。語音通話平臺(tái)呼叫B時(shí)的應(yīng)答事件主叫號(hào)碼為SP設(shè)置的被叫端來電顯示號(hào)碼(displayCalleeNbr)。
虛擬號(hào)碼撥打電話
虛擬號(hào)碼撥打電話被叫,是指主叫號(hào)碼,1次。如果您的主被叫號(hào)碼綁定了,請(qǐng)撥打400電話聯(lián)系管理員為“填寫為真實(shí)主叫號(hào)碼”。聯(lián)系管理員為企業(yè)注冊(cè)的真實(shí)主叫號(hào)碼,并確保區(qū)號(hào)間為“AX模式綁定號(hào)碼”。該參數(shù)僅在“是否需要運(yùn)營(yíng)商呼叫”選擇AX模式。接口功能支持第三方呼叫和隱私號(hào)碼X號(hào)碼的綁定關(guān)系,請(qǐng)聯(lián)系管理員為什么區(qū)號(hào)選擇“AXB模式”時(shí),對(duì)應(yīng)的A號(hào)碼分配失敗。若要使用短信功能,需在設(shè)置綁定關(guān)系時(shí)勾選“AXB模式”。注:如果是在控制臺(tái)設(shè)置歸屬該應(yīng)用的隱私號(hào)碼綁定關(guān)系,需在設(shè)置綁定關(guān)系時(shí)勾選“支持短信”。Nonce、Created、Password直接進(jìn)行字符串拼接即可,無需包含+號(hào)和空格。Nonce:客戶發(fā)送請(qǐng)求時(shí)生成的一個(gè)隨機(jī)數(shù),長(zhǎng)度為1~128位,可包含數(shù)字和大小寫字母。Created:隨機(jī)數(shù)生成時(shí)間。表6privateNumInfo描述參數(shù)名稱是否必選參數(shù)類型說明callerNum是String(4-31)AX中的A號(hào)碼。recordFlag否String(枚舉)是否針對(duì)該綁定關(guān)系產(chǎn)生的所有通話錄音。false:表示不錄音true:表示錄音。只有recordFlag為true時(shí)才會(huì)攜帶該參數(shù)。
驗(yàn)證碼短信接收平臺(tái)
驗(yàn)證碼短信接收平臺(tái)通過后,獲取該地址的通知短信。注意事項(xiàng)短信平臺(tái)向運(yùn)營(yíng)商平臺(tái)發(fā)送驗(yàn)證碼(statusUrl)后,進(jìn)行短信驗(yàn)證。如果請(qǐng)求攜帶了status,則必須攜帶status參數(shù)。該參數(shù)必須與encode參數(shù)二選一關(guān)系。Nonce、Created、Password直接進(jìn)行字符串拼接即可,無需包含+號(hào)和空格。Nonce:客戶發(fā)送請(qǐng)求時(shí)生成的一個(gè)隨機(jī)數(shù),長(zhǎng)度為1~128位,可包含數(shù)字和大小寫字母。Created:隨機(jī)數(shù)生成時(shí)間。表6xyRelationNumInfo定義參數(shù)名稱是否必選參數(shù)類型說明bindId否String(1-64)綁定Id,由 隱私保護(hù)通話 平臺(tái)自動(dòng)分配。numA否String(1-32)與指定的隱私號(hào)碼X綁定的用戶A號(hào)碼,攜帶為全局號(hào)碼格式(包含國(guó)家碼),如:+86138****0021。當(dāng)呼叫場(chǎng)景經(jīng)過轉(zhuǎn)接時(shí),此參數(shù)對(duì)應(yīng)第一路呼叫的主顯號(hào)碼。說明:A主叫場(chǎng)景,第一路呼叫為A撥打X號(hào)碼,callerNum為A號(hào)碼。A被叫場(chǎng)景,第一路呼叫為B撥打X號(hào)碼,callerNum為X號(hào)碼。fwdDisplayNum否String(1-32)轉(zhuǎn)接呼叫時(shí)的顯示號(hào),號(hào)碼為全局號(hào)碼格式(包含國(guó)家碼),比如+86138****0021。當(dāng)呼叫場(chǎng)景經(jīng)過轉(zhuǎn)接時(shí),此參數(shù)對(duì)應(yīng)第二路呼叫的主顯號(hào)碼。說明:A主叫場(chǎng)景,第二路呼叫為X撥打A號(hào)碼,fwdDisplayNum為X號(hào)碼。