# 11-KASIKA×HOMEVISTA 联动使用指导书（中文版）
版本：V0.25
适用对象：房地产公司的项目运营人员、销售运营负责人、项目管理员
文档状态：中文定稿
## 修订记录
| 日期 | 版本/序号 | 变更类型 | 变更摘要 | 修改人/来源 |
| --- | --- | --- | --- | --- |
| 2026-07-14 | V0.1 | 新建 | 建立面向运营人员的 KASIKA × HOMEVISTA 联动使用指导书 | AI |
| 2026-07-16 | V0.2 | 重大需求变更 | 重构为“先完成设置、再按运营方案使用”的手册；扩写运营联动方案，并明确 KASIKA 操作仅说明设置位置 | AI，用户确认 |
| 2026-07-16 | V0.3 | 说明补充 | 根据 DeepSeek 第 1 轮评审，补充全量同步入口及顾客状态为空或未映射时的准确权限影响说明 | AI，DeepSeek 评审 01 |
| 2026-07-16 | V0.4 | 说明优化 | 根据 DeepSeek 第 2 轮评审，补充手动同步与定时同步的一致性说明，并前置模板修改影响提醒 | AI，DeepSeek 评审 02 |
| 2026-07-16 | V0.5 | 说明补充 | 根据 DeepSeek 评审补齐日志路径、固定链接取得方式、状态降权风险、异常提报闭环和操作角色说明 | AI，DeepSeek 评审 01、02 |
| 2026-07-16 | V0.6 | 说明补充 | 根据 DeepSeek 第 4 轮评审，在状态分层方案中补充状态升级导致原内容缩减的风险提示 | AI，DeepSeek 评审 04 |
| 2026-07-16 | V0.7 | 说明补充 | 根据 DeepSeek 第 5 轮评审，补充已绑定顾客的同步边界、无权限运营人员的提报方式及状态回退风险检查 | AI，DeepSeek 评审 05 |
| 2026-07-16 | V0.8 | 说明补充 | 根据 DeepSeek 第 6 轮评审，补充手动全量同步可能批量触发首次邀请的操作风险 | AI，DeepSeek 评审 06 |
| 2026-07-16 | V0.9 | 说明优化 | 重写联动目的与双方分工，补充面向运营人员的全局说明 | AI，用户反馈 |
| 2026-07-16 | V0.10 | 重大需求变更 | 纳入演示访问与顾客浏览履历上报方案，明确该能力与账号、权限联动的边界 | AI，用户反馈 |
| 2026-07-16 | V0.11 | 结构优化 | 将演示访问与浏览履历能力调整至全局说明，避免在运营方案章节展开联动细节 | AI，用户反馈 |
| 2026-07-16 | V0.12 | 说明优化 | 取消面向客户的开发阶段分层，改为从客户经营价值说明双方系统合作闭环 | AI，用户反馈 |
| 2026-07-16 | V0.13 | 说明优化 | 合并重复的系统分工与经营价值说明，突出两系统协作带来的客户经营价值 | AI，用户反馈 |
| 2026-07-16 | V0.14 | 术语优化 | 将“上线前规则”更正为配置开始前的运营规则确认 | AI，用户反馈 |
| 2026-07-16 | V0.15 | 说明优化 | 将联动价值的受益对象明确为销售团队，并补充提升销售推进与成交机会的目标 | AI，用户反馈 |
| 2026-07-16 | V0.16 | 说明优化 | 收敛配置前确认项，明确全量同步、同步兜底及两类邮件发送的固定边界 | AI，用户反馈 |
| 2026-07-17 | V0.17 | 结构优化 | 第 1 章改为业务价值与顾客旅程说明，移除面向客户的配置清单和边界条款 | AI，用户反馈 |
| 2026-07-17 | V0.18 | 术语优化 | 将第 1 章标题改为“了解 KASIKA × HOMEVISTA 联动”，与正文内容一致 | AI，用户反馈 |
| 2026-08-04 | V0.19 | 重大需求变更 | 明确首次绑定只向 KASIKA 的 `VISTAURL` 和适用时的 `VISTAPWD` 两个承接字段回写；其他 VISTA 信息不回写 KASIKA | AI，用户确认 |
| 2026-08-04 | V0.20 | 重大需求变更 | 重写 KASIKA 配置章节，补齐顾客导出／导入设置、两项承接字段和两类邮件的配置边界 | AI，用户确认 |
| 2026-08-04 | V0.21 | 重大需求变更 | 根据 DeepSeek 第 10 次评审及正式需求稿复核，补充权限模板操作、删除后再次同步、角色边界和浏览履历跟进方案，并收束非联动方案 | AI，DeepSeek 评审 10 |
| 2026-08-06 | V0.22 | 说明补充与优化 | 根据 DeepSeek 第 12 次评审及正式需求稿复核，补充顾客资料同步方向、单个顾客联动信息查看和全量同步不可取消等说明，并精简授权配置、绑定判断及问题交接表述 | AI，DeepSeek 评审 12、用户确认 |
| 2026-08-06 | V0.23 | 说明补充与结构优化 | 根据正式需求稿与 KASIKA API 文档复核，增加开始前须知（VISTA 功能开通与总开关说明、操作角色分工、配置依赖时序）；补充 KASIKA 端 4 项密钥、导出/导入设置、自定义字段及自動返信模板的详细获取路径与操作步骤；明确标签管理页与权限模板页的区别；完善日常检查与 FAQ；新增术语表附录 | AI，需求文档复核 |
| 2026-08-07 | V0.23 | 配图补充 | 复用 KASIKA 官方帮助资料中的 API 通用设置、用户密钥、导出／导入 settingID、自定义字段和自動返信页面截图；图片统一引用 KASIKA 官方线上地址，不保存本地副本 | AI，KASIKA 官方帮助资料复核、用户确认 |
| 2026-08-12 | V0.24 | 说明优化 | 明确本手册与《12-二期测试用例与执行指导手册》的阅读顺序和分工：本手册负责业务理解与运营边界，12 负责完整测试操作、判定和异常交接。 | 面向 RENO 等非专业测试人员。 |
| 2026-08-16 | V0.25 | 说明优化 | 调整 11、12、13 的阅读分工：11 负责业务理解，12 负责测试范围与追溯，13 负责 RENO 的逐步操作；澄清初次访问邀请链接由 KASIKA 在实际发信时自动附加顾客编号，并明确本期仅使用 VISTAURL、VISTAPWD 两个 KASIKA 承接字段。 | 面向非专业测试人员的执行准备。 |
## 测试人员阅读与执行导航
本手册不是完整测试用例。它帮助没有阅读过产品需求的运营人员理解“为什么会同步、为什么会发两类邮件、为什么顾客能看到不同内容”。实际测试前先阅读《12-二期测试用例清单（框架）》，再按《13-RENO 测试执行手册（中文版）》逐步操作、记录结果和交接异常。
| 顺序 | RENO 需要做什么 | 阅读/执行资料 | 完成标准 |
| --- | --- | --- | --- |
| 1 | 先理解联动的业务逻辑、双方分工、两类邮件、顾客状态与内容权限的关系。 | 本手册第 1、4、5、8、9 章。 | 能区分“初次访问邀请邮件”与“绑定完成通知邮件”；知道 KASIKA 是顾客事实来源，VISTA 负责内容权限。 |
| 2 | 了解测试覆盖范围、自动处理规则和哪些异常由南京侧受控验证。 | 12 的第 1～6 章。 | 知道哪些内容由 RENO 正常操作，哪些内容不能自行改配置或制造。 |
| 3 | 按编号执行每一张操作卡。 | 13 的 T13-01～T13-29。 | 每条均有“符合预期”“不符合预期”或“无法执行或无法判定”的记录和证据。 |
| 4 | 测试结束后，用最小检查和日常检查确认上线后的运营动作。 | 本手册第 6 章。 | 不把最小检查代替完整测试；完整测试结论仍以 13 的执行记录为准。 |
### 与 12、13 测试资料的对应关系
| 本手册中需要先理解的内容 | 12 中对应的测试模块 | 13 中执行位置 |
| --- | --- | --- |
| 配置依赖、角色分工和 KASIKA/VISTA 准备 | T00、T01 | T13-01、T13-04 |
| 标签、权限模板、顾客状态与内容的关系 | T02、T05、T06、T08 | T13-02、T13-03、T13-08、T13-19～T13-24 |
| 顾客主动进入、邮箱确认、首次绑定后的系统处理 | T03、T07 | T13-05～T13-10 |
| 未主动进入顾客的手动/定时同步兜底 | T04、T11 | T13-12～T13-16、T13-27～T13-29 |
| 顾客删除、绑定冲突、日志和支持交接 | T09、T10、T11 | T13-25、T13-26；受控异常见 13 第 8 章 |
| 上线前最小检查和日常检查 | T12 | 全部操作卡完成后的记录提交 |
## 目录
1. 了解 KASIKA × HOMEVISTA 联动
2. 在 KASIKA 完成联动准备
3. 在 HOMEVISTA 开通联动
4. 设置顾客主动绑定入口
5. 设置标签、内容权限和顾客状态联动
6. 上线前最小确认与日常检查
7. 运营联动方案设计与使用方法
8. 常见问题与支持交接
9. 附录：术语表
---
## 1. 了解 KASIKA × HOMEVISTA 联动
本手册帮助运营人员完成两件事：把 KASIKA 顾客引导到 HOMEVISTA（下文简称“VISTA”）；按顾客阶段让他们看到合适的内容。它不讲程序开发，也不替代 KASIKA 官方帮助文档。
### 1.1 为什么要联动：让顾客经营与内容服务形成闭环
房地产项目的顾客经营通常从 KASIKA 开始：顾客咨询、预约、商谈后，运营人员知道“这个顾客是谁、正处于什么阶段”。但仅有顾客资料和邮件，无法保证顾客进入后能看到真正适合其阶段的项目内容；反过来，VISTA 虽能承载户型、价格、活动和专属资料，也需要知道应向谁开放、开放到什么程度。
两者联动的目的，是把这两段工作连成同一条顾客旅程：**在 KASIKA 识别顾客和经营阶段，在 VISTA 提供与阶段相符的内容和访问体验；顾客浏览 VISTA 后，KASIKA 又能积累其浏览履历，供后续经营使用。** 最终不是为了增加系统操作，而是让销售团队更早识别顾客兴趣、更有针对性地跟进，并提升销售推进效率与成交机会。
从客户经营角度看，KASIKA 负责顾客资料、触达与后续经营，VISTA 负责内容体验与内容权限；两者并不是互相复制所有资料，而是共同形成以下闭环：
| 客户经营环节 | KASIKA 做什么 | HOMEVISTA 做什么 | 给销售团队带来的价值 |
| --- | --- | --- | --- |
| 触达合适的顾客 | 根据顾客资料、经营阶段发送邮件或其他触达 | 提供项目入口与需要展示的内容 | 销售不再只“发一封介绍邮件”，而是将顾客引导进入可持续了解项目的空间。 |
| 提供合适的内容 | 提供顾客身份和当前阶段 | 核对顾客、建立访问关系，并按标签和权限模板展示内容 | 销售可在合适的时点提供合适深度的资料，减少过早公开，也减少逐人手动授权。 |
| 了解顾客兴趣 | 保存顾客的浏览履历，供名单筛选、场景邮件或人工跟进使用 | 记录并上报顾客在项目中的浏览行为 | 销售能知道顾客关注过什么内容，判断跟进优先级和沟通切入点，而不是只知道邮件是否发出。 |
| 持续跟进 | 根据顾客状态和浏览信号继续经营 | 在顾客再次访问时持续提供当前应看的内容 | 让销售下一次触达更有针对性，形成“触达—浏览—理解兴趣—继续跟进”的循环，提高推进成交的机会。 |
需要区分的是：浏览履历用于 KASIKA 的后续经营判断，不会直接修改 VISTA 的账号、标签或内容权限；VISTA 的内容权限仍按顾客身份、顾客状态和权限规则执行。
### 1.2 顾客旅程：从首次触达到持续跟进
联动后，顾客通常会经历以下过程：
1. **收到触达**：KASIKA 根据顾客资料和经营阶段发送项目相关邮件。
2. **进入内容**：顾客从邮件进入 VISTA，完成必要的身份确认后查看项目内容；未及时进入的顾客，会由系统后续同步处理并再次获得访问方式。
3. **留下兴趣信号**：顾客浏览的内容会记录到 KASIKA 顾客履历，销售可据此了解其关注方向。
4. **获得后续服务**：顾客状态变化后，VISTA 按项目设置更新可查看内容；销售再结合顾客状态和浏览兴趣继续跟进。
> 【配图】顾客从 KASIKA 邮件触达、进入 VISTA、留下浏览信号到销售继续跟进的旅程图。
### 1.3 开始前须知
#### 1.3.1 确认 VISTA 项目已开通 KASIKA 功能
VISTA 项目默认不开启 KASIKA 联动功能。在开始配置之前，请先确认：
- 进入 HOMEVISTA 后台的"项目设置 → KASIKA 联动配置管理"页面。
- 如果页面正常显示配置表单，说明 KASIKA 功能已开通。
- **如果页面所有字段都显示为空白**（没有任何输入框、显示值或复制按钮），说明当前项目的 KASIKA 联动总开关尚未开启。此时需要**联系销售人员**申请开通，开通后刷新页面即可正常显示。
> 注意：总开关未开启时，即使管理员填写并点击保存，也会被系统拦截并提示联系销售人员。不需要反复尝试。
#### 1.3.2 操作角色与分工
联动配置需要两方管理员协作完成。以下为各角色在配置阶段的职责：
| 角色 | 系统 | 负责的操作 | 不可做的操作 |
| --- | --- | --- | --- |
| KASIKA 管理员 | KASIKA | 申请 API 选项服务；登记 VISTA 服务器 IP；取得 4 项密钥；创建顾客导出/导入设置；创建自定义字段；创建自動返信邮件模板；确认 PID 和顾客状态命名 | — |
| VISTA（B端）管理员 | HOMEVISTA | 进入 KASIKA 联动配置页；填写 PID 和密钥；填写 settingID 和自動返信ID；设置两个运营开关；复制 VISTA 服务器 IP、入口 URL 和字段名交给 KASIKA 管理员 | 不代替 KASIKA 管理员创建 KASIKA 侧的设置 |
| 销售人员 | HOMEVISTA | 联系销售人员开通 KASIKA 功能（如尚未开通） | 不可进入 KASIKA 联动配置页保存设置；不可查看同步日志 |
| 运营人员 | 双方 | 确认顾客状态命名和内容范围；配合测试；日常检查邮件和绑定结果 | 不可修改 KASIKA 或 VISTA 的联动配置 |
#### 1.3.3 配置依赖时序
两方配置存在先后依赖关系，请按下图顺序执行，不要跳过或调换：
```mermaid
flowchart TD
A["1. VISTA 管理员
确认 KASIKA 功能已开通
（如未开通，联系销售人员）"] --> B["2. VISTA 管理员
进入配置页，复制
VISTA 服务器 IP 地址
交给 KASIKA 管理员"]
B --> C["3. KASIKA 管理员
登记 VISTA 服务器 IP
取得 4 项密钥
交给 VISTA 管理员"]
C --> D["4. VISTA 管理员
在配置页填写 PID 和
4 项密钥，复制
VISTAURL / VISTAPWD
字段名和入口 URL
交给 KASIKA 管理员"]
D --> E["5. KASIKA 管理员
创建 VISTAURL / VISTAPWD
两个自定义字段
创建顾客导出/导入设置
取得 settingID
交给 VISTA 管理员"]
E --> F["6. KASIKA 管理员
创建绑定完成通知模板
取得自動返信ID
（如需主动邀请方案，
同时创建首次入口邀请邮件）
交给 VISTA 管理员"]
F --> G["7. VISTA 管理员
填写两个 settingID
和自動返信ID
选择运营开关
保存配置"]
G --> H["8. VISTA 管理员
创建标签和权限模板
（第 5 章）"]
H --> I["9. 双方管理员
共同执行
上线前测试（第 6 章）"]
```
> 关键依赖说明：步骤 5 中，KASIKA 管理员必须先拿到 VISTA 管理员提供的字段名（`VISTAURL` / `VISTAPWD`），才能创建完全一致的自定义字段；步骤 6 中，绑定完成通知模板必须包含 `VISTAURL` 和 `VISTAPWD` 变量，因此需要在自定义字段创建完成后进行。
---
## 2. 在 KASIKA 完成联动准备
本章说明 KASIKA 侧需要完成的设置及其位置。KASIKA 页面内的具体点击方法，请配合 KASIKA 官方帮助文档操作。
> 本章截图取自 KASIKA 官方帮助资料。因使用环境和版本不同，界面语言或样式可能略有差异，请以页面中的菜单名和字段名为准。
### 2.1 开始前准备
请先确认以下条件：
- 项目已申请并开通 KASIKA API 选项服务（付费选项）；如设置菜单中没有 API 设置相关项目，请联系 KASIKA 服务窗口或客户成功团队申请开通。
- 由具备管理员权限的 KASIKA 账号操作。本章所有设置均需要管理员权限，普通用户无法查看或修改。
- 已从 HOMEVISTA 管理员处取得 **VISTA 服务器 IP 地址**、**VISTA 项目入口 URL**，以及字段名 `VISTAURL`、`VISTAPWD`（详见第 3 章）。
### 2.2 设置 API 访问权限
本节需要完成两件事：登记 VISTA 服务器 IP，并取得 4 项密钥。
#### 2.2.1 登记允许访问的 IP 地址
进入 KASIKA 管理后台，打开"**基本信息设置 → API 设置 → API 通用设置**"，在"允许访问的 IP 地址"区域登记 HOMEVISTA 配置页中显示的全部 VISTA 服务器 IP。
- 如果 VISTA 配置页显示了多个 IP，需要全部登记，不要遗漏。
- 未登记的 IP 发起的 API 请求会被 KASIKA 拒绝。
- 这是所有 KASIKA API 通用的设置，登记一次即可。
*图 2-1：API 通用设置页面。右侧为允许访问 IP，左侧为公司密钥。图片中的密钥已遮挡。*
#### 2.2.2 取得 4 项密钥
4 项密钥分为两组，从两个不同的菜单位置取得：
| 密钥名称 | 取得位置 | 格式 | 操作要点 |
| --- | --- | --- | --- |
| 公司访问密钥 | 基本信息设置 → API 设置 → API 通用设置 | 32 位半角英数字 | 页面直接显示，可直接复制 |
| 公司 Secret Key | 基本信息设置 → API 设置 → API 通用设置 | 32 位半角英数字 | 点击眼睛图标，输入当前登录用户密码后显示，复制后立即保存 |
| 用户访问密钥 | 页面顶部"账号设置"→ API 设置 | 32 位半角英数字 | 如尚未创建，点击"访问密钥创建"按钮生成 |
| 用户 Secret Key | 页面顶部"账号设置"→ API 设置 | 32 位半角英数字 | 点击眼睛图标，输入当前登录用户密码后显示，复制后立即保存 |
操作步骤：
1. 进入"**基本信息设置 → API 设置 → API 通用设置**"，复制**公司访问密钥**（页面直接显示）。
2. 在同一页面点击眼睛图标 ，输入当前登录用户密码，复制**公司 Secret Key**。
3. 点击 KASIKA 页面顶部用户名，进入"**账号设置 → API 设置**"。
4. 如果尚未创建用户密钥，点击"**访问密钥创建**"按钮生成。
5. 复制**用户访问密钥**（页面直接显示）。
6. 点击眼睛图标，输入密码后复制**用户 Secret Key**。
*图 2-2：账号设置页面中的用户访问密钥和用户 Secret Key。图片中的密钥已遮挡。公司密钥位置见图 2-1。*
取得后，将 4 项密钥通过项目约定的安全方式交给 HOMEVISTA 管理员。**不要在邮件正文或群聊中直接发送密钥明文。**
### 2.3 创建顾客导出设置
进入"**基本信息设置 → API 设置 → 顾客导出 API**"，点击"新增"按钮，为 HOMEVISTA 联动新建一项专用设置。
本项目内 KASIKA 可以取得的顾客都需要参与同步，因此：
- **不要添加**会缩小顾客范围的筛选条件（状态、标签、负责人、注册日期等）。
- **不要设置**排除条件（如排除特定标签、退订状态等）。
导出内容至少应包含以下字段：
- KASIKA 顾客编号（`customer_id`）
- 姓名（`customer_name`）
- 邮箱（`customer_email`）
- 电话（`customer_tel`）
- 顾客状态（`customer_status`）
其中，顾客编号用于识别顾客，姓名、邮箱和电话用于建立或更新顾客资料，顾客状态用于匹配 VISTA 标签和内容权限。
保存后，记录该设置的 `settingID`（设置 ID），交给 HOMEVISTA 管理员。
*图 2-3：顾客导出 API 设置列表中的 settingID。图片中的 ID 已遮挡。*
> 【仍需截图】顾客导出 API 新建／编辑页面中的对象范围选择和导出项目勾选区域。现有官方帮助资料只提供了 settingID 列表截图，不能代替字段配置画面。
### 2.4 创建承接字段和顾客导入设置
#### 2.4.1 创建自定义字段
先在 KASIKA 中创建两个文本类型的自定义字段，用于接收 HOMEVISTA 回写的访问信息。
进入"**客户管理 → 设置 → 客户属性设置**"，新增两个自定义字段，字段名必须与 HOMEVISTA 配置页显示的名称**完全一致**（区分大小写）：
| 字段名 | 字段类型 | 接收内容 | 使用规则 |
| --- | --- | --- | --- |
| `VISTAURL` | 文本（字符串型） | 顾客的 VISTA 访问链接 | 首次绑定成功后写入，格式为 `https://{domain}.homevista.jp/...` |
| `VISTAPWD` | 文本（字符串型） | 顾客的 VISTA 首次访问密码 | 仅项目启用访问密码时写入和使用 |
本期 KASIKA 联动只需要以上两个承接字段。`VISTABINDSTATE` 不是本期要求创建或回写的字段；不要因为想在 KASIKA 中显示绑定状态而自行新增并映射它，以免把未定义的字段当成联动结果。
> 注意：字段名必须与 VISTA 配置页中只读显示的 `VISTAURL`、`VISTAPWD` 完全一致。请先等待 VISTA 管理员从配置页复制这两个字段名，再创建。如果名称不一致，VISTA 将无法向 KASIKA 回写访问信息。
*图 2-4：客户属性设置页面。依次填写字段名、选择字符串类型，再点击“添加”。*
#### 2.4.2 创建顾客导入设置
进入"**基本信息设置 → API 设置 → 顾客导入 API**"，点击"新增"按钮，为 HOMEVISTA 联动新建一项专用设置：
1. **设置顾客识别字段**：选择"KASIKA 顾客编号"作为识别顾客的键。
2. **设置写入目标**：在自定义字段映射中，将写入目标设置为 `VISTAURL` 和 `VISTAPWD`。
3. 保存后记录导入 `settingID`，交给 HOMEVISTA 管理员。
写入目标**只能**选择 `VISTAURL` 和 `VISTAPWD`，不要映射其他顾客字段。HOMEVISTA 只会向这两个承接字段写入信息；VISTA 顾客编号、绑定状态和首次访问完成时间不会写入 KASIKA。
*图 2-5：顾客导入 API 设置列表中的 settingID。图片中的 ID 已遮挡。*
> 【仍需截图】顾客导入 API 新建／编辑页面中的顾客识别字段和 `VISTAURL`、`VISTAPWD` 写入目标映射区域。现有官方帮助资料只提供了 settingID 列表截图，不能代替字段映射画面。
### 2.5 区分并设置两类邮件
两类邮件的发送时点和用途不同，不能共用同一模板。绑定完成通知是联动的必要设置；首次入口邀请邮件仅在项目采用“邀请顾客主动绑定”方案时设置。
#### 2.5.1 首次入口邀请邮件
这封邮件由 KASIKA 的运营规则发送，用于邀请顾客首次进入 VISTA。发送对象、发送时间和触发条件均在 KASIKA 中确定，与 VISTA 的绑定完成通知无关。
模板中的链接只应使用 HOMEVISTA 提供的**项目入口基础 URL**。KASIKA 在实际向某位顾客发送这封邮件时，会自动在链接上附加该顾客的 `kasikacid`；运营人员和测试人员都不需要、也不应手工填写这个编号。
```text
模板中填写：https://{项目域名}/kasika-entry
顾客实际收到：https://{项目域名}/kasika-entry?kasikacid={KASIKA 自动附加的当前顾客编号}
```
不要把测试顾客编号固定写入模板，也不要要求测试人员编辑链接参数。正式使用前，请向测试顾客发送一封实际邮件，点击其中的链接，确认能打开正确项目的入口页，并显示该顾客的信息。
#### 2.5.2 绑定完成通知邮件（自動返信模板）
这封邮件用于告知顾客已经可以访问 VISTA。请在 KASIKA 中**另外建立一份自動返信邮件模板**，不要把咨询、预约或登记等 KASIKA 业务规则绑定到该模板。
**创建步骤：**
1. 进入 KASIKA 管理后台的自动回复邮件设置页面（具体路径请以 KASIKA 官方帮助为准），新建一个自動返信模板。
2. 模板用途选择或标注为"HOMEVISTA 绑定完成通知"，以便与业务类自动回复邮件区分。
3. 在模板正文中插入以下变量：
- `VISTAURL`：顾客后续访问 VISTA 的链接。这是 KASIKA 自定义字段变量，需确认 KASIKA 邮件模板支持插入自定义字段变量。
- `VISTAPWD`：仅项目启用访问密码时插入；未启用时不要出现密码说明或空字段。
4. 模板中不要包含与绑定通知无关的业务规则（如咨询回复、预约确认等），也不要绑定到其他业务触发条件。
5. 保存模板后，记录该模板的 `自動返信ID`，交给 HOMEVISTA 管理员。
顾客首次绑定完成、且访问方式准备好后，由 HOMEVISTA 使用该 `自動返信ID` 触发发送。模板应包含：
- `VISTAURL`：顾客后续访问 VISTA 的链接。
- `VISTAPWD`：仅项目启用访问密码时显示；未启用时不要出现密码说明或空字段。
保存模板后，记录该模板的 `自動返信ID`（自动回复邮件 ID），交给 HOMEVISTA 管理员。已经绑定的顾客再次访问时，不会重复发送这封邮件。
*图 2-6：自動返信列表。可从右上角新建模板，并在列表中确认自動返信ID。*
*图 2-7：自動返信编辑页面。请设置便于识别的名称，并确认邮件状态为发送。*
> 【仍需截图】首次入口邀请邮件模板中插入 VISTA 项目入口基础 URL 的位置。现有帮助资料只有通用邮件编辑画面，无法证明该项目的实际配置方法；`kasikacid` 不由模板人工填写，而由 KASIKA 在实际发信时自动附加。
> 【配图】“首次入口邀请邮件”和“绑定完成通知邮件”的用途、触发方、链接内容对比。
### 2.6 准备 PID 和顾客状态
- 确认并提供 KASIKA 为本项目提供的 32 位 PID，用于将顾客在 VISTA 的浏览履历记录到 KASIKA；如无法确认，请联系 KASIKA 服务窗口。
- 直接使用 KASIKA 现有的顾客状态，不需要另建联动专用状态字段。
- 正式使用前统一状态名称；需要自动控制 VISTA 内容权限的状态，必须与 VISTA 标签名称完全一致。
### 2.7 KASIKA 侧完成检查
- [ ] KASIKA API 选项服务已开通。
- [ ] HOMEVISTA 的全部服务器 IP 已登记。
- [ ] 四项授权信息已取得，联动账号保持有效。
- [ ] 顾客导出设置覆盖项目内全部可取得顾客，必要资料齐全，导出 `settingID` 已提供。
- [ ] `VISTAURL`、`VISTAPWD` 两个字段名称和类型正确。
- [ ] 顾客导入设置只承接上述两个字段，导入 `settingID` 已提供。
- [ ] 绑定完成通知模板已创建，`自動返信ID` 已提供；如采用主动邀请方案，首次入口邀请邮件已另行设置。
- [ ] PID 和顾客状态命名已确认。
---
## 3. 在 HOMEVISTA 开通联动
仅项目管理员可进入“**项目设置 → KASIKA 联动配置管理**”。销售人员和销售经理不应代替管理员保存这组设置。
### 3.1 按顺序完成设置
1. 确认项目已经开通 KASIKA 功能：进入"项目设置 → KASIKA 联动配置管理"，如果页面正常显示表单（有输入框、复制按钮等），说明已开通。**如果页面所有字段都显示为空白**（没有任何输入框或显示值），说明当前项目的 KASIKA 联动总开关尚未开启，需联系销售人员开通后刷新页面。
2. 在页面复制“VISTA 服务器 IP 地址”，交给 KASIKA 管理员登记到允许列表。
3. 填入 KASIKA 管理员提供的 PID，并将 4 项联动授权信息分别填入四个独立输入框；再填写两个 settingID 和 `自動返信ID`。
4. 从本页复制 `VISTAURL` 和 `VISTAPWD` 字段名，交给 KASIKA 管理员创建对应自定义字段。
5. 如采用主动邀请方案，复制“VISTA 项目入口 URL”，交给 KASIKA 管理员放入首次入口邀请邮件模板。
6. 选择两个运营开关后保存。
### 3.2 HOMEVISTA 配置项对照
| HOMEVISTA 配置项 | 填写内容 | 运营人员需要确认什么 |
| --- | --- | --- |
| PID | KASIKA 管理员提供的 PID | 已取得正确项目的 PID。 |
| 4 项联动授权信息 | KASIKA 管理员提供的四串完整字符，分别填写 | 四个输入框都必须填写；保存后只能看到每项末尾的少量字符。 |
| 批量导出／导入 settingID | KASIKA 管理员提供的编号 | 两项都已填写；它们不替代 4 项授权信息。 |
| 绑定完成通知 `自動返信ID` | KASIKA 绑定完成通知模板的编号 | 指向正确、已启用的绑定完成通知模板，不是首次入口邀请模板。 |
| `VISTAURL`／`VISTAPWD` | 系统只读显示，复制给 KASIKA 管理员 | 这是字段名称，不是实际链接或密码。 |
### 3.3 两个运营开关怎么选
| 开关 | 建议 | 开启时 | 关闭时 |
| --- | --- | --- | --- |
| 是否需要 VISTA 访问密码 | 默认开启 | 新建顾客在邮箱确认后设置密码；同步兜底时会生成初始密码 | 顾客仍要确认邮箱，但无需设置密码；访问安全性下降 |
| `customer_status` 状态权限自动更新 | 默认开启 | 顾客后续状态变化时，自动更新同名标签和内容权限 | 仅记录新状态，不自动改标签或内容权限 |
注意：关闭“状态权限自动更新”不会取消已经给出的权限；也不影响顾客首次绑定时按当时状态计算初始权限。重新开启后，只影响之后的同步结果，不会自动补算所有历史顾客。
### 3.4 保存后的正确检查方法
保存成功只是“资料已记录”，不是“联动已经可用”。完成第 4、5 章后，再用测试顾客走完一次邮件、绑定、内容查看和同步检查。
如需修改某一项联动授权信息，请进入该项的编辑状态，重新输入该项的完整内容。未修改的其他授权信息无需重新填写。
> 【配图】HOMEVISTA KASIKA 联动配置页：输入区、复制区、两个运营开关和同步日志入口。
---
## 4. 设置顾客主动绑定入口
主动绑定是最适合咨询、预约和定向邀约的方式：顾客从 KASIKA 邮件进入 VISTA，输入在 KASIKA 登记的邮箱，系统确认后建立双方关系。
### 4.1 上线前设置步骤
1. 在 HOMEVISTA 完成第 3 章的联动配置。
2. 在 KASIKA 的首次入口邀请邮件模板中放入 VISTA 项目入口基础 URL；向测试顾客实际发送后，确认 KASIKA 自动附加 `kasikacid`。
3. 在 VISTA 建好第 5 章所需的状态标签和权限模板。
4. 准备一位未绑定的测试顾客，以及一位已经在 VISTA 存在同邮箱资料的测试顾客。
5. 分别测试“新建顾客”“绑定已有 VISTA 顾客”和“邮箱输入错误”三种情况。
### 4.2 顾客实际会经历什么
| 顾客情况 | 系统处理 | 运营人员应知道的事 |
| --- | --- | --- |
| 已绑定，且邮箱一致 | 直接进入 VISTA，不重新设置密码 | 不会重复发送绑定完成通知，也不会重复建立账号。 |
| 未绑定，但 VISTA 有同邮箱顾客 | 邮箱确认后建立绑定，不重设原密码 | 系统会自动检查。顾客成功进入后无需处理；如页面提示无法绑定，按第 8 章记录并交给管理员。 |
| 未绑定，VISTA 没有同邮箱顾客 | 创建 VISTA 顾客；项目要求密码时，再请顾客设置密码 | 首次绑定后按顾客状态设置初始内容权限。 |
| 邮箱不一致、已绑定其他顾客或存在异常 | 不自动覆盖，提示顾客稍后联系工作人员 | 运营人员记录顾客和发生时间，由 VISTA 管理员查看同步日志并处理。 |
### 4.3 首次绑定后系统会做什么
首次绑定成功后，系统会保存 KASIKA 顾客编号、邮箱和顾客状态；按状态尝试配置同名标签；计算顾客可看内容；再向 KASIKA 的 `VISTAURL` 回写访问链接，并在项目启用访问密码时向 `VISTAPWD` 回写首次访问密码。访问方式准备好后，HOMEVISTA 使用已配置的 `自動返信ID` 触发绑定完成通知邮件。VISTA 顾客编号、绑定状态和首次访问完成时间只保留在 HOMEVISTA，不回写 KASIKA。任一回写或邮件发送失败，不会撤销已经完成的账号和绑定，只会留下待检查记录；已绑定顾客再次访问时不会重复发送绑定完成通知。
> 【配图】顾客点击邮件 → 输入邮箱 → 设置密码（如需要）→ 进入内容的四步图。
---
## 5. 设置标签、内容权限和顾客状态联动
这一章决定“不同阶段的顾客能看什么”。请先做映射表，再进入系统设置；不要直接在单个顾客页面逐个处理。
### 5.1 先完成状态—标签—内容映射表
| KASIKA 顾客状态示例 | VISTA 标签（名称必须完全相同） | 标签权限模板中的内容示例 |
| --- | --- | --- |
| 资料请求 | 资料请求 | 项目介绍、基础资料 |
| 来场预约 | 来场预约 | 户型、预约说明 |
| 商谈中 | 商谈中 | 价格资料、专属说明 |
如果某个状态不应开放任何内容，也请明确写进项目规则。状态为空、没有同名标签或标签没有模板时，顾客仍可绑定，但可能没有新增内容权限。
### 5.2 在 VISTA 中建立标签和权限模板
标签和权限模板是两层配置，请按顺序操作：
**第一步：创建标签本体**
由 VISTA 管理员进入"**标签管理**"页面（左侧导航菜单），新增与 KASIKA 顾客状态名称完全一致的标签。例如 KASIKA 有"资料请求"、"来场预约"、"商谈中"三种状态，就需要在标签管理页创建三个同名标签。
- 标签名称必须与 KASIKA 顾客状态名称**逐字一致**，否则联动时无法匹配。
- 标签创建后，可以在标签列表中看到每个标签的名称、使用顾客数等信息。
- 标签本身不绑定任何内容，内容由下一步的权限模板决定。
> 注意：标签管理页是管理标签本身（新增、编辑、删除、停用）的页面。改名或删除与 KASIKA 状态同名的标签前，必须先确认联动影响——删除标签会同时删除其权限模板，并移除所有顾客与该标签的关系。
**第二步：为标签配置权限模板**
在"标签管理"页面的标签列表中，找到需要配置的标签行，点击"**权限编辑**"按钮，进入**标签权限模板设定页**。
1. 输入模板名称（必填，30 字符以内）。
2. 至少选择一项该类顾客可以查看的内容（户型图、样板间、外景、资料集、导航菜单等）。
3. 模板只能选择管理员已批准分享的内容；标记为不可分享的内容将不可选择。
4. 保存前确认页面显示的受影响顾客数和本次选择的内容范围，再确认保存。
5. 用测试顾客确认该标签实际展示的内容。
> 提示：标签权限模板设定页是独立页面，顶部可以切换编辑对象标签，方便连续编辑多个标签的模板。
**操作原则：**
- 每个标签最多配置一份权限模板；标签允许不配置模板（此时该标签不产生额外内容权限）。
- 模板保存后立即影响所有带有该标签的顾客，不需要再次执行"应用"操作。
- 同一顾客有多个标签时，可看内容为各标签模板内容的合并。
- "个人权限追加"只能增加个别顾客可看的内容，不能取消标签模板已经赋予的内容。
### 5.3 开启状态自动更新后的结果
当第 3 章的“状态权限自动更新”开启时，HOMEVISTA 在后续同步中发现顾客状态变化，会添加新状态的同名标签并移除上一状态对应的同名标签，然后重新计算内容权限。这个操作不影响顾客身上的其他标签和个人权限追加。
当该开关关闭时，系统仍记录新状态，但不会自动改变标签或权限。需要手动处理时，进入该顾客详情的“权限／编辑”页面调整 VISTA 标签并保存；这项操作只改变 VISTA，不会修改 KASIKA 顾客状态。整类顾客的内容范围应调整标签权限模板，不要逐个顾客设置。
**特别注意状态为空或未映射的情况：**开启自动更新后，顾客状态发生变化但 VISTA 没有同名标签时，系统不会自动创建新标签，仍会移除上一状态对应的标签。因此，这部分顾客可能失去原状态带来的内容；但其其他标签和个人权限追加仍按原规则保留。即使新状态有同名标签，若新模板没有包含低阶段内容，顾客也会失去原先可看的低阶段内容。新增、改名或停用 KASIKA 顾客状态前，必须先确认 VISTA 的同名标签和权限模板，并决定高阶段是否应保留低阶段内容。
> 【配图】KASIKA 顾客状态 → VISTA 同名标签 → 权限模板 → 顾客可看内容的关系图。
---
## 6. 上线前最小确认与日常检查
> **与完整测试的关系：**本章是上线后运营人员使用的最小确认和日常检查清单，不是二期完整测试手顺。测试人员不得因为本章全部勾选就宣布二期测试完成；先用《12-二期测试用例清单（框架）》确认范围，再按《13-RENO 测试执行手册（中文版）》执行、记录“符合预期／不符合预期／无法执行或无法判定”及异常交接。本章中的检查项与 12 的 T03、T04、T05、T07、T08、T10、T12 相互对应，但不单独重复执行。
### 6.1 上线前最小确认
请由管理员和运营人员共同完成以下测试，并记录结果：
- [ ] 如采用主动邀请方案，KASIKA 首次入口邀请邮件中的链接能正常打开，并带入测试顾客编号。
- [ ] 新顾客可以完成邮箱确认；项目启用密码时，可以设置密码并进入内容。
- [ ] 已存在同邮箱的 VISTA 测试顾客可以绑定，且原密码不会被重设。
- [ ] KASIKA 顾客状态能命中 VISTA 同名标签，顾客看到正确内容。
- [ ] 更改测试顾客状态后，在状态自动更新开启时，内容范围会按新状态更新。
- [ ] 已测试状态升级、回退、清空或变为未映射状态时的内容变化，并确认项目已决定哪些内容应保留、哪些内容可以收回。
- [ ] KASIKA 中能看到首次回写的 VISTA 链接；开启密码时，确认密码字段结果符合项目规则。
- [ ] 首次绑定后能收到绑定完成通知；邮件包含 `VISTAURL`，并只在启用密码时显示 `VISTAPWD`。
- [ ] 未通过入口主动绑定的测试顾客，在执行全量同步检查后也能完成绑定、字段回写和绑定完成通知。
- [ ] 测试顾客浏览 VISTA 内容后，浏览履历能记录到 KASIKA 中正确的顾客名下。
- [ ] 如采用公开内容固定链接方案，未登录浏览器可以打开该内容，且不会看到内部或专属资料。
- [ ] HOMEVISTA 同步日志没有未处理的失败项。
### 6.2 查看单个顾客的联动状态
需要确认某位顾客是否已联动时，由 VISTA 管理员进入“**顾客详情 → 概要**”。这里可以查看 KASIKA 顾客编号、邮箱、顾客状态、关联状态和最近一次同步结果。发现信息不一致或同步失败时，再到同步日志查看详细记录。
### 6.3 日常检查节奏
| 时间 | 运营人员检查什么 | 发现问题后的动作 |
| --- | --- | --- |
| 新项目上线后 | 邮件、绑定、内容权限是否完整跑通 | 暂停向正式顾客群发送，先用测试顾客修正。 |
| 每周 | VISTA 管理员在“项目设置 → KASIKA 联动配置管理 → 同步日志”中查看是否有失败、绑定冲突、状态为空或状态没有同名标签的记录 | 管理员核对配置；其他运营人员没有完整日志权限时，按项目约定请管理员检查。异常绑定不要自行覆盖。 |
| 需要立即补查时 | VISTA 管理员或销售经理在“顾客列表”点击“全量同步检查”，完成后查看结果摘要；如需完整日志，由 VISTA 管理员查看 | 该操作会检查本次可取得的全部 KASIKA 顾客，不只检查当前勾选项。任务开始后不能取消；关闭页面也不会停止。任务处理中不要反复点击。 |
| 改标签或模板前 | 会影响哪些顾客，是否有不应继续分享的内容 | 先确认影响名单，再保存模板。 |
| 改 KASIKA 邮件前 | 首次入口邀请邮件的入口链接和顾客编号是否正确；绑定完成通知邮件的访问链接和适用时的密码字段是否正确 | 两类邮件分别用测试顾客验证。 |
### 6.4 顾客资料和异常处理边界
- 顾客资料从 KASIKA 同步到 VISTA。在 VISTA 单独新增、导入或修改顾客，不会在 KASIKA 中自动创建或更新顾客；需要调整 KASIKA 顾客资料时，应在 KASIKA 中处理。
- VISTA 顾客删除后，不会删除 KASIKA 顾客，也不会清空 KASIKA 中已经写入的 VISTA 链接或密码。
- 后续同步再次取得同一位 KASIKA 顾客时，系统会将其作为未绑定顾客重新匹配或新建 VISTA 顾客，但不会恢复到已经删除的原 VISTA 顾客；出现重复顾客或恢复记录时，交由管理员处理。
- 顾客后续在 VISTA 修改密码时，KASIKA 的 `VISTAPWD` 不会更新。该字段只保存首次访问时使用的密码，不应作为顾客当前密码判断依据。
- 系统当前不提供前台“解除绑定”“重新绑定”或“改绑”按钮。
- 邮箱不一致、绑错顾客、顾客已删除后恢复等复杂情况，运营人员应记录现象和发生时间，由 VISTA 管理员保留日志并交给技术支持处理；不要在前台反复尝试绑定。
---
## 7. 运营联动方案设计与使用方法
本章按“完整运营方案”和“关键联动环节”组织。选择方案时先看目标和顾客，再按相应小节的前提与检查点执行。
### 7.1 运营方案：固定链接推广公开内容
| 项目 | 说明 |
| --- | --- |
| 适用目标 | 在广告、短信、群发邮件中快速引导更多人查看公开介绍或活动信息。 |
| 适用顾客 | 尚未登记、无需识别身份的潜在顾客。 |
| 前提设置 | 本方案仅在项目提供“公开内容固定链接”时适用。由 VISTA 管理员在**已发布为公开**的内容发布／分享页面复制固定链接，并用未登录浏览器确认该内容无需账户即可查看；如项目暂未提供公开内容，则不使用本方案。内部或专属资料不得使用固定链接推广。 |
| 操作方法 | 在 KASIKA 的常规营销邮件或其他推广渠道放入固定链接。 |
| 顾客体验 | 点击后直接浏览公开内容。 |
| 检查点 | 用未登录浏览器确认链接、页面和公开内容均正确。 |
| 注意事项 | 这不是账户联动：不能识别 KASIKA 具体顾客，不能建立绑定，不能按 `customer_status` 自动控制内容，也不会回写个人访问信息。 |
### 7.2 运营方案：咨询／预约后，邀请顾客主动绑定 VISTA
| 项目 | 说明 |
| --- | --- |
| 适用目标 | 把已咨询、预约或登记的顾客引导至专属内容。 |
| 适用顾客 | KASIKA 中已有邮箱和顾客编号的顾客。 |
| 前提设置 | 完成第 2～5 章；在 KASIKA 首次入口邀请邮件模板配置 VISTA 项目入口基础 URL。顾客编号由 KASIKA 在实际发信时自动附加。 |
| 操作方法 | 将该模板绑定到咨询、预约或登记后的自动回复规则；顾客点击后按第 4 章完成绑定。 |
| 顾客体验 | 顾客输入登记邮箱；首次新建时，按项目设置决定是否创建密码。 |
| 检查点 | 确认顾客已绑定、链接已回写、状态对应内容正确。 |
| 注意事项 | 邮箱不一致或绑定冲突时不自动覆盖，应由运营人员跟进。 |
### 7.3 联动环节：未主动进入顾客的自动同步
| 项目 | 说明 |
| --- | --- |
| 环节目的 | 对没有通过首次入口主动绑定的顾客，补齐 VISTA 账号、绑定关系和访问通知。 |
| 处理对象 | 本项目内 KASIKA 可以取得的全部顾客；已绑定顾客也会继续参与资料和状态更新。 |
| 前提设置 | 4 项联动授权信息、两个 settingID 和 `自動返信ID` 均已配置；KASIKA 绑定完成通知模板已可用。 |
| 操作方法 | 系统每小时自动检查，不需要运营人员另行选择是否启用。需要立即执行时，VISTA 管理员或销售经理可在 HOMEVISTA“顾客列表”点击“全量同步检查”；其他运营人员按项目约定请管理员或销售经理执行。手动检查和定时检查的处理范围与规则相同。 |
| 顾客体验 | 系统为未绑定顾客匹配或创建 VISTA 顾客、回写访问方式后，再触发绑定完成通知邮件。项目启用密码时，邮件可带入系统生成的初始密码。 |
| 检查点 | 手动执行人先查看同步完成摘要；完整同步日志仅 VISTA 管理员可查看，其他运营人员发现失败时请管理员核对“顾客处理、回写、邮件发送”结果。 |
| 注意事项 | **“全量同步检查”会处理本次 KASIKA 可以取得的全部顾客，不按页面当前勾选项执行。** 未绑定顾客可能集中完成首次绑定、回写访问方式并收到绑定完成通知，执行前应确认发送时间。任务启动后不能取消，关闭页面也不会停止。已绑定顾客不会被重复创建、重复回写首次访问方式或重复发送绑定完成通知。运营人员不要同时手工群发同类访问通知。 |
### 7.4 运营方案：按顾客状态逐步开放内容
| 项目 | 说明 |
| --- | --- |
| 适用目标 | 让资料请求、预约、商谈等不同阶段的顾客看到不同深度的内容。 |
| 适用顾客 | 已完成或即将完成 KASIKA—VISTA 绑定的顾客。 |
| 前提设置 | 已完成状态—标签—权限模板映射；建议开启“状态权限自动更新”。 |
| 操作方法 | 在 KASIKA 维护顾客状态；HOMEVISTA 后续同步后按同名标签更新权限。 |
| 顾客体验 | 访问链接通常不变，但可看内容会随状态变化。 |
| 检查点 | 每次新增状态名称时，同时确认 VISTA 是否已有完全同名标签和权限模板。 |
| 注意事项 | 如果关闭自动更新，后续状态变化不会自动改权限；首次绑定的初始权限不受此开关影响。无论状态升级、回退、清空还是变为未映射状态，原状态标签被移除时都可能缩减内容。新状态模板不会自动继承低阶段模板的内容；如希望顾客持续看到低阶段资料，必须在新状态模板中一并选择这些内容。任何状态规则调整前，先确认受影响顾客和内容继承规则。 |
### 7.5 运营方案：根据浏览履历安排后续跟进
| 项目 | 说明 |
| --- | --- |
| 适用目标 | 根据顾客实际关注的内容判断跟进优先级和沟通主题。 |
| 适用顾客 | 已能在 KASIKA 中识别、且已产生 VISTA 浏览履历的顾客。 |
| 前提设置 | HOMEVISTA 已填写正确 PID，顾客浏览履历能够上报到 KASIKA。 |
| 操作方法 | 在 KASIKA 查看顾客浏览过的内容和时间，筛选需要跟进的顾客；由销售人工联系，或使用 KASIKA 的常规营销规则发送后续邮件。 |
| 顾客体验 | 收到与其关注内容更相关的说明和跟进，减少重复或无关信息。 |
| 检查点 | 抽查测试顾客的浏览履历是否记录到正确顾客名下，并确认后续名单条件。 |
| 注意事项 | 浏览履历只作为 KASIKA 后续经营的参考，不会直接改变 VISTA 标签、账号或内容权限；是否发送后续邮件完全由 KASIKA 的运营规则决定。 |
### 7.6 运营方案：阶段性活动运营
| 项目 | 说明 |
| --- | --- |
| 适用目标 | 向一批特定顾客推广线上说明会、限时资料或阶段性活动。 |
| 适用顾客 | 已有明确筛选条件的 KASIKA 顾客或 VISTA 已绑定顾客。 |
| 前提设置 | 先确定活动对象、内容公开范围和结束后的处理人。公开活动使用第 7.1 节固定链接；专属活动需先确认目标顾客已经可以查看相关内容。 |
| 操作方法 | 在 KASIKA 按目标顾客发送活动邮件：公开活动放入固定链接；已绑定顾客可在邮件中使用 `VISTAURL`；未绑定顾客使用第 7.2 节的主动绑定入口。 |
| 顾客体验 | 进入与活动相关的内容；是否需要身份确认取决于所用入口方式。 |
| 检查点 | 活动开始前测试邮件和内容；活动结束后按计划修改活动标签或模板。 |
| 注意事项 | 当前规则未定义“到期自动收回权限”。如需结束专属内容展示，由 VISTA 管理员按活动计划调整标签、模板或个人权限。 |
### 7.7 多方案同时使用时的规则
推荐组合是：用固定链接做泛推广；对需要专属内容的咨询和预约顾客使用主动绑定；未主动进入的顾客由系统同步补齐绑定和访问通知；对已绑定顾客用状态联动持续分层；再根据顾客浏览履历安排后续跟进。
为避免混乱，请遵守三条规则：
1. 同一顾客首次绑定成功后，不要再用“绑定完成通知”逻辑重复发送同类邮件；普通运营邮件应按 KASIKA 常规营销规则另行发送。
2. 每新增一种 KASIKA 顾客状态，先补齐 VISTA 同名标签和模板，再用于正式顾客。
3. 固定链接推广、顾客浏览履历和账号／权限联动要分开管理：公开内容不应依赖个人状态，浏览履历不直接改变 VISTA 权限，专属内容不应只靠固定链接开放。
> 【配图】从泛推广、主动绑定、自动同步到状态分层的顾客运营路径图；顾客浏览履历作为后续跟进的信息来源。
---
## 8. 常见问题与支持交接
| 现象 | 先检查什么 | 建议处理人 |
| --- | --- | --- |
| 保存设置后无法联动 | KASIKA 功能是否已开通；4 项授权信息是否齐全；IP 是否已登记 | 项目管理员、KASIKA 管理员 |
| 进入 VISTA 配置页，所有字段显示为空白 | 项目尚未开通 KASIKA 联动功能，需联系销售人员开启总开关 | 销售人员、VISTA 管理员 |
| 保存配置时提示"请联系销售人员开启 KASIKA 功能" | 一期运营后台 KASIKA 联动总开关未开启 | 销售人员、VISTA 管理员 |
| 邮件链接打不开 | 模板中的项目入口基础 URL 是否正确；实际收到的链接是否由 KASIKA 自动附加了 `kasikacid` | KASIKA 管理员、运营人员 |
| 顾客无法绑定 | 输入邮箱是否与 KASIKA 登记邮箱一致；是否已绑定其他顾客 | 运营人员、项目管理员 |
| 顾客绑定成功，但在 KASIKA 中看不到 VISTAURL | `VISTAURL` 自定义字段名是否与 VISTA 配置页显示完全一致；导出/导入 settingID 是否正确 | KASIKA 管理员、VISTA 管理员 |
| 顾客绑定成功却看不到内容 | 先确认 KASIKA 顾客状态名称，再确认 VISTA 同名标签、权限模板和内容分享资格是否齐全 | KASIKA 管理员、HOMEVISTA 管理员 |
| 顾客状态已变，内容未变 | 是否开启状态权限自动更新；同步日志是否有失败 | HOMEVISTA 管理员 |
| 没收到首次入口邀请邮件 | KASIKA 的发送对象、发送时点、触发条件及首次入口邀请模板是否正确 | KASIKA 管理员、运营人员 |
| 已绑定但没收到绑定完成通知 | `自動返信ID` 是否指向正确模板；模板是否启用；同步日志是否有邮件失败 | KASIKA 管理员、HOMEVISTA 管理员 |
| VISTA 删除顾客后，KASIKA 顾客又通过同步重新出现了 | 预期行为：删除 VISTA 顾客不会删除 KASIKA 顾客。如需阻止该顾客重新绑定，需由管理员走后台错误绑定处置流程 | VISTA 管理员、技术支持 |
| 邮箱不一致、绑定冲突或疑似错绑 | 运营人员记录发生时间、顾客邮箱和页面截图；由 VISTA 管理员在“项目设置 → KASIKA 联动配置管理 → 同步日志”查找对应记录 | 运营人员按项目约定渠道提报项目管理员；管理员或技术支持进行后台数据处理，前台不反复尝试绑定 |
发生绑定冲突时，运营人员的标准动作是：记录必要信息 → 按项目约定渠道提报项目管理员 → 等待后台处理结果 → 用测试或该顾客再次确认。不要自行删除、改绑或在前台反复尝试。
需要技术支持时，请提供：项目名称、发生时间、使用的运营方案、测试顾客的必要识别信息、页面截图，以及同步日志中的结果摘要。不要通过邮件或聊天发送完整授权信息、访问密码或完整顾客资料。
---
## 9. 附录：术语表
| 术语 | 说明 |
| --- | --- |
| KASIKA | 日本不动产行业 CRM/MA 平台（Cocolive 公司），负责顾客获取、资料请求、自动回复邮件、场景邮件和客户经营 |
| HOMEVISTA（VISTA） | 项目内容展示平台，负责户型图、样板间、资料集的展示和访问权限控制 |
| PID | KASIKA 为项目分配的 32 位识别码，用于浏览履历上报。不用于 API 认证 |
| API KEY | 调用 KASIKA API 所需的密钥，共 4 项：公司访问密钥、公司 Secret Key、用户访问密钥、用户 Secret Key |
| 公司访问密钥 / 公司 Secret Key | 从"基本信息设置 → API 设置 → API 通用设置"取得的两项密钥，32 位半角英数字 |
| 用户访问密钥 / 用户 Secret Key | 从"账号设置 → API 设置"取得的两项密钥，32 位半角英数字。如尚未创建需点击"访问密钥创建" |
| settingID | KASIKA 顾客批量导出/导入 API 设置的识别编号，在创建导出/导入设置后获得 |
| 顾客导出 API settingID | 用于指定 VISTA 从 KASIKA 批量拉取顾客数据时使用的导出设置 |
| 顾客导入 API settingID | 用于指定 VISTA 向 KASIKA 批量回写访问链接和密码时使用的导入设置 |
| VISTAURL | KASIKA 自定义字段名，用于接收 VISTA 回写的顾客访问链接。必须在 KASIKA 侧按此名称精确创建 |
| VISTAPWD | KASIKA 自定义字段名，用于接收 VISTA 回写的首次访问密码。仅项目启用访问密码时使用 |
| 自動返信ID | KASIKA 自动回复邮件模板的识别编号。VISTA 首次绑定完成后使用该 ID 触发 KASIKA 发送绑定完成通知邮件 |
| `kasikacid` | KASIKA 顾客编号，从 KASIKA 邮件链接中传入 VISTA 入口页，用于识别顾客身份 |
| `customer_status` | KASIKA 顾客状态字段，是联动中驱动 VISTA 标签和内容权限变化的唯一字段来源 |
| 顾客状态 | 即 `customer_status`，表示顾客在 KASIKA 中的所处阶段（如"资料请求""来场预约""商谈中"） |
| VISTA 标签 | VISTA 中的顾客分类标签，名称与 KASIKA 顾客状态一致时可被联动自动匹配 |
| 标签权限模板 | 为 VISTA 标签配置的可访问内容集合，决定带有该标签的顾客能看到哪些内容 |
| VISTA 服务器 IP 地址 | VISTA 系统的出口 IP，需登记到 KASIKA API 允许列表，否则 KASIKA 会拒绝 VISTA 的 API 请求 |
| VISTA 项目入口 URL | VISTA 提供的入口链接（不含具体顾客编号），需填入 KASIKA 首次入口邀请邮件模板 |
| KASIKA入口页 | 顾客从 KASIKA 邮件点击进入 VISTA 时看到的首次访问页面，用于邮箱校验、可选密码设置和账号绑定 |
| 全量同步检查 | VISTA 顾客列表页的手动按钮，触发一次性 KASIKA 顾客全量同步。仅管理员和销售经理可操作 |
| 同步日志 | 记录所有 KASIKA 联动相关操作的日志，仅 VISTA 管理员可在"项目设置 → KASIKA 联动配置管理 → 同步日志"查看 |
| KASIKA 联动总开关 | 一期运营后台控制项，决定 VISTA 项目是否可使用 KASIKA 联动功能。未开启时配置页显示为空白 |
| 主动绑定（KASIKA入口页绑定） | 顾客点击 KASIKA 邮件中的入口链接，完成邮箱校验后建立的绑定方式 |
| 同步兜底绑定 | 顾客未点击入口时，由系统定时同步或手动全量同步检查完成绑定，并通过绑定完成通知邮件触达顾客 |
## 附录：关联需求文档
- `00-总览与范围.md`
- `01-KASIKA联动配置管理.md`
- `03-标签权限模板.md`
- `04-统一顾客联动同步流程.md`
- `07-同步日志与追溯.md`
- `08-KASIKA入口页与VISTA首次访问开户.md`
- `09-C端顾客访问权限接口.md`
- `10-KASIKA联动帮助说明.md`（字段级帮助来源；本指南未修改该文档）