获取接听状态

POST

http://127.0.0.1/cgi-bin/pstncc/getstates

企业内部开发/OA/紧急通知应用

最后修改时间：2022-08-30 03:03:35

责任人：未设置

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

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

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

callid

string

必需

发起自动语音来电callid

callee_userid

string

用户id

必需

示例

{
  "callee_userid": "james",
  "callid": "6-20190510201844181887818-4d0251082406000-out"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

istalked

integer

必需

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

calltime

integer

呼叫发起时间戳

必需

talktime

integer

通话时长单位（s）

必需

reason

integer

必需

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

示例

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

发起语音电话

空间管理新建空间