# immedioの動作条件

## immedioの動作条件

immedioをご活用頂くには、ご利用されているとグループウェアとウェブサイトが以下の条件を満たしている必要があります。\
ここでは、immedioの動作条件について説明します。

## 用語説明

| 用語      | 説明                                                                              |
| ------- | ------------------------------------------------------------------------------- |
| メインドメイン | ウェブサイトのメインとなるドメイン。例: `example.com`                                              |
| サブドメイン  | メインドメインの前に付くドメイン。例: `go.example.com` は `example.com` のサブドメイン。                   |
| iframe  | ウェブページ内に別のウェブページを埋め込むためのHTML要素。例: `<iframe src="https://example.com"></iframe>` |

### カレンダーサービスの条件

immedioが対応するのは下記のカレンダーです。

* Googleカレンダー
* Microsoft Outlookカレンダー

#### Garoonをご利用の場合

Garoonをご利用の場合、一部挙動が異なります。

* 面談担当者（Garoonユーザー）のカレンダーには予定が登録されます。
* リード（外部参加者）には会議通知は送信されますが、カレンダーには自動登録されません。

そのため、リード側では手動で予定を登録する必要があります。

#### ❌ その他のカレンダーについて

上記以外のカレンダーには対応していません。

### ウェブサイトの条件

#### ❌ フォームとThanksページのメインドメインが異なる

フォームとThanksページのメインドメインが異なる場合、immedioをご利用いただけません。 go.immedio.ioとimmedio.ioのようにサブドメインが異なるだけの場合は問題ありません。

#### 例

NG❌: フォームのURLが `https://example.com/form` で、ThanksページのURLが `https://example2.com/thanks` の場合\
OK✅: フォームのURLが `https://example.com/form` で、ThanksページのURLが `https://example.com/thanks` の場合\
OK✅: フォームのURLが `https://example.com/form` で、ThanksページのURLが `https://go.example.com/thanks` の場合

#### フォームがiframe内に設置されている場合

iframe内にフォームが設置されている場合は、特殊な条件があります。\
まずは下記を確認します。

1. iframeを利用しているかどうか
2. iframeで参照しているsrc属性は何か

[iframeの確認方法](/guides/iframe.md)

iframeを利用していない場合は、このセクションはスキップして下さい。

**❌ iframeタグ内のsrc属性で指定されたメインドメインがサンクスページのメインドメインと異なる**

iframeタグ内のsrc属性で指定されたメインドメインがサンクスページのメインドメインと異なる場合、immedioをご利用いただけません。\
Google FormsやForm.run等のMA以外のツールでフォームを作成している場合に多いです。\
iframeではない方法でフォームを埋め込む、Thanksページのメインドメインを変更するなどをご検討下さい。

**✅ iframeタグ内でsrc属性が指定されていない　又は iframeタグ内のsrc属性で指定されたメインドメインとThanksページのメインドメインが同一**

iframeタグ内のsrc属性で指定されたメインドメインとThanksページのメインドメインが同一の場合は、immedioをご利用いただけます。\
Hubspotなどをご利用の場合、iframeであってもsrcの値が設定されていませんが、この場合も問題ありません。

**例**

NG❌: iframeのURLが `https://example.com/form` で、ThanksページのURLが `https://example2.com/thanks` の場合\
OK✅: iframeのURLが `https://example.com/form` で、ThanksページのURLが `https://example.com/thanks` の場合\
OK✅: iframeのURLが `https://example.com/form` で、ThanksページのURLが `https://go.example.com/thanks` の場合

### フォーム構造の条件

#### ❌ フォーム部分が`<form>`タグで囲われていない

フォーム部分が`<form>`タグで囲われていない場合、immedioをご利用いただけません。

OKの例:

```html
<body>
  <form>
    名前: <input type="text" name="person_name" />
    メールアドレス: <input type="text" name="email" />
  </form>
</body>
```

NGの例:

```html
<body>
  名前: <input type="text" name="person_name" />
  メールアドレス: <input type="text" name="email" />
</body>
```

#### ❌ 各`input`に対して一意に特定できる要素がない

各`input`に対して`name`属性など、一意に特定できる要素がない場合、immedioをご利用いただけません。

OKの例:

```html
<form>
  名前: <input type="text" name="person_name" />
  メールアドレス: <input type="text" name="email" />
</form>
```

NGの例:

```html
<form>
  名前: <input type="text" />
  メールアドレス: <input type="text" />
</form>
```

#### ❌ 名前とメールアドレスの入力欄がない

名前とメールアドレスの入力欄がない場合、immedioをご利用いただけません。

### 動作条件チェックリスト

導入前に以下の条件をすべて確認してください：

* [ ] フォームとサンクスページのメインドメインが同じこと
  * サブドメインが違うだけの場合はOK
* [ ] （iframeの場合で、iframeにsrc属性が指定されている場合）iframeのsrc属性に設定されているメインドメインはサンクスページのメインドメインと同じこと
  * サブドメインが違うだけの場合はOK
* [ ] フォーム部分が`<form>`タグで囲われていること
* [ ] 各`input`に対して`name`属性など、一意に特定できる要素があること
* [ ] 名前とメールアドレスの入力欄があること


---

# 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/initial-setup/requirements.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.
