基本概念介绍

最后更新：2023/10/27

目录

-   [术语介绍](https://developer.work.weixin.qq.com/document/path/90665/#%E6%9C%AF%E8%AF%AD%E4%BB%8B%E7%BB%8D)
-         [corpid](https://developer.work.weixin.qq.com/document/path/90665/#corpid)
-         [userid](https://developer.work.weixin.qq.com/document/path/90665/#userid)
-         [部门id](https://developer.work.weixin.qq.com/document/path/90665/#%E9%83%A8%E9%97%A8id)
-         [tagid](https://developer.work.weixin.qq.com/document/path/90665/#tagid)
-         [external\_userid](https://developer.work.weixin.qq.com/document/path/90665/#external-userid)
-         [agentid](https://developer.work.weixin.qq.com/document/path/90665/#agentid)
-         [secret](https://developer.work.weixin.qq.com/document/path/90665/#secret)
-         [access\_token](https://developer.work.weixin.qq.com/document/path/90665/#access-token)
-         [应用可见范围](https://developer.work.weixin.qq.com/document/path/90665/#%E5%BA%94%E7%94%A8%E5%8F%AF%E8%A7%81%E8%8C%83%E5%9B%B4)

## [](https://developer.work.weixin.qq.com/document/path/90665/#%E6%9C%AF%E8%AF%AD%E4%BB%8B%E7%BB%8D)术语介绍

### [](https://developer.work.weixin.qq.com/document/path/90665/#corpid)corpid

每个企业都拥有唯一的corpid，获取此信息可在管理后台“我的企业”－“企业信息”下查看“企业ID”（需要有管理员权限）  
![](https://p.qpic.cn/pic_wework/3036008643/f4f249f8640f1a58ce330176eda833b613ef0c87857592ed/0)

### [](https://developer.work.weixin.qq.com/document/path/90665/#userid)userid

每个成员都有唯一的userid，即所谓“账号”。在管理后台->“通讯录”->点进某个成员的详情页，可以看到。  
![](https://p.qpic.cn/pic_wework/804732607/f3f54eff2a4b8d15a50ceb6982b46f6008fab2878f3dc87f/0)

### [](https://developer.work.weixin.qq.com/document/path/90665/#%E9%83%A8%E9%97%A8id)部门id

每个部门都有唯一的id，在管理后台->“通讯录”->“组织架构”->点击某个部门右边的小圆点可以看到  
![](https://p.qpic.cn/pic_wework/2892453999/6167dd6da0045c296c1519958bbf13f7d80342709de54804/0)

### [](https://developer.work.weixin.qq.com/document/path/90665/#tagid)tagid

每个标签都有唯一的标签id，在管理后台->“通讯录”->“标签”，选中某个标签，在右上角会有“标签详情”按钮，点击即可看到  
![](https://p.qpic.cn/pic_wework/2449714241/91972d9d6abc555b35b80e518ea35fd111fd89973c354e9e/0)![](https://p.qpic.cn/pic_wework/55542506/d5d369d9082d39868e8c585c471aa1c5eb3f76c73fa60e60/0)

### [](https://developer.work.weixin.qq.com/document/path/90665/#external-userid)external\_userid

企业外部联系人的id，可能是微信用户，也可能是企业微信用户。需要开发者(尤其是第三方开发者)注意的是，对于同一个外部联系人，不同调用方（企业/第三方服务商）获取到的external\_userid是不同的。

### [](https://developer.work.weixin.qq.com/document/path/90665/#agentid)agentid

每个应用都有唯一的agentid。在管理后台->“应用管理”->“应用”，点进某个应用，即可看到agentid。  
![](https://p.qpic.cn/pic_wework/2843914858/e3e55fefb6de6f37ace0b168f3b326686a2d7577832ace1b/0)

### [](https://developer.work.weixin.qq.com/document/path/90665/#secret)secret

secret是企业应用里面用于保障数据安全的“钥匙”，每一个应用都有一个独立的访问密钥，为了保证数据的安全，secret务必不能泄漏。secret查看方法：  
在管理后台->“应用管理”->“应用”->“自建”，点进某个应用，即可看到。  
  

### [](https://developer.work.weixin.qq.com/document/path/90665/#access-token)access\_token

access\_token是企业后台去企业微信的后台获取信息时的重要票据，由corpid和secret产生。所有接口在通信时都需要携带此信息用于验证接口的访问权限

### [](https://developer.work.weixin.qq.com/document/path/90665/#%E5%BA%94%E7%94%A8%E5%8F%AF%E8%A7%81%E8%8C%83%E5%9B%B4)应用可见范围

每个应用都可配置可见范围，可见范围决定了哪些成员可以在企业微信终端的工作台使用该应用；可见范围同时也是应用的权限范围，决定了应用可以为哪些成员调用接口。  
可见范围可以配置成员、部门与标签。当配置的是部门，则部门下的所有子部门及成员都在可见范围。当配置的是标签，则标签下的所有部门与成员都在可见范围。  
特别地，通讯录同步助手不需要配置可见范围，其权限范围默认是全公司（即根部门）。