# VISTA Link 客户邮件发送产品需求文档

| 项目 | 内容 |
|---|---|
| 产品名称 | VISTA Link |
| 文档类型 | 独立产品需求文档 |
| 主要用户 | 销售人员、销售经理、项目管理员 |
| 关联系统 | VISTA Link、外部邮件发送平台 |
| 首个考虑接入的平台 | KASIKA |
| 文档范围 | 按客户标签和状态选择收件人，并通过外部发送平台发送分享页面 |

---

## 文档状态

| 项目 | 内容 |
|---|---|
| 当前版本 | V0.1 |
| 最近更新 | 2026-08-14 |
| 状态 | 待产品审核，部分外部平台能力待确认 |

---

## 1. 背景与目标

VISTA Link 已维护客户资料、客户标签和客户状态。销售除了查看和整理这些数据，还需要使用这些条件快速找到一组客户，并把适合的分享页面发给他们。

如果销售只能逐个查找客户、复制链接，再到其他工具中逐个发送，标签和状态很难真正帮助销售节省操作时间。

本需求要解决以下问题：

1. 销售可以按标签和状态找到需要联系的一组客户。
2. 销售可以一次选择多位客户和一个分享页面。
3. 系统为每位客户准备可识别客户身份的访问地址。
4. 邮件由已接入的外部发送平台实际发出，VISTA Link 不自行建设邮件投递能力。
5. 销售能够看到本次发送是否已交给外部平台，以及外部平台返回的发送结果。

---

## 2. 产品范围

本文件是 VISTA Link 主产品之外的新增发送能力，单独评审和安排开发。VISTA Link 仍不自行投递邮件；本文件所说的「发送」是销售从 VISTA Link 发起，由外部发送平台完成实际投递。实现本需求时，涉及外部邮件平台的范围以本文件为准。

### 2.1 本需求包含

- 连接一个项目可使用的外部邮件发送平台。
- 按客户姓名、标签和状态查找收件人。
- 单选或多选客户。
- 选择一个已发布且链接已启用的分享页面。
- 为每位客户准备带客户标识的访问地址。
- 将收件人和对应访问地址交给外部发送平台。
- 展示本次提交及外部平台返回的发送结果。
- 保留单个客户复制访问地址的原有方式。

### 2.2 本需求不包含

- VISTA Link 自行发送邮件。
- VISTA Link 自行处理邮件投递、退订、退信和垃圾邮件规则。
- 在 VISTA Link 中复制外部发送平台的完整客户管理功能。
- 根据邮件是否打开推断客户已浏览分享页面。
- 短信、LINE、WhatsApp 等其他发送方式；后续需要时单独补充。

---

## 3. 使用角色

| 角色 | 可以做什么 |
|---|---|
| 销售人员 | 从自己有权查看的客户中选择收件人并发起邮件发送 |
| 销售经理 | 从自己有权查看的客户中选择收件人并发起邮件发送 |
| 项目管理员 | 设置当前项目使用的外部发送平台，并查看连接状态 |

销售只能选择自己在当前项目内有权查看的客户，不能通过发送功能看到其他客户资料。

---

## 4. 主要使用过程

1. 销售打开一个已发布的分享页面。
2. 销售选择「发送邮件」。
3. 系统展示销售有权查看的当前项目客户。
4. 销售可以输入客户姓名，并按一个客户状态、一个或多个客户标签筛选。
5. 系统展示符合条件的客户数量和客户列表。
6. 销售选择一位或多位客户。
7. 系统检查客户是否有可用邮箱，并排除已删除或销售无权查看的客户。
8. 系统为每位可发送客户取得该客户与当前分享页面对应的访问地址。
9. 销售确认收件人数、页面名称和不能发送的客户数量。
10. 系统将可发送客户及其访问地址交给已接入的外部发送平台。
11. 外部发送平台负责邮件内容、实际发送及投递处理。
12. VISTA Link 展示本次提交状态；外部平台返回发送结果时，同时展示成功和失败数量。

---

## 5. 功能要求

### 5.1 外部发送平台设置

- 每个项目同时使用一个已启用的外部发送平台。
- 首个考虑接入的平台为 KASIKA。
- 项目管理员可以查看当前是否已连接发送平台。
- 未连接发送平台时，不提供批量发送操作，并提示「尚未连接邮件发送平台，请联系项目管理员」。
- 发送平台不可用时，不把本次操作显示为已发送。

### 5.2 选择分享页面

- 一次发送使用一个分享页面。
- 页面必须已经发布，且固定分享链接处于启用状态。
- 页面未发布、已删除或链接已停用时不能发送。
- 发送后页面内容仍按 VISTA Link 的页面发布规则更新；发送平台不保存另一份页面正文。

### 5.3 选择客户

- 支持按客户姓名搜索。
- 支持选择一个客户状态。
- 支持选择一个或多个客户标签。
- 多个标签同时使用时，客户必须具有全部已选标签。
- 标签和状态同时使用时，客户必须同时满足所选状态和全部已选标签。
- 筛选范围只包含当前项目内、销售有权查看且未删除的客户。
- 销售可以从筛选结果中全选，也可以取消部分客户。
- 更换筛选条件时，系统需要明确显示已选客户是否保留，不能在销售不知情时扩大收件范围。

