# 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 | 説明最適化 | 設定前の確認項目を絞り込み、全量同期、同期フォールバック、および2種類のメール送信の固定境界を明確化 | 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` の2つの受入フィールドのみに書き戻すことを明確化。他のVISTA情報はKASIKAに書き戻さない | AI、ユーザー確認 |
| 2026-08-04 | V0.20 | 重大な要件変更 | KASIKA設定章を書き直し、顧客エクスポート／インポート設定、2つの受入フィールド、および2種類のメールの設定境界を補完 | 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共通設定、ユーザー秘密鍵、エクスポート/インポート設定ID、カスタムフィールド、自動返信ページのスクリーンショットを再利用；画像はKASIKA公式オンラインアドレスを統一参照し、ローカルコピーは保存しない | AI、KASIKA公式ヘルプ資料の再確認、ユーザー確認 |
| 2026-08-12 | V0.24 | 説明最適化 | 本マニュアルと『12-第2期テストケースと実行指導マニュアル』の読書順序と役割分担を明確化：本マニュアルは業務理解と運用境界を担当し、12は完全なテスト操作、判定、異常引き継ぎを担当 | RENOなどの非専門テスター向け。 |
| 2026-08-16 | V0.25 | 説明最適化 | 11、12、13の読書分担を調整：11は業務理解、12はテスト範囲とトレーサビリティ、13はRENOのステップバイステップ操作を担当；初回アクセス招待リンクはKASIKAが実際の送信時に顧客番号を自動付加することを明確化し、今期はVISTAURL、VISTAPWDの2つのKASIKA引き受けフィールドのみを使用することを明確化 | 非専門テスター向けの実行準備。 |
## テスター向け閲覧と実行ナビゲーション
本マニュアルは完全なテストケースではありません。製品要件を読んでいない運用担当者が「なぜ同期されるのか、なぜ2種類のメールが送信されるのか、なぜ顧客によって表示内容が異なるのか」を理解するのに役立ちます。実際のテスト前にまず『12-第2期テスト範囲・トレーサビリティ一覧（日本語版）』を読み、その後『13-RENOテスト実行手順書（日本語版）』に従って段階的に操作し、結果を記録して異常を引き継ぎます。
| 順序 | RENOが行うべきこと | 閲覧・実行資料 | 完了基準 |
| --- | --- | --- | --- |
| 1 | まず連携の業務ロジック、双方の役割分担、2種類のメール、顧客状態とコンテンツ権限の関係を理解する。 | 本マニュアルの第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 連携について
本マニュアルは、運営担当者が以下の2つのことを行うための支援を目的としています。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 を入力する；2 つの運用スイッチを設定する；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 の
2 つのカスタムフィールドを作成
顧客エクスポート/インポート設定を作成し
settingID を取得
VISTA 管理者に渡す"]
E --> F["6. KASIKA 管理者
バインド完了通知テンプレートを作成し
自動返信ID を取得
（自発的な招待プランが必要な場合は、
初回エントリー招待メールも同時に作成）
VISTA 管理者に渡す"]
F --> G["7. VISTA 管理者
2 つの 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つの鍵は2つのグループに分かれており、2つの異なるメニュー位置から取得します：
| 鍵の名称 | 取得場所 | 形式 | 操作の要点 |
| --- | --- | --- | --- |
| 会社アクセスキー | 基本情報設定 → API設定 → API共通設定 | 32桁の半角英数字 | ページに直接表示され、そのままコピー可能 |
| 会社シークレットキー | 基本情報設定 → API設定 → API共通設定 | 32桁の半角英数字 | 目のアイコンをクリックし、現在ログイン中のユーザーパスワードを入力すると表示され、コピー後すぐに保存 |
| ユーザーアクセスキー | ページ上部の"アカウント設定"→ API設定 | 32桁の半角英数字 | 未作成の場合は、"アクセスキー作成"ボタンをクリックして生成 |
| ユーザーシークレットキー | ページ上部の"アカウント設定"→ API設定 | 32桁の半角英数字 | 目のアイコンをクリックし、現在ログイン中のユーザーパスワードを入力すると表示され、コピー後すぐに保存 |
操作手順：
1. 「**基本情報設定 → API設定 → API共通設定**」に入り、**会社アクセスキー**（ページに直接表示）をコピーします。
2. 同じページで目のアイコン  をクリックし、現在ログイン中のユーザーパスワードを入力して、**会社シークレットキー**をコピーします。
3. KASIKAページ上部のユーザー名をクリックし、「**アカウント設定 → API設定**」に入ります。
4. ユーザーキーがまだ作成されていない場合は、「**アクセスキー作成**」ボタンをクリックして生成します。
5. **ユーザーアクセスキー**（ページに直接表示）をコピーします。
6. 目のアイコンをクリックし、パスワードを入力後、**ユーザーシークレットキー**をコピーします。
*図2-2：アカウント設定ページのユーザーアクセスキーとユーザーシークレットキー。画像内のキーは隠されています。会社のキーの場所は図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で、テキストタイプのカスタムフィールドを2つ作成し、HOMEVISTAから書き戻される訪問情報を受け取ります。
「**顧客管理 → 設定 → 顧客属性設定**」に移動し、カスタムフィールドを2つ新規追加します。フィールド名は、HOMEVISTA設定ページに表示される名前と**完全に一致**させる必要があります（大文字・小文字を区別）：
| フィールド名 | フィールドタイプ | 受け取る内容 | 使用ルール |
| --- | --- | --- | --- |
| `VISTAURL` | テキスト（文字列型） | 顧客のVISTAアクセスリンク | 初回バインド成功後に書き込まれ、形式は `https://{domain}.homevista.jp/...` |
| `VISTAPWD` | テキスト（文字列型） | 顧客のVISTA初回アクセスパスワード | プロジェクトでアクセスパスワードが有効な場合のみ書き込み・使用されます |
今回のKASIKA連携では、上記の2つの引き継ぎフィールドのみ必要です。`VISTABINDSTATE` は今回の要件で作成・書き戻しが必要なフィールドではありません。バインド状態をKASIKAに表示したいからといって、独自にフィールドを追加してマッピングしないでください。未定義のフィールドを連携結果として扱わないようにしてください。
> 注意：フィールド名は、VISTA設定ページに読み取り専用で表示される `VISTAURL`、`VISTAPWD` と完全に一致している必要があります。まずVISTA管理者が設定ページからこの2つのフィールド名をコピーするのを待ってから作成してください。名前が一致しない場合、VISTAはKASIKAにアクセス情報を書き戻すことができません。
*図2-4：顧客属性設定ページ。フィールド名を順に入力し、文字列タイプを選択してから「追加」をクリックします。*
#### 2.4.2 顧客インポート設定の作成
「**基本情報設定 → API設定 → 顧客インポートAPI**」に移動し、「新規」ボタンをクリックして、HOMEVISTA連携用に専用の設定を1つ新規作成します：
1. **顧客識別フィールドの設定**：「KASIKA顧客番号」を顧客識別のキーとして選択します。
2. **書き込み先の設定**：カスタムフィールドマッピングで、書き込み先を `VISTAURL` と `VISTAPWD` に設定します。
3. 保存後、インポート `settingID` を記録し、HOMEVISTA管理者に渡します。
書き込み先**は必ず** `VISTAURL` と `VISTAPWD` のみを選択し、他の顧客フィールドはマッピングしないこと。HOMEVISTA はこれらの2つの受け入れフィールドにのみ情報を書き込みます。VISTA 顧客番号、バインド状態、初回訪問完了時刻は KASIKA には書き込まれません。
*図 2-5：顧客インポート API 設定一覧の settingID。画像内の ID は隠されています。*
> 【スクリーンショット追加予定】顧客インポート API 新規作成／編集ページにおける顧客識別フィールドと `VISTAURL`、`VISTAPWD` の書き込み先マッピング領域。既存の公式ヘルプ資料では settingID 一覧のスクリーンショットのみ提供されており、フィールドマッピング画面の代わりにはなりません。
### 2.5 2種類のメールを区別して設定する
2種類のメールの送信タイミングと用途は異なるため、同じテンプレートを共用することはできません。バインド完了通知は連携に必要な設定です。初回エントリー招待メールは、プロジェクトが「顧客の自発的なバインドを招待する」方式を採用する場合にのみ設定されます。
#### 2.5.1 初回エントリー招待メール
このメールは KASIKA の運用ルールによって送信され、顧客を初めて VISTA に招待するために使用されます。送信対象、送信時間、トリガー条件はすべて KASIKA 側で決定され、VISTA のバインド完了通知とは関係ありません。
テンプレート内のリンクは、HOMEVISTA が提供する**プロジェクトエントリー基本URL**のみを使用してください。KASIKA が実際に顧客にこのメールを送信する際、自動的にリンクにその顧客の `kasikacid` を付与します。運営担当者やテスト担当者は、このIDを手動で記入する必要はなく、また記入すべきではありません。
```text
テンプレートに記入：https://{プロジェクトドメイン}/kasika-entry
```
顧客が実際に受け取るもの：https://{プロジェクトドメイン}/kasika-entry?kasikacid={KASIKAが自動付与する現在の顧客番号}
```
テスト用の顧客番号をテンプレートに固定で書き込まないでください。また、テスト担当者にリンクパラメータを編集させる必要もありません。正式に使用する前に、テスト顧客へ実際のメールを1通送信し、その中のリンクをクリックして、正しいプロジェクトのエントリページが開き、その顧客の情報が表示されることを確認してください。
#### 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が登録されている。
- [ ] 4つの認証情報が取得され、連携アカウントが有効に保たれている。
- [ ] 顧客エクスポート設定がプロジェクト内の取得可能な全顧客をカバーし、必要な資料が揃い、エクスポート `settingID` が提供されている。
- [ ] `VISTAURL`、`VISTAPWD` という2つのフィールド名と型が正しい。
- [ ] 顧客インポート設定は上記2つのフィールドのみを受け持ち、インポート `settingID` は提供済みである。
- [ ] バインド完了通知テンプレートは作成済みで、`自動返信ID` は提供済みである。なお、自発的な招待方式を採用する場合、初回入口の招待メールは別途設定済みである。
- [ ] PIDと顧客ステータスの命名は確認済みである。
---
## 3. HOMEVISTA で連携を開通する
プロジェクト管理者のみが「**プロジェクト設定 → KASIKA 連携設定管理**」に入ることができます。営業担当者および営業マネージャーは、管理者に代わってこの設定を保存すべきではありません。
### 3.1 順番に設定を完了する
1. プロジェクトでKASIKA機能が有効になっていることを確認する：「プロジェクト設定 → KASIKA連携設定管理」に入り、ページにフォームが正常に表示される場合（入力ボックスやコピーボタンなどがある場合）、有効になっていることを意味します。**ページのすべてのフィールドが空白で表示される場合**（入力ボックスや表示値がない場合）、現在のプロジェクトのKASIKA連携のメインスイッチがまだ有効になっていないことを意味します。営業担当者に連絡して有効化した後、ページを更新する必要があります。
2. ページで「VISTAサーバーIPアドレス」をコピーし、KASIKA管理者に許可リストに登録してもらいます。
3. KASIKA管理者から提供されたPIDを入力し、4つの連携認証情報をそれぞれ4つの独立した入力ボックスに入力します。さらに2つのsettingIDと`自動返信ID`を入力します。
4. このページから`VISTAURL`と`VISTAPWD`のフィールド名をコピーし、KASIKA管理者に渡して対応するカスタムフィールドを作成してもらいます。
5. 自発的招待スキームを採用する場合は、「VISTAプロジェクト入口URL」をコピーし、KASIKA管理者に初回入口招待メールテンプレートに配置してもらいます。
6. 2つの運用スイッチを選択して保存します。
### 3.2 HOMEVISTA 設定項目の対照表
| HOMEVISTA 設定項目 | 入力内容 | 運用担当者が確認すべきこと |
| --- | --- | --- |
| PID | KASIKA管理者が提供するPID | 正しいプロジェクトのPIDを取得していること。 |
| 4項目の連携認証情報 | KASIKA管理者が提供する4つの完全な文字列をそれぞれ入力 | 4つの入力欄すべてに入力すること。保存後は各項目の末尾のわずかな文字しか表示されない。 |
| 一括エクスポート／インポート用settingID | KASIKA管理者が提供する番号 | 両方の項目が入力されていること。これらは4項目の認証情報の代わりにはならない。 |
| バインド完了通知 `自動返信ID` | KASIKAバインド完了通知テンプレートの番号 | 正しく、有効なバインド完了通知テンプレートを指していること。初回エントリーの招待テンプレートではないこと。 |
| `VISTAURL`／`VISTAPWD` | システムが読み取り専用で表示し、KASIKA管理者にコピーして渡す | これはフィールド名であり、実際のリンクやパスワードではない。 |
### 3.3 2つの運用スイッチの選び方
| スイッチ | 推奨 | 有効時 | 無効時 |
| --- | --- | --- | --- |
| VISTAアクセスパスワードの必要性 | デフォルトで有効 | 新規顧客がメール確認後にパスワードを設定；同期フォールバック時に初期パスワードを生成 | 顧客はメール確認が引き続き必要だが、パスワード設定は不要；アクセス安全性が低下 |
| `customer_status` ステータス権限の自動更新 | デフォルトで有効 | 顧客のその後のステータス変更時に、同名タグとコンテンツ権限を自動更新 | 新しいステータスのみ記録し、タグやコンテンツ権限は自動変更しない |
注意：「ステータス権限の自動更新」を無効にしても、すでに付与された権限は取り消されません。また、顧客が初回バインド時にその時点のステータスに基づいて計算された初期権限にも影響しません。再度有効にした後は、その後の同期結果にのみ影響し、過去の全顧客を自動的に再計算することはありません。
### 3.4 保存後の正しい確認方法
保存が成功したのは「データが記録された」だけで、「連携がすでに利用可能になった」わけではありません。第4章、第5章を完了した後、テスト用の顧客を使ってメール、紐付け、コンテンツ表示、同期チェックを一通り実行してください。
連携の認可情報のいずれかを変更する必要がある場合は、その項目の編集状態に入り、その項目の完全な内容を再入力してください。変更していない他の認可情報を再入力する必要はありません。
> 【画像】HOMEVISTA KASIKA 連携設定ページ：入力エリア、コピーエリア、2つの運用スイッチ、同期ログの入り口。
---
## 4. 顧客による自主紐付けの入口を設定する
アクティブバインドは、相談・予約・指名招待に最も適した方法です。顧客がKASIKAのメールからVISTAに入り、KASIKAに登録したメールアドレスを入力すると、システムが確認した上で両者の関係を構築します。
### 4.1 リリース前の設定手順
1. HOMEVISTAで第3章の連携設定を完了します。
2. KASIKAの初回入り口招待メールテンプレートにVISTAプロジェクト入口の基本URLを挿入します。テスト顧客に実際に送信し、KASIKAが自動的に `kasikacid` を付与することを確認します。
3. VISTAに第5章で必要なステータスタグと権限テンプレートを作成します。
4. 未バインドのテスト顧客1名と、すでにVISTAに同じメールアドレスの情報が存在するテスト顧客1名を準備します。
5. 「新規顧客作成」「既存VISTA顧客のバインド」「メールアドレス入力エラー」の3つのケースをそれぞれテストします。
### 4.2 顧客が実際に経験すること
| 顧客の状況 | システムの処理 | 運営担当者が知っておくべきこと |
| --- | --- | --- |
| 既に連携済み、かつメールアドレスが一致 | そのままVISTAに入り、パスワードを再設定しない | 連携完了通知は重複して送信されず、アカウントも重複作成されません。 |
| 未連携だが、VISTAに同じメールアドレスの顧客が存在 | メール確認後に連携を確立し、元のパスワードは再設定しない | システムが自動的にチェックします。顧客が正常に入場できた場合は対応不要です。ページに連携不能の表示が出た場合は、第8章に従って記録し、管理者に渡します。 |
| 未連携で、VISTAに同じメールアドレスの顧客が存在しない | VISTA顧客を作成。プロジェクトがパスワードを要求する場合は、顧客にパスワード設定を依頼 | 初回連携後、顧客の状態に応じて初期コンテンツ権限を設定します。 |
| メールアドレスが一致しない、他の顧客と連携済み、または異常が存在 | 自動的に上書きせず、顧客に後でスタッフへ連絡するよう案内 | 運営担当者は顧客と発生時間を記録し、VISTA管理者が同期ログを確認して対応します。 |
### 4.3 初回紐付け後にシステムが行う処理
初回紐付けが成功した後、システムはKASIKA顧客番号、メールアドレス、顧客ステータスを保存します。ステータスに応じて同名タグの設定を試み、顧客が閲覧できるコンテンツを計算し、KASIKAの`VISTAURL`にアクセスリンクを書き戻し、プロジェクトでアクセスパスワードが有効な場合は`VISTAPWD`に初回アクセスパスワードを書き戻します。アクセス方法が準備できたら、HOMEVISTAは設定済みの`自動返信ID`を使用して紐付け完了通知メールをトリガーします。VISTA顧客番号、紐付けステータス、初回アクセス完了時間はHOMEVISTAにのみ保持され、KASIKAには書き戻されません。いずれかの書き戻しやメール送信が失敗しても、完了済みのアカウントと紐付けは取り消されず、確認待ちの記録が残るだけです。既に紐付け済みの顧客が再度アクセスしても、紐付け完了通知は重複送信されません。
> 【図解】顧客がメールをクリック → メールアドレスを入力 → パスワードを設定（必要な場合）→ コンテンツに入る、の4ステップ図。
---
## 5. タグ、コンテンツ権限、顧客ステータスの連動設定
この章では「段階の異なる顧客が何を見られるか」を決定します。まずマッピングテーブルを作成し、その後システム設定に進みます。個々の顧客ページで直接処理しないでください。
### 5.1 先に状態—タグ—コンテンツのマッピングテーブルを完成させる
| KASIKA 顧客状態の例 | VISTA タグ（名前は完全に一致している必要があります） | タグ権限テンプレート内のコンテンツ例 |
| --- | --- | --- |
| 資料請求 | 資料請求 | プロジェクト紹介、基本資料 |
| 来場予約 | 来場予約 | 間取り、予約説明 |
| 商談中 | 商談中 | 価格資料、専用説明 |
もしある状態で何も開放すべき内容がない場合も、その旨を明確にプロジェクトルールに記載してください。状態が空、同名タグがない、またはタグにテンプレートがない場合でも、顧客はバインドできますが、新規コンテンツの権限がない可能性があります。
### 5.2 VISTAでタグと権限テンプレートを設定する
タグと権限テンプレートは2層構成です。以下の順序で操作してください：
**ステップ1：タグ本体の作成**
VISTA管理者が「**タグ管理**」ページ（左側のナビゲーションメニュー）に入り、KASIKAの顧客状態名と完全に一致するタグを新規作成します。例えば、KASIKAに「資料請求」「来場予約」「商談中」の3つの状態がある場合、タグ管理ページに同じ名前のタグを3つ作成する必要があります。
- タグ名はKASIKA顧客ステータス名と**一字一句一致**している必要があります。一致しない場合、連携時にマッチングできません。
- タグ作成後、タグリストで各タグの名前、利用顧客数などの情報を確認できます。
- タグ自体は何のコンテンツにも紐付いておらず、コンテンツは次のステップの権限テンプレートによって決定されます。
> 注意：タグ管理ページはタグ自体（新規作成、編集、削除、無効化）を管理するページです。KASIKAステータスと同名のタグを改名または削除する前に、必ず連携への影響を確認してください——タグを削除すると、その権限テンプレートも同時に削除され、全顧客とそのタグとの関係も削除されます。
**ステップ2：タグに権限テンプレートを設定する**
「タグ管理」ページのタグリストで、設定が必要なタグの行を見つけ、「**権限編集**」ボタンをクリックし、**タグ権限テンプレート設定ページ**に入ります。
1. 入力テンプレート名（必須、30文字以内）。
2. その顧客カテゴリが閲覧できるコンテンツ（間取り図、モデルルーム、外観、資料集、ナビゲーションメニューなど）を少なくとも1つ選択すること。
3. テンプレートは、管理者が共有を承認したコンテンツのみ選択可能。共有不可とマークされたコンテンツは選択できない。
4. 保存前に、ページに表示される影響を受ける顧客数と今回選択したコンテンツ範囲を確認し、保存を確定する。
5. テスト顧客を使用して、そのラベルで実際に表示されるコンテンツを確認する。
> ヒント：ラベル権限テンプレート設定ページは独立したページで、上部で編集対象のラベルを切り替えることができ、複数のラベルのテンプレートを連続して編集するのに便利です。
**操作原則：**
- 各タグには最大で1つの権限テンプレートを設定できます。タグにテンプレートを設定しないことも可能です（その場合、そのタグは追加のコンテンツ権限を発生させません）。
- テンプレートを保存すると、直ちにそのタグを持つすべての顧客に影響します。「適用」操作を再度実行する必要はありません。
- 同じ顧客が複数のタグを持つ場合、閲覧可能なコンテンツは各タグのテンプレート内容を統合したものになります。
- 「個人権限の追加」は、個別の顧客が閲覧できるコンテンツを増やすことだけができ、タグテンプレートがすでに付与したコンテンツを取り消すことはできません。
### 5.3 ステータス自動更新を有効にした後の結果
第3章の「ステータス権限の自動更新」が有効な場合、HOMEVISTAは以降の同期で顧客のステータス変更を検出すると、新しいステータスと同じ名前のタグを追加し、前のステータスに対応する同じ名前のタグを削除し、その後コンテンツ権限を再計算します。この操作は、顧客に付与された他のタグや個人権限の追加には影響しません。
このスイッチが無効な場合、システムは新しいステータスを記録しますが、タグや権限を自動的に変更しません。手動で処理する必要がある場合は、その顧客の詳細の「権限／編集」ページに移動し、VISTAタグを調整して保存します。この操作はVISTAのみを変更し、KASIKAの顧客ステータスは変更しません。顧客タイプ全体のコンテンツ範囲はタグ権限テンプレートを調整すべきであり、顧客ごとに個別に設定しないでください。
**特に状態が空または未マッピングの場合の注意：**自動更新を有効にした後、顧客状態が変化しても VISTA に同名のタグがない場合、システムは新しいタグを自動作成せず、前の状態に対応するタグは引き続き削除されます。そのため、この部分の顧客は元の状態によるコンテンツを失う可能性がありますが、その他のタグや個人権限の追加は元のルールに従って保持されます。新しい状態に同名のタグがあっても、新しいテンプレートに低段階のコンテンツが含まれていない場合、顧客は以前に閲覧できた低段階のコンテンツを失うことになります。KASIKA 顧客状態を新規追加、改名、または停止する前に、必ず VISTA の同名タグと権限テンプレートを確認し、高段階が低段階のコンテンツを保持すべきかを決定してください。
> 【図版】KASIKA 顧客状態 → VISTA 同名タグ → 権限テンプレート → 顧客が閲覧できるコンテンツの関係図。
---
## 6. リリース前の最小確認と日常チェック
> **完全なテストとの関係：**本章はリリース後の運用担当者が使用する最小確認および日常チェックリストであり、第2期の完全なテスト手順ではありません。テスターは本章のすべてのチェック項目が完了しただけで第2期テストの完了を宣言してはなりません。まず『12-第2期テスト範囲・トレーサビリティ一覧（日本語版）』で範囲を確認し、次に『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 1名の顧客の連携状態を確認する
顧客が連携済みか確認する必要がある場合、VISTA管理者は「**顧客詳細 → 概要**」を開きます。ここでKASIKA顧客番号、メールアドレス、顧客ステータス、関連ステータス、直近の同期結果を確認できます。情報の不一致や同期失敗を見つけた場合は、同期ログで詳細な記録を確認します。
### 6.3 日常チェックのペース
| タイミング | 運営担当者が確認する内容 | 問題発見後の対応 |
| --- | --- | --- |
| 新プロジェクト稼働後 | メール、紐付け、コンテンツ権限が完全に通っているか | 正式な顧客グループへの送信を一時停止し、まずテスト顧客で修正します。 |
| 毎週 | VISTA管理者が「プロジェクト設定 → KASIKA連携設定管理 → 同期ログ」で失敗、紐付け衝突、ステータスが空、またはステータスに同名タグがないレコードがないかを確認 | 管理者が設定を照合します。他の運営担当者に完全なログ権限がない場合は、プロジェクトの取り決めに従って管理者に確認を依頼します。異常な紐付けは自己判断で上書きしないでください。 |
| 即時再確認が必要な場合 | VISTA管理者または営業マネージャーが「顧客リスト」で「全量同期チェック」をクリックし、完了後に結果サマリーを確認します。完全なログが必要な場合は、VISTA管理者が確認します | この操作は今回取得可能な全KASIKA顧客をチェックし、現在チェックしている項目だけではありません。タスク開始後はキャンセルできません。ページを閉じても停止しません。処理中は繰り返しクリックしないでください。 |
| タグやテンプレートを変更する前 | 影響を受ける顧客は誰か、共有を続けるべきでないコンテンツがあるか | 影響リストを先に確認し、その後テンプレートを保存します。
| KASIKAメール改修前 | 初回入口招待メールの入口リンクと顧客番号が正しいか；バインド完了通知メールのアクセスリンクと該当する場合のパスワードフィールドが正しいか | 2種類のメールをそれぞれテスト顧客で検証する。 |
### 6.4 顧客情報と異常処理の境界
- 顧客情報はKASIKAからVISTAへ同期される。VISTAで顧客を単独追加、インポート、または修正しても、KASIKAで自動的に顧客が作成または更新されることはない；KASIKAの顧客情報を調整する必要がある場合は、KASIKA側で処理すべきである。
- VISTAで顧客を削除しても、KASIKAの顧客は削除されず、KASIKAに書き込まれたVISTAリンクやパスワードもクリアされない。
- 後続の同期で同じKASIKA顧客を再度取得した場合、システムはその顧客を未バインド顧客として再マッチングまたは新規VISTA顧客を作成するが、削除済みの元VISTA顧客に復元されることはない；重複顧客や復元レコードが発生した場合は、管理者に処理を委ねる。
- 顧客が後日VISTAでパスワードを変更しても、KASIKAの`VISTAPWD`は更新されない。このフィールドは初回アクセス時に使用したパスワードのみを保存しており、顧客の現在のパスワード判断の根拠としては使用すべきではない。
- システムは現在、フロント画面に「バインド解除」「再バインド」または「バインド変更」ボタンを提供していない。
- メールアドレス不一致、顧客の誤紐付け、顧客削除後の復元など複雑なケースでは、運営担当者は現象と発生時間を記録し、VISTA管理者がログを保持してテクニカルサポートに処理を依頼してください。フロントで繰り返し紐付けを試みないでください。
---
## 7. 運用連携の設計と利用方法
本章は「完全な運営方案」と「重要な連携ポイント」で構成されています。方案を選択する際は、まず目標と顧客を確認し、次に該当する節の前提条件とチェックポイントに従って実行してください。
### 7.1 運営方案：固定リンクによる公開コンテンツのプロモーション
| 項目 | 説明 |
| --- | --- |
| 適用対象 | 広告・SMS・一斉メールにおいて、より多くの人を公開紹介やイベント情報の閲覧へ迅速に誘導すること。 |
| 適用顧客 | 未登録で、本人確認を必要としない潜在顧客。 |
| 前提設定 | 本施策は、プロジェクトが「公開コンテンツの固定リンク」を提供している場合にのみ適用されます。VISTA 管理者が**公開済みとして公開**されたコンテンツの公開・共有ページから固定リンクをコピーし、未ログインブラウザでそのコンテンツがアカウントなしで閲覧できることを確認してください。プロジェクトがまだ公開コンテンツを提供していない場合は、本施策は使用しません。内部または限定資料には固定リンクでのプロモーションを使用してはなりません。 |
| 操作方法 | KASIKA の通常のマーケティングメールやその他のプロモーションチャネルに固定リンクを配置します。 |
| 顧客体験 | クリック後、直接公開コンテンツを閲覧します。 |
| チェックポイント | 未ログインブラウザでリンク・ページ・公開コンテンツがすべて正しいことを確認します。 |
| 注意事項 | これはアカウント連携ではありません：KASIKA の特定顧客を識別できず、連携を確立できず、`customer_status` に基づいてコンテンツを自動制御することも、個人のアクセス情報を書き戻すこともありません。 |
### 7.2 運用方案：相談・予約後、顧客に自発的なVISTA連携を促す
| 項目 | 説明 |
| --- | --- |
| 適用目標 | 相談・予約・登録済みの顧客を専用コンテンツへ誘導する。 |
| 適用顧客 | KASIKA にメールアドレスと顧客番号が登録されている顧客。 |
| 前提設定 | 第2章～第5章を完了する。KASIKA の初回入口招待メールテンプレートに、VISTA プロジェクト入口のベースURLを設定する。顧客番号は、KASIKA が実際の送信時に自動付与する。 |
| 操作方法 | このテンプレートを、相談・予約・登録後の自動返信ルールに紐付ける。顧客がクリック後、第4章に従って連携を完了する。 |
| 顧客体験 | 顧客は登録済みメールアドレスを入力する。初回新規作成時、プロジェクト設定に応じてパスワード作成の有無が決まる。 |
| チェックポイント | 顧客が連携済みであること、リンクが書き戻されていること、ステータスに対応するコンテンツが正しいことを確認する。 |
| 注意事項 | メールアドレスが一致しない場合や紐付け競合が発生する場合は自動で上書きされず、運営担当者がフォローアップする必要があります。 |
### 7.3 連携プロセス：顧客が自主的に進入しない場合の自動同期
| 項目 | 説明 |
| --- | --- |
| プロセスの目的 | 最初の入り口から自主的に紐付けしなかった顧客に対して、VISTA アカウント、紐付け関係、アクセス通知を補完します。 |
| 処理対象 | 本プロジェクト内で KASIKA が取得できる全顧客を対象とします。既に紐付け済みの顧客も、資料とステータスの更新に引き続き参加します。 |
| 前提設定 | 4 つの連携認証情報、2 つの 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 複数案を同時に使用する際のルール
推奨される組み合わせは、固定リンクで一般的なプロモーションを行い、専用コンテンツを必要とする相談・予約顧客にはアクティブ紐付けを使用し、自主的に入会していない顧客にはシステムが同期して紐付けとアクセス通知を補完し、紐付け済み顧客には状態連動で継続的にセグメント化し、さらに顧客の閲覧履歴に基づいてその後のフォローアップを手配する、というものです。
混乱を避けるため、以下の3つのルールを守ってください：
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項目：会社アクセスキー、会社シークレットキー、ユーザーアクセスキー、ユーザーシークレットキー |
| 会社アクセスキー / 会社シークレットキー | 「基本情報設定 → API設定 → API共通設定」から取得する2項目の鍵、32桁の半角英数字 |
| ユーザーアクセスキー / ユーザーシークレットキー | 「アカウント設定 → API設定」から取得する2項目の鍵、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`（フィールドレベルヘルプの出典；本ガイドではこの文書を変更していない）