跳转到主要内容
退订列表 是一个集中管理不再接收选定业务消息的用户列表。它可以帮助您的团队管理退订请求,避免向已撤回同意的用户发送消息。 前往 YCloud 控制台中的 联系人 > 退订 即可查看和管理该列表。您可以在 Phone 和 BSUID 标签页之间切换,搜索现有记录、进行筛选,并在需要时移除记录。 YCloud 目前支持通过以下方式向退订列表添加用户:
  • 电话号码
  • 业务范围用户 ID (BSUID)

退订过滤的工作原理

发送消息时,您可以选择是否排除退订列表中的用户。 若要在通过 API 发送时排除已退订用户,请设置以下请求参数:
除非将 filterUnsubscribed 显式设置为 true,否则 API 请求不会过滤退订用户。当您的发送流程必须遵循 YCloud 退订列表时,请添加此参数。

向退订列表添加用户

添加用户有三种方式。

1. 手动添加用户

您可以直接在“退订”页面添加单个用户或多个用户。

按电话号码添加

  1. 前往 联系人 > 退订。
  2. 选择 Phone 标签页。
  3. 点击 添加电话号码。
  4. 选择渠道。
  5. 输入一个或多个包含国际区号的电话号码。多个号码之间用逗号或换行符分隔。
  6. 点击 添加。
位于完整退订工作区之上的电话号码退订表单。

Select the channel and enter phone numbers with international prefixes. This example is not submitted.

按 BSUID 添加

  1. 前往 联系人 > 退订。
  2. 选择 BSUID 标签页。
  3. 点击 添加 BSUID。
  4. 输入所需的 BSUID 信息。
  5. 点击 添加。
位于完整 BSUID 标签页之上的 BSUID 退订表单。

Use the BSUID tab to add customer BSUIDs or usernames to the unsubscribe list.

添加记录后,它们将显示在相应的 Phone 或 BSUID 列表中。

2. 通过 API 添加用户

使用 YCloud Unsubscriber API 以编程方式添加电话号码或支持的用户标识符。这适用于从您的网站、CRM 或其他内部系统同步同意偏好设置。 有关请求格式和支持的参数,请参阅 创建退订者。

3. 通过 AI Agent 添加用户

AI Agent 在对话中识别并确认客户的退订请求时,可以将其添加到退订列表中。 在 AI Agent 的 Actions 下配置相应的退订行为。有关配置操作的信息,请参阅 创建和配置 AI Agent。
在自动添加客户之前,请将 Agent 设计为确认客户意图。这有助于防止意外退订。

移除已退订用户

若要允许用户再次接收消息,请前往 联系人 > 退订,找到对应的 Phone 或 BSUID 记录,并在“操作”列中选择 删除 。 移除记录只会将其从 YCloud 的退订列表中删除。请确保此更改符合用户的同意以及您组织的合规性要求。

导出退订列表

前往 联系人 > 退订,设置筛选条件,然后点击 导出。如果系统提示,请完成安全验证,选择导出文件的时区,然后提交任务。 任务成功创建后,您可以继续进行其他工作。点击左下角的头像,然后选择 我的导出 即可查看任务状态并下载生成的文件。 有关任务状态、下载、文件有效期和问题排查,请参阅 我的导出。