企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端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
}

参数说明:

参数说明
istalked0.表示未接听,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: 其他
上一篇发起语音电话
下一篇开发前须知
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们