### 5.4 发送前检查

- 发送前展示分享页面名称、可发送客户数和不能发送客户数。
- 客户没有邮箱时不能进入本次发送，并说明「缺少邮箱」。
- 客户在确认发送前被删除，或销售失去查看权限时，系统将其移出本次发送并说明原因。
- 固定分享链接在确认发送前被停用时，本次不能提交。
- 没有可发送客户时，不允许继续。
- 销售必须再次确认后，系统才能把本次发送交给外部平台。

### 5.5 客户访问地址

- 每位客户使用带有客户标识参数的访问地址。
- 参数不直接包含客户编号、邮箱、手机号等资料。
- 同一分享页面再次发送给同一客户时，继续使用现有有效访问地址。
- 访问地址用于识别客户打开页面后的浏览记录，不表示邮件已经发送或送达。
- 邮件是否打开由外部发送平台判断；客户是否实际进入分享页面由 VISTA Link 判断，两者不能混为同一项数据。

### 5.6 交给外部发送平台

- VISTA Link 将本次选中的客户和各自的访问地址交给已接入的平台。
- 外部发送平台负责邮件内容、发件身份、发送时间、实际投递、退订和退信处理。
- VISTA Link 只有在外部平台确认接收后，才显示「已提交」。
- 「已提交」不等于「发送成功」。
- 外部平台返回逐个客户的发送结果时，VISTA Link 展示成功、失败及失败原因。
- 外部平台不能返回逐个客户结果时，VISTA Link 只展示平台能够确认的状态，不补写未知结果。

### 5.7 发送记录

每次提交至少展示以下内容：

- 分享页面名称
- 发起人
- 发起时间
- 外部发送平台
- 选中客户数
- 可发送客户数
- 已提交数量
- 发送成功数量（平台返回时）
- 发送失败数量（平台返回时）
- 当前状态

发送记录不替代客户访问记录。只有客户实际打开分享页面后，访问才进入客户追踪和营销统计。

---

## 6. 状态说明

| 状态 | 含义 |
|---|---|
| 待确认 | 销售尚未确认本次发送 |
| 提交中 | 正在把本次发送交给外部平台 |
| 提交失败 | 外部平台没有接收本次提交，邮件尚未进入发送处理 |
| 已提交 | 外部平台已经接收，但尚不能确认全部邮件结果 |
| 部分失败 | 部分客户发送成功，部分客户发送失败 |
| 发送成功 | 外部平台确认本次邮件全部发送成功 |
| 发送失败 | 外部平台已经接收本次提交，但确认本次邮件没有成功发送 |

页面不得把「访问地址已生成」或「客户与页面已关联」显示为「发送成功」。
「发送成功」只表示外部平台报告邮件已经发送，不表示客户已经打开或阅读邮件。

---

## 7. 异常情况

- 外部平台未连接：不提供批量发送，保留单个客户复制访问地址。
- 外部平台暂时不可用：保留销售已经选择的页面、筛选条件和客户，允许稍后重试。
- 部分客户缺少邮箱：其他客户可以继续发送，缺少邮箱的客户单独列出。
- 部分客户资料在发送前失效：移出失效客户，其余客户可以继续发送。
- 外部平台只接收部分客户：展示已接收和未接收数量，不把整批显示为成功。
- 销售重复提交：系统在再次提交前提示本次客户和页面最近已经提交过，由销售决定是否继续。

---

## 8. 验收要求

1. 销售可以用客户标签和状态筛选收件人，并从结果中选择多位客户。
2. 系统不会把销售无权查看、已删除或没有邮箱的客户交给发送平台。
3. 每位客户收到的访问地址能够识别到对应客户，且不直接暴露客户资料。
4. VISTA Link 不直接投递邮件，实际发送由已接入的外部平台完成。
5. 页面能够区分已生成地址、已提交平台、发送成功和客户已访问。
6. 外部平台失败时，系统不会显示虚假的发送成功结果。
7. 客户实际访问后，仍按 VISTA Link 客户追踪和营销统计规则记录。

---

## 9. 接入 KASIKA 前待确认

以下内容需要取得 KASIKA 的实际产品或接口资料后确定：

1. VISTA Link 如何把选中的客户交给 KASIKA。
2. KASIKA 是否支持为同一批邮件中的每位客户带入不同的访问地址。
3. 客户在两个系统之间使用什么稳定信息进行对应。
4. 邮件正文和模板是在 KASIKA 中选择，还是可以从 VISTA Link 发起。
5. KASIKA 能够返回哪些状态，是否包含逐个客户的成功和失败结果。
6. KASIKA 对单次收件人数、发送频率和必填资料有什么限制。
7. 退订客户和禁止发送名单由哪一方判断，VISTA Link 在选择客户时能否提前排除。
8. 项目管理员如何完成 KASIKA 的连接、停用和重新连接。

上述事项确认前，本文件可以用于评审销售过程和产品范围，不能直接用于确定与 KASIKA 的具体连接方式。