# 10-KASIKA 联动帮助说明（中日双语）

## 1. 范围

本文只说明 VISTA 与 KASIKA 关联所需的配置、同步、入口页、权限映射和排障，不说明 KASIKA 通用营销或客户管理功能。

本ヘルプは VISTA と KASIKA の連携設定、同期、入口ページ、権限反映、トラブル確認に限定します。KASIKA の一般機能は対象外です。

## 2. 使用规则

- 每个模块可单独用于字段级帮助弹窗。
- 帮助仅限有 VISTA B 端设置权限的管理员查看，不作为公开帮助站发布。
- 不展示真实 API KEY、Secret Key、访问密码、客户数据或完整 Cookie。

- 各モジュールは項目別ヘルプとして単独利用できます。
- VISTA B 端設定権限を持つ管理者向けで、公開ヘルプサイトにはしません。
- 実 API KEY、Secret Key、アクセスパスワード、顧客データ、Cookie 完全値は表示しません。

## 3. 模块索引

| 模块 ID | 适用位置 | 截图状态 |
| --- | --- | --- |
| `KASIKA-LINK-00` | 整体配置流程 | 待补 |
| `KASIKA-LINK-01` | KASIKA 功能未开通提示 | 待补 |
| `KASIKA-LINK-02` | VISTA 服务器 IP 地址 | 部分可用 |
| `KASIKA-LINK-03` | 4 个 API KEY | 可用 |
| `KASIKA-LINK-04` | 顾客批量 API settingID | 可用 |
| `KASIKA-LINK-05` | VISTAURL / VISTAPWD | 待补 |
| `KASIKA-LINK-06` | VISTA 项目入口 URL | 待补 |
| `KASIKA-LINK-07` | 绑定通知自動返信ID | 待补 |
| `KASIKA-LINK-08` | PID | 待补 |
| `KASIKA-LINK-09` | VISTA 访问密码设置 | 待补 |
| `KASIKA-LINK-10` | customer_status 自动更新 | 待补 |
| `KASIKA-LINK-11` | 保存、编辑、脱敏 | 待补 |
| `KASIKA-LINK-12` | 同步日志与排障 | 待补 |

## 4. 帮助模块

### KASIKA-LINK-00 整体配置流程

中文：先开通 KASIKA 功能，再配置 KASIKA API 允许 IP、4 个 API KEY、settingID、自定义字段、自动回复邮件模板和自動返信ID，最后回到 VISTA 保存。保存成功只表示配置已记录，实际可用性以后续 API 调用和同步日志为准。

日本語：KASIKA 機能を有効化した後、KASIKA 側で許可 IP、4 つの API KEY、settingID、カスタム項目、自動返信メール、自動返信IDを設定し、最後に VISTA で保存します。保存成功は設定保存を意味し、実利用可否は後続 API と同期ログで確認します。

截图：待补 VISTA 设置页完整配置示意。

### KASIKA-LINK-01 KASIKA 功能未开通

中文：运营后台总开关未开启时，设置页可进入，但所有已保存值和系统生成值都显示为空。提交保存时会被拦截，并提示联系销售人员开启 KASIKA 功能。

日本語：運営后台の総スイッチが無効の場合、設定画面には入れますが、保存済み値とシステム生成値はすべて空欄になります。保存時はブロックされ、営業担当へ有効化依頼する案内を表示します。

### KASIKA-LINK-02 VISTA 服务器 IP 地址

中文：将该 IP 登记到 KASIKA API 允许来源，避免 KASIKA 因 IP 限制拒绝 VISTA 请求。该值由系统生成，只读展示，不参与表单保存。

日本語：この IP を KASIKA API の許可元に登録し、IP 制限による VISTA リクエスト拒否を防ぎます。この値はシステム生成の読み取り専用で、保存フォーム項目ではありません。

截图：`../../kasikaAPI帮助html/assets/images/asset-98c89a933e0676347a59.png`

### KASIKA-LINK-03 4 个 API KEY

中文：4 个 API KEY 用于 VISTA 调用 KASIKA 顾客相关 API，缺一项都会影响入口页、同步或邮件触发。保存后仅显示末尾 4 位，不提供明文查看或复制。

日本語：4 つの API KEY は VISTA が KASIKA 顧客 API を呼び出すために必要で、不足すると入口ページ、同期、メール送信に影響します。保存後は末尾 4 桁のみ表示し、平文表示やコピーはできません。

截图：

- 公司访问密钥：`../../kasikaAPI帮助html/assets/images/asset-790129ef5f6b122f8a93.png`
- 公司 Secret Key：`../../kasikaAPI帮助html/assets/images/asset-1095a960944db097e884.png`
- 用户访问密钥：`../../kasikaAPI帮助html/assets/images/asset-591cb1d99520d66d2ac8.png`
- 用户 Secret Key：`../../kasikaAPI帮助html/assets/images/asset-0eb0537192b3a420ff23.png`

### KASIKA-LINK-04 顾客批量 API settingID

中文：settingID 用于指定 KASIKA 批量导出/导入 API 的设置，不替代 API KEY。VISTA 保存时不验证可用性，实际结果以 KASIKA API 返回和同步日志为准。

日本語：settingID は KASIKA の一括エクスポート/インポート API 設定を指定する ID で、API KEY の代替ではありません。VISTA 保存時には検証せず、実結果は API 応答と同期ログで確認します。

