> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timothe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho CRM 連携

> Zoho CRM と連携してコンタクトやセッションデータを同期する方法

セッションデータを [Zoho CRM](https://www.zoho.com/jp/crm/) に自動同期します。セッション終了時に、訪問者のメールアドレスをもとにコンタクトを検索・作成し、セッション内容をノートとして記録します。

## 前提条件

* Zoho CRM アカウント

## 認証情報の作成

1. [Zoho API Console](https://api-console.zoho.com/) を開く
2. **Self Client** を作成（または既存のものを選択）
3. **Client ID** と **Client Secret** をコピー
4. **Generate Code** タブで以下のスコープを指定してコードを生成:
   * `ZohoCRM.modules.contacts.READ` — コンタクトの検索
   * `ZohoCRM.modules.contacts.CREATE` — コンタクトの作成
   * `ZohoCRM.modules.notes.CREATE` — ノートの作成
5. 生成されたコードを使って Refresh Token を取得

## 設定

ダッシュボードの **インテグレーション** から新規作成し、タイプ「Zoho CRM」を選択します。

| 項目              | 説明                                                                         |
| --------------- | -------------------------------------------------------------------------- |
| Client ID       | Zoho API Console の Client ID                                               |
| Client Secret   | Zoho API Console の Client Secret                                           |
| Refresh Token   | 生成した Refresh Token                                                         |
| Accounts Domain | Zoho のアカウントドメイン（例: `https://accounts.zoho.com`、`https://accounts.zoho.jp`） |

## 同期される内容

* **コンタクト** — セッション中に取得したメールアドレスで Zoho CRM のコンタクトを検索し、存在しなければ新規作成
* **ノート** — セッションの内容をコンタクトに紐づくノートとして作成