如何设置微信群机器人

按照自建应用（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系统已成功对接企业微信外部群。