如何设置微信群机器人

按照自建应用（Appchat）方案的验证流程，下面是完整的操作步骤。整体分为四个阶段：创建应用 → 配置回调 → 创建群聊 → 主动发送消息验证。

步骤一：创建自建应用并获取核心参数

1.1 进入应用管理

登录企业微信管理后台（work.weixin.qq.com）→ 左侧菜单点击「应用管理」→ 在页面底部「自建」区域点击「创建应用」。

1.2 填写应用信息

1.3 记录三个核心参数

创建成功后进入应用详情页，记录以下三个值：

步骤二：配置接收消息（回调验证）

这一步是关键，决定应用能否接收群内@消息和事件。

2.1 准备你的服务器

你需要一个公网可访问的URL（https优先）。如果没有现成服务器，可用以下方式临时测试：

• 内网穿透：使用ngrok、natapp等工具暴露本地服务
• 云函数：使用腾讯云云函数或阿里云函数计算

2.2 填写回调配置

在应用详情页 →「开发者接口」区域 →「接收消息」→ 点击「设置API接收」：

2.3 实现验证逻辑（开发者必做）

企业微信保存配置时会发送GET请求验证URL有效性。你的服务器需要：

1. 接收四个参数：msg_signature、timestamp、nonce、echostr
2. 使用Token验证签名
3. 解密echostr得到明文
4. 在1秒内返回明文（不加引号、不带BOM头、不带换行符）

提示：企业微信官方提供了加解密库（C++/Python/PHP/Java/C#等语言），直接调用验证函数即可，无需手动实现加解密算法。

2.4 保存并验证

点击「保存」→ 企业微信会发送验证请求 → 你的服务器正确响应后显示「保存成功」。

步骤三：获取access_token并创建测试群聊

3.1 获取access_token

调用接口获取token（有效期2小时，建议缓存）：

curl"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=你的CORPID&corpsecret=你的Secret"

返回示例：

{"errcode":0,"errmsg":"ok","access_token":"xxxxxx"}

3.2 调用创建群聊接口

使用上一步获取的access_token，调用appchat/create接口创建群聊：

curl-XPOST"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字符，只允许字母数字）

成功返回：

{"errcode":0,"errmsg":"ok","chatid":"test_chat_001"}

重要限制：创建的群在旧版本企业微信中可能不显示，需要先发一条消息。

3.3 将应用添加到群聊

关键步骤：自建应用必须先「进入」群聊，才能向该群发送消息。

• 方法一：在创建群聊时，将应用的userid加入userlist
• 方法二：群主在企业微信客户端手动将应用拉入群聊

应用的userid获取方式：调用/cgi-bin/user/getuserinfo接口，或登录管理后台在「通讯录」中查看应用账号。

步骤四：主动发送消息验证

4.1 调用发送消息接口

curl-XPOST"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系统连接测试成功" } }'

成功返回：

{"errcode":0,"errmsg":"ok"}

4.2 验证结果

打开企业微信客户端 → 找到「SCRM测试群」→ 确认收到“SCRM系统连接测试成功”消息。

五、常见问题与限制

应用无法向外部群发送消息

检查以下三项：

1. 权限：应用必须在「客户联系」权限范围内
2. 进群：应用必须已被邀请进目标群（或被指定为群主）
3. 可见范围：外部群群主必须在应用的可见范围内

频率限制

• 每个群接收消息有频率限制，高频推送可能返回错误码45009
• 建议使用消息队列异步推送，控制发送速率

回调验证失败

• 检查URL是否可公网访问（用curl测试）
• 确认Token和EncodingAESKey与代码中完全一致
• 服务器必须1秒内响应，超时会失败

外部群特殊限制

• 包含敏感词的消息可能发送成功但用户不可见
• 每企业创建群数量不超过1000个/天

验证完成清单

以上全部通过，说明你的SCRM系统已成功对接企业微信外部群。