WeCom（企业微信）自建应用操作指南
跟着这份互动指南建立你的第一个企业微信自建应用，沿途填入凭证，最后一步即可复制完整设定。
尚未开始
0准备工作
- 已注册并登录企业微信管理后台：
work.weixin.qq.com/wework_admin - 当前账号在企业内拥有管理员权限（普通成员无法创建应用）
- 已确定要授权使用该应用的成员或部门
- （若需接收回调消息）已准备好一台能被外网访问的 HTTPS 服务器
1进入应用管理页并新建应用
登录管理后台后，从左侧导航栏进入：
- 点击左侧导航栏中的 App Management（应用管理）。
- 点击子菜单中的 App Management。
- 在右侧应用列表点击「创建应用」（URL：
/apps/createApiApp）。
2填写应用基本信息
在「Create an app」页面，依次填写应用 Logo、名称、简介与可见范围。
这个名称会显示在企业微信工作台，例如
test。| 字段 | 说明 | 必填 |
|---|---|---|
| App Logo | JPG / PNG，≤ 750×750，1 MB 以内。 | 建议 |
| App Name | 便于识别的名称。 | 是 |
| About this App | 应用简介。 | 否 |
| Allowed users | 可使用此应用的成员、部门或标签。 | 是 |
3选择可见范围（允许使用的成员）
- 在「Allowed users」区域，点击「Select departments/members」。
- 系统弹出选择对话框。
- 勾选需要的部门或成员，已勾选项会显示在右侧 Selected 列表。
- 点击右下角「Confirm」返回。
4完成创建并查看应用详情
- 点击底部「Create an app」蓝色按钮。
- 页面顶部出现绿色提示，表示创建成功。
- 系统跳转至应用详情页（URL：
/apps/modApiApp/{应用ID}）。
5取得 AgentId 与 Secret
- AgentId：在应用详情页直接可见（例如
1000003）。 - Secret：在「Secret」字段右侧点击「View」。
- 弹出对话框确认后，密钥会透过「WeCom Team」官方账号发送至当前管理员的企业微信。
- 在企业微信客户端的 WeCom Team 会话中查收 Secret。
7~10 位数字，例如
1000003。从 WeCom Team 私讯复制贴上，长度约 43 字元。
安全提醒：Secret 仅作为调用 API 的凭据使用，请勿上传 Git、贴在公开聊天室。如怀疑泄露，可在管理后台重置。
6配置「接收消息 API」
若应用需要接收用户消息或事件回调，需要配置接收服务。
- 点击卡片右下角「Set to receive messages via API」。
- 填写 URL、Token、EncodingAESKey；后两者可点「Get randomly」由 WeCom 端自动生成，再贴回这里。
必须以
http:// 或 https:// 开头，建议 HTTPS，需要能从公网访问。用于校验请求来源。
43 字元（A-Z, a-z, 0-9），用于加解密回调消息。
- 勾选需要接收的事件类型。
- 按「Save」。系统会自动向你的 URL 发起一次校验请求。
说明：校验失败时常见原因——服务器尚未部署校验逻辑、Token / AESKey 不一致、URL 不能从公网访问、防火墙拦截。
7取得企业 ID（Company ID / corpid）
- 从左侧导航栏点击「My Company」（我的企业）。
- 页面 URL 为
/wework_admin/frame#/profile。 - 滚动到底部，可看到「Company ID」字段。
通常以
ww 开头，例如 ww0e2cf89fdd2668e7。✓凭证汇总
以下凭证会随你上面填写的内容即时更新，可单独复制或一次复制全部：
corpid
尚未填写
agentid
尚未填写
secret
尚未填写
callback_url
尚未填写
token
尚未填写
aes_key
尚未填写
▶实战：用上述凭证呼叫 WeCom API
有了 corpid 与 secret 即可换取 access_token，再用它呼叫各种 API。以下范例会自动带入你填写的值：
下一步：拿到
access_token（有效期 7200 秒）后，可用它呼叫
企业微信 API，例如发送消息、读取通讯录、审批等。