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: 其他

cpanm QQ::weixin::work

perl -MCPAN -e shell
install QQ::weixin::work