
# WhatsApp 群组（测试版）

在收件箱中显示已连接的 [WhatsApp Web](whatsapp-web.md) 号码的 WhatsApp 群组，并直接在应用中进行回复。您选择的每个群组都会成为一个单独的聊天窗口，每条消息都会显示成员姓名，以便您跟进对话、引用成员发言或像在手机上一样提及他人。如果需要，您的 AI 代理也可以在群组中回复，但仅限于群组成员提及您的号码或回复 AI 的消息时。

> **测试版。** WhatsApp 群组功能尚处于新阶段，仍在不断改进中。该功能适用于付费套餐；在免费套餐中，“群组”部分将显示为锁定状态。如果您的账户由代理机构管理，则由该机构决定您是否可以使用群组功能。

群组功能仅适用于 WhatsApp Web 号码。WhatsApp Business API 是点对点的，因此不支持群组功能。

---

## 开始之前

- 群组功能**默认关闭**。在您为某个号码开启群组功能并手动选择群组之前，应用中不会显示任何群组内容。
- **群组中的每个人都能看到您的回复**，如果您开启了 AI 回复，他们也能看到 AI 的回复。请像在手机上一样在群组中发言。
- **WhatsApp 对在群组中进行自动化的账户有其自身规则**，可能会限制在群组中发送自动回复的账户。请仅在人们预期会有 AI 参与的群组中开启 AI 功能。
- **不会导入历史记录。** 群组只会显示您开启该功能后收到的消息，不会显示之前的历史记录。

---

## 第 1 步：为号码开启群组功能

1. 前往 **设置 → 渠道**。
2. 找到您想要设置的 **WhatsApp Web** 号码卡片。该号码必须处于已连接状态。
3. 打开该卡片上的 **群组** 部分（带有 **测试版** 徽标）。
4. 勾选 **群组成员可以看到我的回复。WhatsApp 可能会限制在群组中发送自动回复的账户。** 在您勾选之前，开关将保持灰色不可用状态。
5. 开启 **在收件箱中显示我的 WhatsApp 群组**。

此开关按号码设置。除非您手动开启，否则您的其他 WhatsApp Web 号码将保持原样。

---

## 第 2 步：选择要显示的群组

开启开关后，卡片会列出该号码所在的所有群组，包括群组名称、成员数量，以及当您的号码是群管理员时显示的 **管理员** 徽标。如果群组仅限管理员发言，则会显示 **仅限管理员**。

1. 为您想要在应用中显示的每个群组开启 **在收件箱中显示**。
2. 如果您刚加入的群组尚未出现在列表中，请点击 **刷新群组**。

每个号码最多可显示 **25 个群组**。卡片会显示您已使用的数量（例如“已显示 25 个群组中的 3 个”）；如果您已达到 25 个上限，需要先隐藏一个群组才能显示另一个。隐藏群组将停止接收来自该群组的新消息。

---

## 在群聊中工作

您显示的每个群组都会在 **聊天** 中显示为一个单独的聊天窗口，带有 **群组** 标签、成员数量以及最新消息。

- **谁写了什么。** 每位成员的消息都会带有他们的姓名和专属颜色，第一条消息旁会显示他们的头像。姓名显示规则为：如果您已与该成员有私聊，则显示您为他们保存的备注名；否则显示他们在 WhatsApp 上使用的名称；如果都没有，则显示他们的号码。
- **您自己的消息。** 您从应用发送的消息，以及您在手机上于群组中输入的内容，都会显示在聊天窗口的您这一侧。
- **回复成员。** 使用成员消息上的 **回复** 功能即可引用该消息，操作方式与手机上相同。
- **提及成员。** 在消息框中输入 **@**，然后从列表中选择成员。他们会收到真实的 WhatsApp 提及通知。
- **照片、语音笔记、表情反应和已读回执** 的工作方式与一对一的 WhatsApp Web 聊天相同。

### 等待回复的消息

当群组中的最新消息来自成员，且你们这边无人回复时，群组行会显示等待回复的消息数量，例如 **2 条待回复**。聊天列表顶部的 **需要回复** 筛选器仅显示这些群组。

您也可以为此接收通知：**WhatsApp 群组消息待回复** 通知每个群组最多每 10 分钟发送一次。您可以在其他通知设置中开启或关闭此项。

### 群组详情

打开群组侧边栏（**群组详情**）以查看：

- **成员**：群组中的人数及完整列表。
- 成员旁边的 **打开私聊**：打开或创建您与该成员的一对一聊天。不会向对方发送任何内容。当 WhatsApp 隐藏成员号码时，此功能不可用；此时成员显示为 **号码已隐藏**，您只能在群组中联系他们。
- **对此成员静音 AI**：AI 将不会在此群组中回复该成员。他们的私聊不受影响。
- **此群组中的 AI** 和 **AI 智能体**：AI 是否在此处开启，以及由哪个智能体进行回复（见下文）。
- **总结对话**：编写一段 AI 对群组中最新对话的简短总结，并注明谁说了什么。

