企业微信自建应用怎么创建 权限开通与凭证获取
应用管理里点创建自建应用,填logo、名称、介绍和可见范围;建好后在详情页取AgentId和Secret,再配可信域名与可信IP。
更新时间:2026-11-21 | 适用:企业微信(管理后台(网页端))| 界面入口随版本调整,以当前实际显示为准
自建应用是企业自己开发的内部工具,建好后会出现在成员的工作台里。创建本身只要几分钟,真正花时间的是后面的权限开通和凭证配置:可见范围给谁、可信域名填什么、Secret 怎么保管,这几步决定了应用能不能正常用。
创建入口在应用管理
管理员登录后台,进入“应用管理”,页面上方有三个创建卡片:创建第三方应用、创建自建应用、创建代开发应用。选“创建自建应用”,进入填写页。页面上方的卡片是官方入口,下方“自建”分组里则是已经建好的应用。

应用管理页顶部的创建入口,选“创建自建应用”
填写页需要提供四样东西:应用 logo(建议正方形、清晰度够)、应用名称、应用介绍、可见范围。可见范围决定谁能用,可以按部门或成员勾选,也可以先只放自己,测试通过后再放开。

创建页要填 logo、名称、介绍和可见范围,可见范围决定谁能看到
创建完成后应用立刻出现在工作台,但此时它还只是个空壳,点进去没有内容。要让它真正可用,得回到应用详情页配置开发信息。
凭证与权限:AgentId、Secret 和可信域名
进入应用详情,能看到 AgentId(应用唯一标识)和 Secret。Secret 是调用接口的钥匙,点“查看”会推送到管理员的企业微信里,属于敏感信息,不要贴在群里或写进前端代码。

应用详情页:AgentId 直接可见,Secret 需要点击查看
同一页往下是权限与开发配置:可信域名用于网页授权和 JS-SDK,必须和实际访问域名完全一致;可信 IP 用于服务端调用接口;如果需要接收消息,还要配接收消息服务器和 Token、EncodingAESKey。这几项填错,表现往往是“页面白屏”或“接口返回 60020”。
功能开关按需打开
应用详情页底部是一排功能卡片:发送消息、接收消息、自动回复、自定义菜单、配置到聊天附件栏、配置到聊天工具栏、工作台自定义展示。用不到的先不配,配得越多,出问题时排查面越大。
配置到聊天工具栏这类能力需要单独申请权限,在“我的企业 → 应用管理”里提交用途说明,审核通过后才能生效。企业内部自用的工具一般都能过,描述里写清具体用途即可。
上线前的检查清单
- 可见范围是否包含全部目标用户,别只在测试账号上验证过。
- Secret 是否已放入服务端环境变量,没有硬编码在前端。
- 可信域名、可信 IP 是否与实际部署环境一致,换域名后要同步改。
- 应用主页地址是否可访问,未登录时能否正常跳转授权。
自建应用的难点不在创建,而在把可见范围、可信域名、Secret 这三件事一次配对。






























