# 企业微信群机器人配置

群机器人使用某个企业微信群自己的 Webhook 地址。绑定实例后，智能体可以向该群发送消息。

## 在群聊中创建消息推送

打开目标企业微信群的聊天信息，点击 **消息推送**。

```{figure} /assets/images/agents/guide-5-hd/wecom-group-message-push-entry.png
:alt: 企业微信群聊天信息中的消息推送入口。
:class: agent-guide-image
:figclass: agent-guide-shot

在聊天信息中打开消息推送。
```

选择添加自定义消息推送，填写名称，例如“MOI 项目通知”。复制自动生成的 **Webhook 地址**，再点击 **保存**。

```{figure} /assets/images/agents/guide-5-hd/wecom-group-create-message-push.png
:alt: 在企业微信群中添加自定义消息推送并复制 Webhook 地址。
:class: agent-guide-image
:figclass: agent-guide-shot

创建消息推送并复制 Webhook 地址。
```

## 在 MOI 创建群机器人实例

在 **资源中心 > 工具库 > 企业微信** 中点击 **新增 > 群机器人**。填写实例名称，将完整 Webhook 地址粘贴到 **Webhook Key**；也可以只粘贴 URL 中 `key=` 后的值。

```{figure} /assets/images/agents/guide-5-hd/wecom-group-robot-instance-form.png
:alt: MOI 企业微信群机器人表单，包含工具实例名称、Webhook Key 和连接超时。
:class: agent-guide-image
:figclass: agent-guide-shot

填写群机器人的 Webhook Key。
```

连接超时可留空，系统默认 30 秒。点击 **保存** 后运行连接测试；测试会向该企业微信群发送一条连接测试消息。

```{figure} /assets/images/agents/guide-5-hd/wecom-group-robot-saved.png
:alt: 已保存的 MOI 企业微信群机器人实例。
:class: agent-guide-image
:figclass: agent-guide-shot

已保存的实例会隐藏 Webhook Key。
```

## 验证与排查

将已保存的群机器人实例绑定到目标智能体，要求智能体向目标群发送一条测试消息，再在企业微信客户端确认群内收到消息。

| 现象 | 先检查 | 下一步 |
| --- | --- | --- |
| 找不到“消息推送” | 当前群是否允许成员管理消息推送 | 请群主或企业管理员确认群设置和创建权限。 |
| 连接测试失败 | Webhook 地址是否完整，或 `key` 是否复制完整 | 重新复制地址并更新 MOI 中的 Webhook Key。 |
| 保存成功但群里没有消息 | 测试的是否为刚配置的实例 | 重新运行连接测试，或让智能体发送一条文字消息。 |

- [返回企业微信配置指南](../wecom.md)