### 当您无法在群组中发言时

- 如果您的号码离开了群组或被移出群组，聊天界面会显示 **您的号码已不在该群组中，因此无法在此发送消息。** AI 也会在该群组中停止工作。
- 如果群组设置为仅限管理员发送消息，而您的号码不是管理员，聊天界面会提示此信息，且您的消息将无法发出。

当发生这种情况时，您可以接收通知：**已从 WhatsApp 群组中移除**。

---

## 让 AI 在群组中回复

如果您尚未看到 AI 选项，说明该功能尚未为您的账户开启。

AI 设置针对每个群组进行，有两种选择：

- **关闭**：AI 从不在该群组中发言。这是默认设置。
- **被提及后**：AI 仅回复提及您号码或回复 AI 消息的成员。它会在群组中通过姓名回复该成员，并引用其消息。它从不私下给成员发送消息。

设置步骤：

1. 在 **设置 → 渠道** 中，在号码的 **群组** 列表中，将该群组的 **AI** 设置为 **被提及后**。当群组的 **在收件箱中显示** 开启后，AI 选项才会出现。（您也可以在群组侧边栏的 **此群组中的 AI** 下进行更改。）
2. 告知平台哪个智能体负责群组回复。在 **AI Studio → AI 智能体** 中打开该智能体，转到其 **入口点** 选项卡，点击 **新建入口点** 并选择 **WhatsApp 群组**。
3. 在 **哪些群组** 下，选择 **所有开启 AI 的群组** 或 **仅这些群组** 并勾选相应群组。
4. 可选：添加 **评论关键词**：AI 将仅回复包含这些词汇之一的消息。
5. 该规则初始为关闭状态。勾选 **立即开始回复**，或在准备好后从列表中开启该规则，然后点击 **保存**。

AI 在群组中的行为方式：

- 对于未提及您的号码或未引用其消息的每条消息，它都会保持静默。此类消息在聊天中会显示一条简短的注释（**未发送给 AI 的群组消息**），且不产生任何费用。
- 它最多回复 2 条消息，且仅限文本。它不会在群组中预约或采取其他操作。
- 为保持群组秩序，它对同一成员每 2 小时最多回复一次，每天在一个群组中最多回复 20 条消息，并且在同一群组的两条消息之间至少等待 20 秒。
- 它从不回复您已静音的成员，也从不回复被标记为垃圾信息的消息（该消息仍会显示在聊天中，并被标记为垃圾信息）。
- 成员数超过 **500 人**的群组可以显示在收件箱中，但 AI 不适用于这些群组。

---

## 群组从不执行的操作

- 群组永远不会成为联系人。群组及其成员不会被添加到您的联系人、列表或智能列表中，也不会出现在您的联系人导出文件中。成员也不会被转换为联系人；只有当您点击 **打开私聊** 时，才会为该成员创建联系人。
- 您无法向群组发送广播，群组中也不会进行后续跟进。
- 在创建联系人时触发的自动化流程不会在群组中运行。
- 该应用从不创建群组、添加成员或共享邀请链接，也从不主动在群组中发送第一条消息。

---

## 群组费用

群组不收取额外费用。它们包含在号码现有的连接费中，且到达群组的消息是免费的。

群组中的 AI 回复所消耗的积分与任何其他 AI 回复相同。这也适用于使用“无限 AI”的号码：无限 AI 仅涵盖该号码的一对一聊天，不涵盖群组中的回复。

无论群组有多少成员，您在群组中发送的一条消息仅计为该号码每日发送限额中的一条消息。

---

## 故障排除

### 列表中缺少某个群组

点击该号码“群组”部分中的 **刷新群组**。该列表仅显示该号码当前所在的群组。您的号码已退出的群组会显示 **已退出**。

### 我无法开启“在收件箱中显示”

您在此号码上显示的群组已达 25 个。请隐藏一个群组以显示另一个。

### AI 不在群组中回复

请按此顺序检查：

1. 群组的 **AI** 设置为 **被提及即回复**。
2. 代理拥有涵盖此群组的 **WhatsApp 群组**入口点，且该规则已开启。
3. 成员提及了您的号码或回复了 AI 的其中一条消息。群组中的普通消息会被特意忽略。
4. 该成员未被静音，群组人数在 500 人或以下，且 AI 未达到针对该成员或群组的限制（见上文）。

如果 **AI** 选项完全缺失，说明该功能尚未为您的账户开启。

---

## 相关内容

- [WhatsApp Web](whatsapp-web.md)：连接号码、发送限制和预热。
- [入口点](../ai-agents/entry-points.md)：如何为每个渠道选择坐席。
- [错误日志](../settings/error-log.md#app-3314)：当群消息未提及 AI 时显示的提示。
