通过此接口发起语音电话,提醒员工查看应用推送的重要消息。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/pstncc/call?access_token=ACCESS_TOKEN
请求示例:
{
"callee_userid":["james","paul"]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
callee_userid | 是 | 需要呼叫的列表 |
1. callee_userid不能为空
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「紧急通知 - 可调用接口的应用」中 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果 :
{
"errcode":0,
"errmsg":"ok",
"states":[
{
"code":0,
"callid":"6-20190510201844181887818-4d0251082406000-out",
"userid":"james"
},
{
"code":0,
"callid":"6-20190510201844181887818-4d025109f806000-out",
"userid":"paul"
}
]
}
参数说明:
参数 | 说明 |
---|---|
states | 自动语音来电呼叫状态列表 |
userid | 用户id |
callid | 唯一标识一通呼叫的id |
code | 呼叫结果状态:0成功发起呼叫,非0则失败 |
返回码:
301049 调用接口的应用未在紧急通知应用中关联
301050 紧急通知应用未开启
301051 紧急通知应用余额不足