状态通知

第三方应用服务器接收语音验证码状态通知(可选)

  • 呼叫结束之后,云通讯平台将向语音验证码请求中配置的respUrl地址发送语音验证码状态通知。
1.1 语音验证码状态通知

  • 语音验证码挂机后给应用侧的通知消息。
1.1.1 请求包头
属性类型约束描述举例
MethodString必选HTTP方法POST
URLString必选地址URL/{path}
HostString必选服务器地址:
Content-TypeString必选类型text/plain
Content-LengthString必选消息体的长度
1.1.2 请求包体
属性类型约束描述取值
action
String必选表示语音验证码
VoiceCode
callSid
String必选对应接口返回callSid参数,一路呼叫的唯一标示
32位字符串
number
string
必选外呼号码

state
String必选通话状态
0正常通话 1被叫通话未应答 2外呼失败
duration
String
必选通话时长 
单位秒
userDataString可选用户私有数据。语音验证码接口参数
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外呼失败。客户服务端可以根据自己的逻辑进行重发或者其他处理。