# immedioイベント（ブラウザイベント連携）

## immedioイベントとは

immedioイベントとは、商談予約が完了したタイミングでブラウザイベントを発火する機能です。immedio Boxなどの外部サービスや自社のスクリプトから、このイベントをlistenして連携・計測に活用できます。

## immedioイベントでできること

| イベント名                             | 発火タイミング          | detail（含まれるデータ）                       |
| --------------------------------- | ---------------- | ------------------------------------- |
| immedio-event:on-meeting-reserved | 商談予約が完了したとき（成功時） | sentData（フォーム送信データ）、reserveTime（面談日時） |

対象となる導線：

* Web接客（URL設定、セグメント設定、フローチャート、自動追客）経由の予約完了時

## イベント仕様

### イベント名

`immedio-event:on-meeting-reserved`

### 発火タイミング

商談予約が完了したとき（成功時のみ）

### detail（イベントデータ）

| 項目          | 説明                                                             |
| ----------- | -------------------------------------------------------------- |
| sentData    | 予約フォームで送信されたデータ（オブジェクト形式）                                      |
| reserveTime | 面談の日時を表す数値（YYYYMMDDHHmm形式の数値。例：202511110930は2025年11月11日09時30分） |

## 使い方（サンプルコード）

以下のコードを、immedioタグが読み込まれているページに配置すると、予約完了イベントを受け取れます。

```javascript
// immedioが商談予約完了時に発火するイベントを受け取ります
window.addEventListener("immedio-event:on-meeting-reserved", (e) => {
  const { sentData, reserveTime } = e.detail || {};
  console.log("商談予約が完了しました", { sentData, reserveTime });
  
  // ここで外部サービス連携や計測処理を呼び出せます
  // 例：immedio Boxへのデータ送信、独自の分析ツールへの送信など
});
```

## 注意事項

* 本イベントは商談予約の「完了」時にのみ発火します。予約試行（リクエスト）段階では発火しません
* イベントを受け取るには、immedioのタグが読み込まれている必要があります
* reserveTimeは面談の日時を表す数値型で、YYYYMMDDHHmm形式（例：202511110930）で表現されます。Unix時間（エポック秒）ではありませんのでご注意ください
* sentDataの内容は、予約フォームで送信されたデータが含まれます。具体的なフィールドは、フォームマッピングやプロパティ設定によって異なります

## 関連

* [商談予約のCallback（Google Analytics等の計測）](/guides/callback.md)
  * immedioConfigのonReservationRequestコールバック機能との違い：
    * Callback機能：immedioConfigに設定するコールバック関数（主にGoogle Analytics等の計測用）
    * immedioイベント：ブラウザイベント（window）として発火されるため、外部サービスや別スクリプトで横断的にlistenできます


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.immedio.io/guides/immedio-events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.