一、企业微信开发概述
各位同学好，我是老张。今天咱们聊聊企业微信开发这件事。
说实话，我刚接触企业微信时，第一反应是——这不就是个加强版微信吗？后来踩了不少坑才明白，这两者完全是两码事。今天这节内容，我会结合自己这些年做OA集成的经验，带大家把企业微信的生态、开发模式、环境准备这些基础打牢。
1.1 企业微信生态介绍
企业微信，说白了就是腾讯给企业做的内部协作工具。但它跟钉钉、飞书最大的不同在于——它跟个人微信是打通的。
我举个例子你就明白了。你公司用企业微信，客户用个人微信。你们可以直接加好友、聊天、发文件。这在其他办公软件里基本做不到。为什么？因为腾讯把企业微信定位成「连接器」——连接企业内部，也连接企业外部。
企业微信的生态，我习惯分成三层来看：
- 基础能力层：通讯录、消息、日程、文档、会议。这些是标配，跟其他办公软件差不多。
- 连接能力层：跟个人微信互通、小程序、支付、企业红包。这是企业微信的杀手锏。
- 开放能力层：API接口、回调、JS-SDK、自建应用、第三方应用。这就是咱们开发者要深耕的地方。
核心观点：企业微信不是另一个微信，它是企业数字化的「连接器」。你想想看，如果只是把OA搬到手机上，那跟十年前有什么区别？真正的价值在于——让员工用企业微信就能处理审批、查看报表、跟客户沟通，所有数据在一个闭环里流转。
1.2 企业微信 vs 个人微信
这个问题我经常被问到。很多老板说：「员工都有个人微信，为什么还要用企业微信？」
嗯，这里要注意，两者定位完全不同：
| 对比维度 | 个人微信 | 企业微信 |
|---|---|---|
| 定位 | 社交工具 | 办公协作工具 |
| 好友上限 | 约5000人 | 无上限（企业认证后） |
| 管理后台 | 无 | 有，可管理员工、应用、数据 |
| API开放 | 有限（公众号/小程序） | 全面开放（通讯录、消息、审批等） |
| 数据归属 | 个人 | 企业 |
| 客户联系 | 个人关系 | 企业客户资产 |
我在项目中遇到过一家公司，销售离职时把客户微信全带走了。后来他们上了企业微信，客户关系归公司所有，销售离职也带不走。这就是本质区别——数据到底归谁。
个人经验：如果你做OA集成，一定要跟业务部门讲清楚——企业微信不是用来替代个人微信的，而是用来管理企业资产的。员工下班后可以用个人微信，但上班时间、跟客户沟通，必须用企业微信。这个边界划清楚，推行起来阻力会小很多。
1.3 开发模式选择：自建应用 vs 第三方应用
这是每个开发者都要做的选择题。我当年也纠结过，后来发现其实没那么复杂。
自建应用：你公司自己开发，部署在自己的服务器上，只给自己公司用。
第三方应用：你开发完，上架到企业微信应用市场，卖给其他公司用。
怎么选？我建议你从三个维度判断：
- 使用范围：只给自己公司用？选自建。要卖给别人？选第三方。
- 开发成本：自建应用开发简单，不需要审核。第三方应用要过应用市场审核，流程长、要求高。
- 维护难度：自建应用只服务一家，出问题好排查。第三方应用要兼容不同企业的环境，维护成本高很多。
避坑指南：我曾经帮一家公司开发OA集成，他们一开始想做第三方应用，觉得能卖钱。结果开发了半年，审核没通过，因为数据安全方案不达标。最后改成自建应用，两周就上线了。所以我的建议是——先自建跑通，再考虑商业化。别一上来就想搞大的。
另外，自建应用又分两种：
- 企业内部应用：只给本公司员工用，通过企业微信工作台访问。
- 企业互联应用：给多个企业用，比如供应商、合作伙伴。这种需要用到「企业互联」能力。
咱们这门课主要讲的是自建应用中的企业内部应用。因为这是最常用、最实用的场景。你想想看，90%的OA集成需求，不就是把审批、考勤、报销这些搬到企业微信上吗？
1.4 开发环境准备
好，理论说完了，咱们动手。开发环境准备这块，我踩过的坑比你们吃过的盐还多。直接上干货。
第一步：注册企业微信
你需要一个企业微信账号。没有的话去官网注册，免费。注意：个人微信不能直接当企业微信用，得用企业邮箱或营业执照注册。
第二步：创建应用
登录企业微信管理后台，找到「应用管理」→「自建」→「创建应用」。填个名字、上传个图标，就创建好了。创建完后，你会得到一个 AgentId 和 Secret。这两个东西要保存好，后面所有API调用都靠它们。
警告：Secret 是敏感信息，不要硬编码在代码里，更不要提交到Git仓库。我见过有人把Secret写在配置文件里，结果代码被员工传到GitHub上，整个公司的消息接口被人调用了三天才发现。血的教训。
第三步：配置可信域名
企业微信要求所有请求必须来自可信域名。什么意思？就是你得有一个公网可访问的域名，并且配置好HTTPS证书。开发阶段可以用内网穿透工具，比如 ngrok、frp。我习惯用 ngrok，一条命令就能把本地服务暴露到公网。
# 启动 ngrok，将本地 8080 端口映射到公网
ngrok http 8080
# 你会得到一个类似 https://xxxx.ngrok.io 的地址
# 把这个地址配置到企业微信后台的「可信域名」里
第四步：配置回调URL
回调URL是企业微信主动通知你的通道。比如有人提交了审批，企业微信会通过回调URL告诉你。配置方法：在应用详情页找到「接收消息」→「设置API接收」，填上你的回调地址，再填一个Token和EncodingAESKey。
Token和EncodingAESKey怎么生成？企业微信后台可以自动生成，也可以自己写代码生成。我建议直接用后台生成的，省事。
小技巧：开发阶段，回调URL可以先用 ngrok 的地址。但注意，ngrok 免费版每次重启地址会变，你得去后台重新配置。我一般用 frp 搭一个固定地址的隧道，省得来回改。
第五步：安装开发工具
你需要准备：
- IDE：VS Code 或 IntelliJ IDEA，看个人习惯。
- 语言环境：Java 8+ 或 Node.js 12+，咱们课程主要用 Java。
- 内网穿透工具：ngrok 或 frp。
- 接口调试工具：Postman 或 ApiPost。
- 企业微信客户端：手机和电脑都装上，方便测试。
嗯，到这里，开发环境就准备好了。是不是感觉挺简单的？其实最难的不是环境搭建，而是理解企业微信的「消息机制」和「回调机制」。这些内容咱们后面章节会详细讲。
最后说一句：开发企业微信应用，本质上就是跟一个「有状态」的API打交道。你发的每条消息、每个请求，企业微信都会记录。所以调试时一定要用测试企业，别在生产环境上乱搞。我当年就干过这种事——在正式环境上调试，结果给全公司发了一堆测试消息，被行政部骂了一下午。
好，这一节就到这里。下一节咱们开始写第一个企业微信应用——一个简单的「消息推送」功能。到时候你会看到，代码其实没几行，但背后的逻辑值得好好琢磨。