通过此接口,了解员工是否已接听语音电话。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/pstncc/getstates?access_token=ACCESS_TOKEN
请求示例:
{
"callee_userid" : "james",
"callid" : "6-20190510201844181887818-4d0251082406000-out"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证。 |
callee_userid | 是 | 用户id |
callid | 是 | 发起自动语音来电callid |
1. callee_userid不能为空
2. callid 不能为空
3. 仅支持查询七天内的callid状态
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「紧急通知 - 可调用接口的应用」中 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果 :
{
"errcode":0,
"errmsg":"ok",
"istalked":1,
"calltime":1557306531,
"talktime":2,
"reason":0
}
参数说明:
参数 | 说明 |
---|---|
istalked | 0.表示未接听,1.表示接听 |
calltime | 呼叫发起时间戳 |
talktime | 通话时长单位(s) |
reason | 呼叫结果状态:0正常结束 |
reason值含义:
1: 振铃
2: 接听
3: 通话中
4: 呼叫超时 – 用户挂机
5: 不在服务区
6: 欠费未接听
7: 被叫拒接
8: 被叫关机
9: 空号
10: 呼叫受限
11: 线路错误
12: 呼叫超时 – 系统挂机
13: 呼叫超过限制(8分钟3次24小时8次)
14: 线路超时未返回
15: 超限(主叫超限,需要换号码呼叫)
16: 线路繁忙-稍后在呼
17: 呼叫取消通知
20: 外呼超时未确认
99: 其他