获取接听状态

POST

/cgi-bin/pstncc/getstates

服务端API企业内部开发

通过此接口，了解员工是否已接听语音电话。

callee_userid不能为空
callid 不能为空
仅支持查询七天内的callid状态

reason值含义：
1: 振铃
2: 接听
3: 通话中
4: 呼叫超时 – 用户挂机
5: 不在服务区
6: 欠费未接听
7: 被叫拒接
8: 被叫关机
9: 空号
10: 呼叫受限
11: 线路错误
12: 呼叫超时 – 系统挂机
13: 呼叫超过限制（8分钟3次24小时8次）
14: 线路超时未返回
15: 超限（主叫超限，需要换号码呼叫）
16: 线路繁忙-稍后在呼
17: 呼叫取消通知
20: 外呼超时未确认
99: 其他

文档ID: 16655
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/91628

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/pstncc/getstates?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"callee_userid":"james","callid":"6-20190510201844181887818-4d0251082406000-out"}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "istalked": 1,
  "calltime": 1557306531,
  "talktime": 2,
  "reason": 0
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

callid

string

必需

发起自动语音来电callid

callee_userid

string

用户id

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

istalked

integer

必需

0.表示未接听，1.表示接听

calltime

integer

呼叫发起时间戳

必需

talktime

integer

通话时长单位（s）

必需

reason

integer

必需

呼叫结果状态：0正常结束

修改于 2022-01-14 04:25:44

发起语音电话

概述