登录
基础
连接微信
办公该API用于获取代开发应用或第三方应用用户授权的权限详情。
请求方式：POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/agent/get_permissions?access_token=ACCESS_TOKEN
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 代开发自建应用access_token，获取方法参见获取access_token 第三方应用access_token，获取方法参见获取企业凭证 |
权限说明：
支持所有的代开发应用和第三方应用调用
返回结果：
{
"errcode":0 ,
"errmsg":"ok",
"app_permissions":["xxx:xxx:xx"],
"app_permissions_ext": [
{
"permission_name": "xxx:xxx:xx",
"expire_time": 1770100000
}
]
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 错误码 |
| errmsg | 错误描述 |
| app_permissions | 应用的权限列表，应用权限为字符串类型，应用权限对应的字符串描述参考附录。 |
| app_permissions_ext | 应用权限的扩展信息，外部服务应用返回该字段，包含带有过期时间的权限列表 |
| app_permissions_ext.permission_name | 权限名称 |
| app_permissions_ext.expire_time | 秒级时间戳，权限过期时间 |
应用权限说明：
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 通讯录权限 | contact:base:base | 通讯录基本信息只读 | 仅第三方应用返回 |
| 通讯录权限 | contact:base:single_user | 通讯录单个信息只读 | 仅第三方应用返回 |
| 通讯录权限 | contact:edit:all | 通讯录全部信息读写 | 仅第三方应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:avatar | 头像 | - |
| 可见范围内的成员敏感信息 | contact:sensitive:qrcode | 二维码 | - |
| 可见范围内的成员敏感信息 | contact:sensitive:gender | 性别 | - |
| 可见范围内的成员敏感信息 | contact:sensitive:user_name | 姓名 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:mobile | 手机号 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:department_name | 部门名 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:email | 邮箱 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:position | 职务 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:telephone | 座机 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:address | 地址 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:extattr | 拓展属性 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:external_profile | 对外属性 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:external_position | 对外职务 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:biz_mail | 企业邮箱 | 仅代开发应用返回 |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 组织架构信息 | corp_arch:base:base | 应用可获取企业的部门组织架构信息 | |
| 组织架构信息 | corp_arch:member:direct_leader | 应用可获取企业可见范围内成员的直属上级 |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 可见范围内成员添加客户的基础信息 | externalcontact:base:base | 客户和客户群列表、昵称、备注、标签 | - |
| 客户联系 | externalcontact:contact:tag | 管理企业客户标签 | - |
| 客户联系 | externalcontact:contact:group_msg | 群发消息给客户和客户群 | - |
| 客户联系 | externalcontact:contact:welcome_msg | 给客户发送欢迎语 | - |
| 客户联系 | externalcontact:contact:qrcode | 配置「联系我」二维码 | - |
| 客户联系 | externalcontact:contact:transfer | 在职继承 | - |
| 客户联系 | externalcontact:contact:resigned | 离职继承 | - |
| 客户联系 | externalcontact:contact:stat | 获取成员联系客户的数据统计 | - |
| 客户联系 | externalcontact:contact:product_album | 管理商品图册 | - |
| 客户联系 | externalcontact:contact:intercept_rule | 管理敏感词 | - |
| 客户群 | externalcontact:groupchat:welcome_msg | 配置入群欢迎语素材 | - |
| 客户群 | externalcontact:groupchat:stat | 获取客户群的数据统计 | - |
| 客户群 | externalcontact:groupchat:resigned | 分配离职成员的客户群 | - |
| 客户群 | externalcontact:groupchat:transfer | 分配在职成员的客户群 | - |
| 客户朋友圈 | externalcontact:moment:list | 获取企业全部的发表记录 | - |
| 客户朋友圈 | externalcontact:moment:post | 发表到成员客户的朋友圈 | - |
| 获客助手 | externalcontact:customer_acquisition:base | 查询获客数、管理获客链接、获取客户列表 | - |
| 居民联系 | externalcontact:resident:manage | 管理网格和事件 | 仅针对一级行业类型为政府的企业用户,仅代开发应用返回 |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 获取基础信息 | customerservice:base:base | 获取基础信息 | - |
| 管理账号、分配会话和收发消息 | customerservice:chat:manage | 管理客服账号、管理接待人员、分配客服会话、接收客服消息和相关事件、发送消息 | - |
| 服务工具 | customerservice:tool:upgrade | 配置「升级服务」 | - |
| 服务工具 | customerservice:tool:stat | 获取客服数据统计 | - |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 对外收款 | externalpay:base:base | 应用可以获取可见范围内成员的收款记录 | - |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 日程 | calendar:base:base | 应用可以为可见范围内成员创建日程、获取相关数据 | - |
| 会议 | meeting:base:base | 应用可以为可见范围内成员发起会议、获取相关数据 | - |
| 直播 | living:base:base | 应用可以为可见范围内成员创建直播、获取相关数据 | - |
| 邮件 | email:base:base | 应用可以向可见范围内成员发送邮件、获取相关数据 | - |
| 文档 | doc:base:base | 应用可以为可见范围内成员创建文档、获取相关数据 | - |
| 微盘 | wedrive:base:base | 应用可以为可见范围内成员创建空间和上传文件，获取微盘版本和容量信息 | - |
| 审批 | approval:base:base | 应用可以为可见范围内成员创建审批申请、获取相关数据 | - |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 可获取应用可见范围内成员的打卡应用数据 | checkin:app:base | 打卡 | - |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 获取硬件设备基础数据 | hardware:base:base | 设备SN编码、设备名称、设备备注名称 | - |
| 考勤门禁设备 | hardware:checkin:checkin_data | 考勤打卡原始数据 | - |
| 考勤门禁设备 | hardware:checkin:temperature_data | 温度检测原始数据 | - |
| 考勤门禁设备 | hardware:checkin:accesscontrol_data | 门禁通行原始数据 | - |
| 考勤门禁设备 | hardware:checkin:read_rule | 读取门禁规则 | - |
| 考勤门禁设备 | hardware:checkin:edit_rule | 创建门禁规则 | - |
| 打印扫描设备 | hardware:printer:print | 发起文件打印 | - |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 家校沟通 | school:base:base | 可读取家校通讯录，获取家长基本信息 | 仅支持具有家校通讯录的学校 |
| 家校沟通 | school:edit:all | 「家校沟通」使用和编辑权限，包括编辑家校通讯录和给家长发通知 | 仅支持具有家校通讯录的学校 |
| 家校沟通 | school:sensitive:mobile | 家长手机号 | 仅支持具有家校通讯录的学校，仅代开发应用返回 |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 紧急应用通知 | emergency:base:push | 可通过语音电话提醒应用可见范围内成员查看应用推送的重要消息 | 仅医疗行业企业，仅代开发应用返回 |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 巡查上报 | patrol:report:base | 可获取可见范围内成员巡查上报数据 | 仅政务行业企业，仅代开发应用返回 |
| 居民上报 | resident:report:base | 可获取可见范围内成员居民上报数据 | 仅政务行业企业，仅代开发应用返回 |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 可分析的企业数据 | datazone:data:chat | 企业会话内容数据 | - |
| 可分析的企业数据 | datazone:data:knowledge_base | 企业知识集数据 | - |
| 可使用的展示组件 | datazone:component:chat | 可以使用会话展示组件 | - |
注意| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 查询使用量 | customer_acquisition:interface:query_quota | 可调用获客助手额度管理与使用统计接口 | - |
| 创建和编辑获客链接 | customer_acquisition:interface:link | 可调用获客链接管理接口 | - |
| 客户添加流水 | customer_acquisition:data:customer | 数据权限，可调用获取由获客链接添加的客户信息接口 | - |
| 客户发消息次数 | customer_acquisition:data:chat | 数据权限，可调用获取成员多次收消息详情接口 | - |
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 会话关键词命中结果 | datazone:data:hit_keyword | 可调用关键词规则管理和获取命中关键词规则的会话记录接口 | - |
| 会话搜索结果 | datazone:data:chat_search | 可调用会话名称搜索、会话消息搜索和员工或客户名称搜索接口 | - |
| 会话情感分析结果 | datazone:data:sentiment_analysis | 可调用情感分析模型接口 | - |
| 客户标签 | datazone:data:customer_tag | 可调用客户标签模型接口 | - |
| 会话摘要 | datazone:data:chat_summary | 可调用会话摘要模型接口 | - |
| 推荐话术 | datazone:data:recommend_dialog | 可调用话术推荐模型接口 | - |
| 自定义数据 | datazone:data:customized_data | 自定义权限，可以根据设置的权限配置调用上述接口 | - |
基础连接微信办公基础连接微信办公基础连接微信办公