呼叫结束之后,云通讯平台将向语音验证码请求中配置的respUrl地址发送语音验证码状态通知。
1.1 语音验证码状态通知
语音验证码挂机后给应用侧的通知消息。
1.1.1 请求包头
属性 | 类型 | 约束 | 描述 | 举例 |
---|---|---|---|---|
Method | String | 必选 | HTTP方法 | POST |
URL | String | 必选 | 地址URL | /{path} |
Host | String | 必选 | 服务器地址 | |
Content-Type | String | 必选 | 类型 | text/plain |
Content-Length | String | 必选 | 消息体的长度 | |
1.1.2 请求包体
属性 | 类型 | 约束 | 描述 | 取值 |
---|---|---|---|---|
action |
String | 必选 | 表示语音验证码 |
VoiceCode |
callSid |
String | 必选 | 对应接口返回callSid参数,一路呼叫的唯一标示 |
32位字符串 |
number |
string |
必选 | 外呼号码 |
|
state |
String | 必选 | 通话状态 |
0正常通话 1被叫通话未应答 2外呼失败 |
duration |
String |
必选 | 通话时长 |
单位秒 |
userData | String | 可选 | 用户私有数据。语音验证码接口参数 | |
1.1.3 请求示例
POST /{path} HTTP/1.1 Host: <ip>:<port> Content-Type: text/plain Content-Length: <Len> <?xml version="1.0" encoding="UTF-8"?> <Request> <action>VoiceCode</action> <number>13800000000</number> <callSid>1307241452320369000100030000002f</callSid> <state>0</state> <duration>30</duration> </Request>
1.2.1 响应示例
HTTP/1.1 200 ok Date:Wed Nov 9 16:08:57 2011 Content-Length: <len> <?xml version="1.0" encoding="UTF-8"?> <Response> <statuscode>000000</statuscode> </Response>
语音验证码请求的响应中statusCode为"000000"表示请求发送成功。statusCode不是"000000",表示请求发送失败;请求成功后在配置的respUrl接收返回的语音验证码状态通知,state为0正常通话 1被叫通话未应答 2外呼失败。客户服务端可以根据自己的逻辑进行重发或者其他处理。