> ## 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.

# Clay 連携

> Clay と連携してセッションデータを自動同期する方法

セッションデータを [Clay](https://www.clay.com) テーブルに自動送信します。セッション終了時に、訪問者のメールアドレスやセッション内容を Webhook 経由で Clay テーブルに追加します。

## 前提条件

* Clay アカウント

## Clay 側の設定

### Webhook ソースの作成

1. Clay で対象のテーブルを開く
2. **+ Add** をクリックし、「Webhooks」を検索
3. **Monitor webhook** を選択
4. 表示される **Webhook URL** をコピー

<Info>
  認証トークンを設定する場合は、表示時に必ずコピーしてください（一度しか表示されません）。
</Info>

## Turnint ダッシュボードでの設定

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

| 項目          | 説明                     |
| ----------- | ---------------------- |
| Webhook URL | Clay テーブルの Webhook URL |

## 送信されるデータ

セッション終了時に以下の JSON が Clay テーブルに送信されます。各キーが Clay テーブルのカラムとして自動認識されます。

| フィールド         | 型              | 説明                                  |
| ------------- | -------------- | ----------------------------------- |
| `email`       | string         | セッション中に取得した訪問者のメールアドレス              |
| `sessionId`   | string         | セッション ID                            |
| `sessionLink` | string         | ダッシュボードのセッション詳細リンク                  |
| `agentId`     | string         | エージェント ID                           |
| `workspaceId` | string         | ワークスペース ID                          |
| `summary`     | string \| null | セッションの要約                            |
| `userContext` | object         | セッションに渡されたユーザーコンテキスト                |
| `messages`    | array          | セッション中のメッセージ一覧（`role` と `text` を含む） |
| `timestamp`   | string         | 送信日時（ISO 8601 形式）                   |

<Info>
  メールアドレスがセッションコンテキストに含まれない場合、データは送信されません。
</Info>