# 10-KASIKA 連携ヘルプ説明 ## 1. 範囲 本書は VISTA と KASIKA の連携に必要な設定、同期、入口ページ、権限反映、トラブル確認のみを説明します。KASIKA の汎用マーケティング機能および顧客管理機能は対象外です。 ## 2. 利用ルール - 各モジュールは項目別ヘルプとして単独利用できます。 - ヘルプは 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 側で許可 IP、4 つの API KEY、settingID、カスタム項目、自動返信メールテンプレート、自動返信IDを設定し、最後に VISTA で保存します。保存成功は設定が記録されたことを意味するのみで、実際の利用可否は後続の API 呼び出しと同期ログで確認します。 スクリーンショット：未着手（VISTA 設定ページ全体の設定イメージ）。 ### KASIKA-LINK-01 KASIKA 機能未有効化 運営后台の総スイッチが無効の場合、設定ページには入場できますが、保存済みの値とシステム生成値はすべて空欄で表示されます。保存を送信するとブロックされ、営業担当者に KASIKA 機能の有効化を依頼するよう案内されます。 ### KASIKA-LINK-02 VISTA サーバー IP アドレス この 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 桁のみ表示され、平文での表示やコピーはできません。 スクリーンショット： - 会社アクセスキー：`../../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 の応答と同期ログで確認します。 スクリーンショット： - 顧客インポート 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` は、VISTA が書き戻す入口 URL とアクセスパスワード関連値を受け取るための KASIKA カスタム項目名です。実際の URL や実際のパスワードではなく、KASIKA 側で完全に一致する名称で作成する必要があります。 スクリーンショット：未着手（KASIKA カスタム項目作成ページ）。 ### KASIKA-LINK-06 VISTA プロジェクト入口 URL この 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-LINK-08 PID PID はアクセス送信、閲覧履歴、コンバージョン関連機能に使用し、KASIKA 顧客 API の認証には使用しません。保存時には利用可能性を検証せず、後続の送信結果またはコンバージョン結果で確認します。 ### KASIKA-LINK-09 VISTA アクセスパスワード設定 このスイッチは、新規 VISTA 顧客権限作成時にアクセスパスワードを要求するかどうかを制御し、デフォルトは有効です。無効にするとアクセスセキュリティが低下するため、再確認が必要です。 ### KASIKA-LINK-10 customer_status 自動更新 有効時は、初回紐付け後の `customer_status` の変化が同名の VISTA タグに同期され、権限更新がトリガーされます。無効時は状態の保存と表示のみ行い、タグや権限は能動的に変更しません。初回紐付け時のタグ初期化は 1 回のみ実行されます。 ### KASIKA-LINK-11 保存、編集、マスク すべての編集項目は必須であり、保存後は読み取り専用になります。「編集」をクリックするとフィールドがクリアされ、完全な値を再入力する必要があります。マスク対象は 4 つの API KEY のみで、末尾 4 桁のみ表示し、平文での表示とコピーは禁止します。 ### KASIKA-LINK-12 同期ログとトラブル確認 保存成功は連携成功を意味しません。実際の結果は同期ログと 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`