> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 退订列表
> 管理已选择退订的联系人，并控制在发送消息时是否将其排除。
**退订列表** 是一个集中管理不再接收特定业务消息的用户列表。它可以帮助您的团队管理退订请求，避免向已撤回同意的用户发送消息。
前往 YCloud 控制台中的 **联系人 > 退订** 以查看和管理该列表。您可以在 **手机号** 和 **BSUID** 标签页之间切换、搜索现有记录、进行筛选，并在需要时删除记录。
YCloud 当前支持通过以下方式将用户添加到退订列表：
* **手机号**
* **企业级用户 ID（BSUID）**
## 退订过滤的工作原理
发送消息时，您可以选择是否排除退订列表中的用户。
| 发送方式 | 默认行为 |
| - | - |
| **YCloud 平台** | 默认过滤掉退订列表中的用户。如果功能提供退订过滤选项，您可以在发送过程中修改此选项。 |
| **YCloud API** | 默认 **不会** 过滤退订列表中的用户。 |
若要在通过 API 发送时排除退订用户，请设置以下请求参数：
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"filterUnsubscribed": true
}
```
除非将 `filterUnsubscribed` 显式设置为 `true`，否则 API 请求不会过滤已退订的用户。当您的发送工作流程必须遵循 YCloud 退订列表时，请添加此参数。
## 添加用户到退订列表
有三种方式可以添加用户。
### 1. 手动添加用户
您可以直接在“退订”页面中添加单个或多个用户。
#### 按手机号添加
1. 前往 **联系人 > 退订**。
2. 选择 **手机号** 标签页。
3. 点击 **添加手机号**。
4. 选择渠道。
5. 输入一个或多个包含国际区号的手机号。多个号码之间用逗号或换行分隔。
6. 点击 **添加**。
#### 按 BSUID 添加
1. 前往 **联系人 > 退订**。
2. 选择 **BSUID** 标签页。
3. 点击 **添加 BSUID**。
4. 输入所需的 BSUID 信息。
5. 点击 **添加**。
添加记录后，它们将显示在相应的手机号或 BSUID 列表中。
### 2. 通过 API 添加用户
使用 YCloud Unsubscriber API 以编程方式添加手机号或受支持的用户标识符。这适用于同步来自网站、CRM 或其他内部系统的同意偏好。
有关请求格式和支持的参数，请参阅[创建退订者](https://docs.ycloud.com/reference/unsubscriber-create)。
### 3. 通过 AI Agent 添加用户
AI Agent 在对话中识别并确认退订请求后，可以将客户添加到退订列表中。
在 AI Agent 的 **操作**下配置相应的退订行为。有关配置操作的信息，请参阅[创建和配置 AI Agent](/zh/documentation/agents/ai-agent/how-to-create-and-configure-an-ai-agent#actions)。
在自动添加客户之前，请将 Agent 设计为确认客户的意图。这有助于防止意外退订。
## 移除已退订的用户
要允许用户再次接收消息，请前往 **联系人 > 退订**，找到对应的手机号或 BSUID 记录，然后在“操作”列中选择 **删除** 。
移除记录只会将其从 YCloud 的退订列表中删除。请确保此更改符合用户的同意情况以及您组织的合规要求。
## 导出退订列表
前往 **联系人 > 退订** 并点击 **导出** 以下载该列表，以供审核或与其他系统同步。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.