截图：

- 客户导入 API settingID：`../../kasikaAPI帮助html/assets/images/asset-4553fbcce89cf4679b79.png`
- 客户导出 API settingID：`../../kasikaAPI帮助html/assets/images/asset-9806e65d210be0664d30.png`

### KASIKA-LINK-05 VISTAURL / VISTAPWD

中文：`VISTAURL` 和 `VISTAPWD` 是 KASIKA 自定义字段名，用于接收 VISTA 回写的入口 URL 和访问密码相关值。它们不是实际 URL 或实际密码，需在 KASIKA 侧按完全一致的名称创建。

日本語：`VISTAURL` と `VISTAPWD` は、VISTA が入口 URL とアクセスパスワード関連値を書き戻すための KASIKA カスタム項目名です。実 URL や実パスワードではなく、KASIKA 側で同じ名称で作成します。

截图：待补 KASIKA 自定义字段创建页面。

### KASIKA-LINK-06 VISTA 项目入口 URL

中文：该 URL 填入 KASIKA 自动回复邮件模板，顾客点击后进入 VISTA 的 KASIKA 入口页。设置页展示的 URL 不含顾客 ID，实际邮件需由 KASIKA 变量追加 `kasikacid`。

日本語：この URL は KASIKA 自動返信メールテンプレートに設定し、顧客クリック後に VISTA の KASIKA 入口ページへ遷移します。設定画面の URL には顧客 ID は含まず、実メールでは KASIKA 変数で `kasikacid` を付与します。

示例：

```text
https://{domain}.homevista.jp/kasika-entry?kasikacid={KASIKA顾客ID}
```

截图：待补 KASIKA 自动回复邮件模板截图。

### KASIKA-LINK-07 绑定通知自動返信ID

中文：自動返信ID 用于首次绑定完成后触发 KASIKA 侧已配置的自动回复邮件。邮件内容由 KASIKA 模板决定，VISTA 只保存触发模板的 ID。

日本語：自動返信IDは、初回紐付け後に KASIKA 側で設定済みの自動返信メールを送るために使います。メール内容は KASIKA テンプレートに従い、VISTA は呼び出し用 ID のみ保存します。

截图：待补自動返信ID 确认页面。

### KASIKA-LINK-08 PID

中文：PID 用于访问上报、浏览履历或转化相关能力，不用于 KASIKA 顾客 API 认证。保存时不验证可用性，后续以上报或转化结果确认。

日本語：PID はアクセス送信、閲覧履歴、コンバージョン関連機能に使用し、KASIKA 顧客 API 認証には使いません。保存時には検証せず、後続結果で確認します。

### KASIKA-LINK-09 VISTA 访问密码设置

中文：该开关控制新建 VISTA 顾客权限时是否要求访问密码，默认开启。关闭会降低访问安全性，因此需要二次确认。

日本語：このスイッチは新規 VISTA 顧客権限作成時にアクセスパスワードを要求するかを制御し、初期値は有効です。無効化すると安全性が下がるため確認が必要です。

### KASIKA-LINK-10 customer_status 自动更新

中文：开启时，首次绑定后的 `customer_status` 变化会同步到同名 VISTA 标签并触发权限更新；关闭时只保存和展示状态，不主动改标签或权限。首次绑定时的标签初始化仍会执行一次。

日本語：有効時は、初回紐付け後の `customer_status` 変化を同名 VISTA タグへ反映し権限更新します。無効時は状態を保存・表示するだけで、タグや権限は更新しません。初回紐付け時のタグ初期化は 1 回実行します。

### KASIKA-LINK-11 保存、编辑、脱敏

中文：所有编辑项必填，保存后变为只读；点击“编辑”会清空字段，需重新输入完整值。只有 4 个 API KEY 脱敏，仅显示末尾 4 位，禁止明文查看和复制。

日本語：編集項目はすべて必須で、保存後は読み取り専用になります。「編集」を押すと項目は空になり、完全な値を再入力します。マスク対象は 4 つの API KEY のみで、末尾 4 桁だけ表示し、平文表示とコピーは禁止します。

### KASIKA-LINK-12 同步日志与排障

中文：保存成功不代表联动已成功，真实结果看同步日志和 KASIKA API 返回。认证失败查 4 个 API KEY，IP 拒绝查 VISTA 服务器 IP，settingID 错误查批量 API 设置，入口 404 查 URL、域名和 `kasikacid`。

日本語：保存成功は連携成功を意味せず、実結果は同期ログと KASIKA API 応答で確認します。認証失敗は 4 つの API KEY、IP 拒否は VISTA サーバー IP、settingID エラーは一括 API 設定、入口 404 は URL、ドメイン、`kasikacid` を確認します。

## 5. 来源与依据

- `kasikaAPI帮助html/sources/KASIKA_API_中文说明.md`
- `kasikaAPI帮助html/sources/KASIKA_API_原文抓取.md`
- `新二期需求整理/输出稿/01-KASIKA联动配置管理.md`
- `新二期需求整理/输出稿/04-统一顾客联动同步流程.md`
- `新二期需求整理/输出稿/07-同步日志与追溯.md`
- `新二期需求整理/输出稿/08-KASIKA入口页与VISTA首次访问开户.md`