Name
QQ::weixin::work::pstncc
DESCRIPTION
紧急通知应用
FUNCTION
call(access_token, hash);
发起语音电话 最后更新:2023/11/30
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/91627
请求说明:
通过此接口发起语音电话,提醒员工查看应用推送的重要消息。
请求包体:
{
"callee_userid":["james","paul"]
}
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
callee_userid 是 需要呼叫的列表
1. callee_userid不能为空
权限说明
应用类型 权限要求
自建应用 配置到「紧急通知 - 可调用接口的应用」中
代开发应用 暂不支持
第三方应用 暂不支持
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
RETURN 返回结果
{
"errcode":0,
"errmsg":"ok",
"states":[
{
"code":0,
"callid":"6-20190510201844181887818-4d0251082406000-out",
"userid":"james"
},
{
"code":0,
"callid":"6-20190510201844181887818-4d025109f806000-out",
"userid":"paul"
}
]
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
states 自动语音来电呼叫状态列表
userid 用户id
callid 唯一标识一通呼叫的id
code 呼叫结果状态:0成功发起呼叫,非0则失败
返回码:
301049 调用接口的应用未在紧急通知应用中关联
301050 紧急通知应用未开启
301051 紧急通知应用余额不足
getstates(access_token, hash);
获取接听状态 最后更新:2023/11/30
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/91628
请求说明:
通过此接口,了解员工是否已接听语音电话。
请求包体:
{
"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调用接口,存量企业暂不受影响 查看详情
RETURN 返回结果
{
"errcode":0,
"errmsg":"ok",
"istalked":1,
"calltime":1557306531,
"talktime":2,
"reason":0
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
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: 其他