登录
基础
连接微信
办公
企业内部开发 服务端API 紧急通知应用 获取接听状态
获取接听状态
最后更新：2023/11/30
通过此接口，了解员工是否已接听语音电话。
请求方式：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: 其他
上一篇
发起语音电话
- 获取接听状态
本节内容
