按照自建应用（Appchat）方案的验证流程，下面是完整的操作步骤。整体分为四个阶段：创建应用 → 配置回调 → 创建群聊 → 主动发送消息验证。
否
是
开始：自建应用方案验证
步骤一：创建自建应用
获取AgentId和Secret
步骤二：配置接收消息
设置Token/EncodingAESKey
验证回调URL
回调验证通过?
步骤三：获取access_token
调用API创建测试群聊
步骤四：调用appchat/send
主动推送消息
步骤五：外部群验证
确认消息成功接收
验证完成
步骤一：创建自建应用并获取核心参数
1.1 进入应用管理
登录企业微信管理后台（work.weixin.qq.com）→ 左侧菜单点击「应用管理」→ 在页面底部「自建」区域点击「创建应用」。
1.2 填写应用信息
| 字段 | 填写说明 |
|---|---|
| 应用Logo | 上传一个图标（建议200×200px） |
| 应用名称 | 例如"SCRM测试应用" |
| 可见范围 | 必须包含你用来测试的外部群群主，建议先选整个部门或全员 |
1.3 记录三个核心参数
创建成功后进入应用详情页，记录以下三个值：
| 参数 | 位置 | 说明 |
|---|---|---|
| AgentId | 应用详情页顶部"应用信息"区域 | 直接复制 |
| Secret | 点击"Secret"右侧的「查看」按钮 | 企业微信APP会推送，务必保存 |
| CORPID | 「我的企业」→「企业信息」页面底部 | 企业唯一标识 |
步骤二：配置接收消息（回调验证）
这一步是关键，决定应用能否接收群内@消息和事件。
2.1 准备你的服务器
你需要一个公网可访问的URL（https优先）。如果没有现成服务器，可用以下方式临时测试：
- 内网穿透：使用ngrok、natapp等工具暴露本地服务
- 云函数：使用腾讯云云函数或阿里云函数计算
2.2 填写回调配置
在应用详情页 →「开发者接口」区域 →「接收消息」→ 点击「设置API接收」：
| 参数 | 操作 |
|---|---|
| URL | 填写你的公网回调地址，例如 https://your-domain.com/wecom/callback |
| Token | 点击「随机获取」生成（也可自定义，建议保存下来） |
| EncodingAESKey | 点击「随机获取」生成（43个字符，保存下来） |
2.3 实现验证逻辑（开发者必做）
企业微信保存配置时会发送GET请求验证URL有效性。你的服务器需要：
- 接收四个参数：
msg_signature、timestamp、nonce、echostr - 使用Token验证签名
- 解密
echostr得到明文 - 在1秒内返回明文（不加引号、不带BOM头、不带换行符）
提示：企业微信官方提供了加解密库（C++/Python/PHP/Java/C#等语言），直接调用验证函数即可，无需手动实现加解密算法。
2.4 保存并验证
点击「保存」→ 企业微信会发送验证请求 → 你的服务器正确响应后显示「保存成功」。
步骤三：获取access_token并创建测试群聊
3.1 获取access_token
调用接口获取token（有效期2小时，建议缓存）：
bash
curl "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=你的CORPID&corpsecret=你的Secret"返回示例：
json
{
"errcode": 0,
"errmsg": "ok",
"access_token": "xxxxxx"
}3.2 调用创建群聊接口
使用上一步获取的access_token，调用appchat/create接口创建群聊：
bash
curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/appchat/create?access_token=ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "SCRM测试群",
"userlist": ["userid1", "userid2"],
"chatid": "test_chat_001"
}'参数说明：
name：群聊名称（最多50字符）userlist：成员userid列表，至少2人，且必须包含你自己和另一个测试成员chatid：自定义群ID（可选，最长32字符，只允许字母数字）
成功返回：
json
{
"errcode": 0,
"errmsg": "ok",
"chatid": "test_chat_001"
}重要限制：创建的群在旧版本企业微信中可能不显示，需要先发一条消息。
3.3 将应用添加到群聊
关键步骤：自建应用必须先「进入」群聊，才能向该群发送消息。
- 方法一 ：在创建群聊时，将应用的
userid加入userlist - 方法二：群主在企业微信客户端手动将应用拉入群聊
应用的
userid获取方式：调用/cgi-bin/user/getuserinfo接口，或登录管理后台在「通讯录」中查看应用账号。
步骤四：主动发送消息验证
4.1 调用发送消息接口
bash
curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/appchat/send?access_token=ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"chatid": "test_chat_001",
"msgtype": "text",
"text": {
"content": "SCRM系统连接测试成功"
}
}'成功返回：
json
{
"errcode": 0,
"errmsg": "ok"
}4.2 验证结果
打开企业微信客户端 → 找到「SCRM测试群」→ 确认收到"SCRM系统连接测试成功"消息。
五、常见问题与限制
应用无法向外部群发送消息
检查以下三项：
- 权限：应用必须在「客户联系」权限范围内
- 进群：应用必须已被邀请进目标群（或被指定为群主）
- 可见范围：外部群群主必须在应用的可见范围内
频率限制
- 每个群接收消息有频率限制，高频推送可能返回错误码
45009 - 建议使用消息队列异步推送，控制发送速率
回调验证失败
- 检查URL是否可公网访问（用curl测试）
- 确认Token和EncodingAESKey与代码中完全一致
- 服务器必须1秒内响应，超时会失败
外部群特殊限制
- 包含敏感词的消息可能发送成功但用户不可见
- 每企业创建群数量不超过1000个/天
验证完成清单
| 验证项 | 通过标志 |
|---|---|
| 应用创建 | 成功获取AgentId和Secret |
| 回调配置 | 后台显示"保存成功" |
| 创建群聊 | 接口返回errcode=0和chatid |
| 应用进群 | 群成员列表中能看到应用 |
| 发送消息 | 接口返回errcode=0，群内收到消息 |
以上全部通过，说明你的SCRM系统已成功对接企业微信外部群。