> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/company-settings/integrations/zapier.md).

# Zapier連携

Zapier連携の設定方法と利用可能なイベント、ペイロード詳細について説明します。

## Zapier連携とは

Zapier連携は、immedioで発生するイベントを他のサービスに自動連携する機能です。面談予約、アンケート回答などの様々なイベントをトリガーとして、Slack通知、CRM連携、メール送信などの自動化ワークフローを構築できます。

## Zapier連携でできること

| 機能       | 説明                                |
| -------- | --------------------------------- |
| APIキーの生成 | Zapierでimmedioと連携するためのAPIキーを生成します |
| APIキーの表示 | 生成したAPIキーを表示します                   |

## API Key設定方法

1. **API Key生成**
   * 企業設定 > 外部ツール連携 > Zapier連携 を開きます
   * 「API Keyを生成」ボタンをクリックし、API Keyを生成します
2. **Zapier での設定**
   * 生成されたAPI Keyを使用して、Zapierでワークフローを作成します
   * 認証時にAPI Keyを入力してください

## 利用可能なイベント一覧

immedioでは以下のZapierトリガーが利用可能です：

| Zapierトリガー名               | トリガータイミング                   |
| ------------------------- | --------------------------- |
| New Reservation           | 面談予約が完了した時                  |
| New Questionnaire         | 面談前アンケートに回答した時              |
| New Survey                | 離脱時アンケートに回答した時              |
| New Followup Email        | フォローアップメールが送信された時           |
| New Need More Slots       | 予約枠が不足した時                   |
| New Notify Customer Info  | 顧客リサーチが完了した時                |
| New Notify Company Info   | 企業リサーチが完了した時                |
| New Cancel                | 面談がキャンセルされた時                |
| New Request Phone Call    | 電話リクエストされた時                 |
| New Form Node Answer      | フォームノードに回答した時               |
| New Checkin Questionnaire | チェックインアンケートに回答した時           |
| New AI SDR Qualify Passed | AI接客フローでクオリフィケーションノードを通過した時 |

## イベント詳細とペイロード

### New Reservation

面談予約が完了した際に送信されるイベントです。

**ペイロード例:**

```json
{
  "id": 1,
  "event_id": "string",
  "start_at": "2023-06-01T17:30:00+09:00",
  "end_at": "2023-06-01T18:30:00+09:00",
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_phone": "07011112222",
  "guest_company": "株式会社immedio",
  "video_url": "https://example.com",
  "user_email_addr": "user@example.com",
  "user_name": "Immedio Taro",
  "created_at": "2023-06-01T09:00:00Z",
  "is_owner": true,
  "form_url": "https://example.com",
  "form_name": "form",
  "reschedule_url": "https://meetings.immedio.io/reschedule?uk=55c1f1dc-f4fa-4714-bd2d-97c24133f3ad",
  "custom_items": "サンプルカスタム項目",
  "resource_id": "リソースID",
  "resource_name": "リソース名",
  "resource_type": "フローチャートルーター"
}
```

**フィールド詳細:**

| フィールド名                     | 型        | 説明                                                                                     |
| -------------------------- | -------- | -------------------------------------------------------------------------------------- |
| `id`                       | number   | ID                                                                                     |
| `event_id`                 | string   | カレンダーのID                                                                               |
| `start_at`                 | datetime | 面談開始日時                                                                                 |
| `end_at`                   | datetime | 面談終了日時                                                                                 |
| `group_name`               | string   | グループ名                                                                                  |
| `reservation_setting_name` | string   | 面談タイプ名                                                                                 |
| `guest_email`              | string   | リードのメールアドレス                                                                            |
| `guest_name`               | string   | リードの名前                                                                                 |
| `guest_phone`              | string   | リードの電話番号                                                                               |
| `guest_company`            | string   | リードの企業名                                                                                |
| `video_url`                | string   | Web会議URL                                                                               |
| `user_email_addr`          | string   | 担当者のメールアドレス                                                                            |
| `user_name`                | string   | 担当者名                                                                                   |
| `created_at`               | datetime | 作成日時                                                                                   |
| `is_owner`                 | boolean  | ユニットのオーナーか                                                                             |
| `form_url`                 | string   | 入力されたフォームのURL                                                                          |
| `form_name`                | string   | ルーター名                                                                                  |
| `reschedule_url`           | string   | リスケURL                                                                                 |
| `custom_items`             | -        | カスタム項目                                                                                 |
| `resource_id`              | string   | リソースID                                                                                 |
| `resource_name`            | string   | リソース名                                                                                  |
| `resource_type`            | string   | リソースタイプ。取りうる値: `フローチャートルーター`, `旧ルーター`, `日程調整URL`, `Account Engagement`, `Web接客`, `リスケ` |

### New Questionnaire

面談前アンケートに回答した際に送信されるイベントです。

**ペイロード例:**

```json
{
  "questionnaire_title": "当サービスに興味を持った理由を教えてください。",
  "answer_text": "商談獲得を自動化したいと考えたため。",
  "event_id": "abv30c8dodpv6v4c0nj5es1758",
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_company": "株式会社immedio",
  "form_name": "sample router",
  "reservation_setting_name": "sample reservation",
  "group_name": "sample group",
  "form_url": "https://example.com",
  "created_at": "2023-06-01T09:00:00Z",
  "guest_phone_number": "07011112222",
  "reschedule_url": "https://meetings.immedio.io/reschedule?uk=55c1f1dc-f4fa-4714-bd2d-97c24133f3ad",
  "questionnaire_answer_list": "アンケート結果：\n【質問1】\n当サービスに興味を持った理由を教えてください。\n【回答】\n商談獲得を自動化したいと考えたため。",
  "resource_id": "リソースID",
  "resource_name": "リソース名",
  "resource_type": "フローチャートルーター"
}
```

**フィールド詳細:**

| フィールド名                      | 型      | 説明                                                                                     |
| --------------------------- | ------ | -------------------------------------------------------------------------------------- |
| `questionnaire_title`       | -      | 面談前アンケートタイトル                                                                           |
| `answer_text`               | -      | 面談前アンケート回答                                                                             |
| `questionnaire_answer_list` | -      | 面談前アンケート回答リスト                                                                          |
| `event_id`                  | -      | 関連する商談ID                                                                               |
| `guest_email`               | -      | リードのメールアドレス                                                                            |
| `guest_name`                | -      | リードの名前                                                                                 |
| `guest_phone_number`        | -      | リードの電話番号                                                                               |
| `guest_company`             | -      | リードの企業名                                                                                |
| `form_name`                 | -      | ルーター名                                                                                  |
| `reservation_setting_name`  | -      | 面談タイプ名                                                                                 |
| `group_name`                | -      | グループ名                                                                                  |
| `form_url`                  | -      | 入力されたフォームのURL                                                                          |
| `created_at`                | -      | 作成日時                                                                                   |
| `reschedule_url`            | -      | リスケURL                                                                                 |
| `resource_id`               | string | リソースID                                                                                 |
| `resource_name`             | string | リソース名                                                                                  |
| `resource_type`             | string | リソースタイプ。取りうる値: `フローチャートルーター`, `旧ルーター`, `日程調整URL`, `Account Engagement`, `Web接客`, `リスケ` |

### New Survey

離脱時アンケートに回答した際に送信されるイベントです。

**ペイロード例:**

```json
{
  "survey_subject": "日程調整をされない理由を教えてください",
  "survey_selected_option_text": "価格が高い",
  "survey_answered_text": "その他の理由です",
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_phone": "07011112222",
  "guest_company": "株式会社immedio",
  "form_name": "sample router",
  "reservation_setting_name": "sample reservation",
  "group_name": "sample group",
  "form_url": "https://example.com",
  "created_at": "2023-06-01T09:00:00Z",
  "custom_items": "サンプルカスタム項目",
  "lead_detail_url": "https://console.immedio.io/leads?lid=xxx"
}
```

**フィールド詳細:**

| フィールド名                        | 型 | 説明              |
| ----------------------------- | - | --------------- |
| `survey_subject`              | - | 離脱前アンケートタイトル    |
| `survey_selected_option_text` | - | 離脱前アンケート回答（選択肢） |
| `survey_answered_text`        | - | 離脱前アンケート回答（記述）  |
| `guest_email`                 | - | リードのメールアドレス     |
| `guest_name`                  | - | リードの名前          |
| `guest_phone`                 | - | リードの電話番号        |
| `guest_company`               | - | リードの企業名         |
| `form_name`                   | - | ルーター名           |
| `reservation_setting_name`    | - | 面談タイプ名          |
| `group_name`                  | - | グループ名           |
| `form_url`                    | - | 入力されたフォームのURL   |
| `created_at`                  | - | 作成日時            |
| `custom_items`                | - | カスタム項目          |
| `lead_detail_url`             | - | リード詳細URL        |

### New Followup Email

フォローアップメールが送信された際に送信されるイベントです。

**ペイロード例:**

```json
{
  "guest_company": "株式会社immedio",
  "guest_name": "Immedio Taro",
  "guest_email": "guest@example.com",
  "guest_phone_number": "07011112222",
  "created_at": "2024-01-30T12:54:07Z",
  "lead_detail_url": "https://console.immedio.io/leads?lid=xxx"
}
```

**フィールド詳細:**

| フィールド名               | 型 | 説明          |
| -------------------- | - | ----------- |
| `guest_company`      | - | リードの企業名     |
| `guest_name`         | - | リードの名前      |
| `guest_email`        | - | リードのメールアドレス |
| `guest_phone_number` | - | リードの電話番号    |
| `created_at`         | - | 作成日時        |
| `lead_detail_url`    | - | リード詳細URL    |

### New Need More Slots

予約枠が不足した際に送信されるイベントです。

**ペイロード例:**

```json
{
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_phone_number": "07011112222",
  "guest_company": "株式会社immedio",
  "form_name": "sample router",
  "reservation_setting_name": "sample reservation",
  "group_name": "sample group",
  "form_url": "https://example.com",
  "created_at": "2023-06-01T09:00:00Z",
  "custom_items": "サンプルカスタム項目",
  "lead_detail_url": "https://console.immedio.io/leads?lid=xxx"
}
```

**フィールド詳細:**

| フィールド名                     | 型 | 説明            |
| -------------------------- | - | ------------- |
| `guest_email`              | - | リードのメールアドレス   |
| `guest_name`               | - | リードの名前        |
| `guest_phone_number`       | - | リードの電話番号      |
| `guest_company`            | - | リードの企業名       |
| `form_name`                | - | ルーター名         |
| `reservation_setting_name` | - | 面談タイプ名        |
| `group_name`               | - | グループ名         |
| `form_url`                 | - | 入力されたフォームのURL |
| `created_at`               | - | 作成日時          |
| `custom_items`             | - | カスタム項目        |
| `lead_detail_url`          | - | リード詳細URL      |

### New Notify Customer Info

顧客リサーチが完了した際に送信されるイベントです。

**ペイロード例:**

```json
{
  "guest_company": "株式会社immedio",
  "guest_name": "Immedio Taro",
  "guest_email": "guest@example.com",
  "guest_phone_number": "07011112222",
  "form_url": "https://example.com",
  "research_result": "サンプル顧客リサーチ結果",
  "created_at": "2023-06-01T09:00:00Z",
  "lead_detail_url": "https://console.immedio.io/leads?lid=xxx"
}
```

**フィールド詳細:**

| フィールド名               | 型 | 説明            |
| -------------------- | - | ------------- |
| `guest_company`      | - | リードの企業名       |
| `guest_name`         | - | リードの名前        |
| `guest_email`        | - | リードのメールアドレス   |
| `guest_phone_number` | - | リードの電話番号      |
| `form_url`           | - | 入力されたフォームのURL |
| `research_result`    | - | リサーチ結果        |
| `created_at`         | - | 作成日時          |
| `lead_detail_url`    | - | リード詳細URL      |

### New Notify Company Info

企業リサーチが完了した際に送信されるイベントです。

**ペイロード例:**

```json
{
  "guest_company": "株式会社immedio",
  "guest_name": "Immedio Taro",
  "guest_email": "guest@example.com",
  "guest_phone_number": "07011112222",
  "form_url": "https://example.com",
  "research_result": "サンプル企業リサーチ結果",
  "created_at": "2023-06-01T09:00:00Z",
  "lead_detail_url": "https://console.immedio.io/leads?lid=xxx"
}
```

**フィールド詳細:**

| フィールド名               | 型 | 説明            |
| -------------------- | - | ------------- |
| `guest_company`      | - | リードの企業名       |
| `guest_name`         | - | リードの名前        |
| `guest_email`        | - | リードのメールアドレス   |
| `guest_phone_number` | - | リードの電話番号      |
| `form_url`           | - | 入力されたフォームのURL |
| `research_result`    | - | リサーチ結果        |
| `created_at`         | - | 作成日時          |
| `lead_detail_url`    | - | リード詳細URL      |

### New Cancel

面談がキャンセルされた際に送信されるイベントです。

**ペイロード例:**

```json
{
  "start_at": "2023-06-01T17:30:00+09:00",
  "end_at": "2023-06-01T18:30:00+09:00",
  "reservation_setting_name": "サンプル面談タイプ名",
  "group_name": "サンプルグループ名",
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_phone": "07011112222",
  "guest_company": "株式会社immedio",
  "user_name": "Immedio Taro",
  "user_email": "user@example.com",
  "created_at": "2023-06-01T09:00:00Z",
  "form_url": "https://example.com"
}
```

**フィールド詳細:**

| フィールド名                     | 型        | 説明            |
| -------------------------- | -------- | ------------- |
| `start_at`                 | datetime | 面談開始日時        |
| `end_at`                   | datetime | 面談終了日時        |
| `reservation_setting_name` | string   | 面談タイプ名        |
| `group_name`               | string   | グループ名         |
| `guest_email`              | string   | リードのメールアドレス   |
| `guest_name`               | string   | リードの名前        |
| `guest_phone`              | string   | リードの電話番号      |
| `guest_company`            | string   | リードの企業名       |
| `user_name`                | string   | 担当者名          |
| `user_email`               | string   | 担当者のメールアドレス   |
| `created_at`               | datetime | 作成日時          |
| `form_url`                 | string   | 入力されたフォームのURL |

### New Request Phone Call

電話相談が依頼された際に送信されるイベントです。

**ペイロード例:**

```json
{
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_phone_number": "07011112222",
  "guest_company": "株式会社immedio",
  "form_name": "sample router",
  "reservation_setting_name": "sample reservation",
  "group_name": "sample group",
  "form_url": "https://example.com",
  "created_at": "2023-06-01T09:00:00Z",
  "custom_items": "サンプルカスタム項目",
  "resource_id": "リソースID",
  "resource_name": "リソース名",
  "resource_type": "フローチャートルーター",
  "lead_detail_url": "https://console.immedio.io/leads?lid=xxx"
}
```

**フィールド詳細:**

| フィールド名                     | 型      | 説明                                                                                     |
| -------------------------- | ------ | -------------------------------------------------------------------------------------- |
| `guest_email`              | -      | リードのメールアドレス                                                                            |
| `guest_name`               | -      | リードの名前                                                                                 |
| `guest_phone_number`       | -      | リードの電話番号                                                                               |
| `guest_company`            | -      | リードの企業名                                                                                |
| `form_name`                | -      | ルーター名                                                                                  |
| `reservation_setting_name` | -      | 面談タイプ名                                                                                 |
| `group_name`               | -      | グループ名                                                                                  |
| `form_url`                 | -      | 入力されたフォームのURL                                                                          |
| `created_at`               | -      | 作成日時                                                                                   |
| `custom_items`             | -      | カスタム項目                                                                                 |
| `resource_id`              | string | リソースID                                                                                 |
| `resource_name`            | string | リソース名                                                                                  |
| `resource_type`            | string | リソースタイプ。取りうる値: `フローチャートルーター`, `旧ルーター`, `日程調整URL`, `Account Engagement`, `Web接客`, `リスケ` |
| `lead_detail_url`          | -      | リード詳細URL                                                                               |

### New Form Node Answer

フォームノードに回答した際に送信されるイベントです。

**ペイロード例:**

```json
{
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_company": "株式会社immedio",
  "created_at": "2023-06-01T09:00:00Z",
  "guest_phone_number": "07011112222"
}
```

**フィールド詳細:**

| フィールド名               | 型 | 説明          |
| -------------------- | - | ----------- |
| `guest_email`        | - | リードのメールアドレス |
| `guest_name`         | - | リードの名前      |
| `guest_phone_number` | - | リードの電話番号    |
| `guest_company`      | - | リードの企業名     |
| `created_at`         | - | 作成日時        |

### New Checkin Questionnaire <a href="#new-checkin-questionnaire" id="new-checkin-questionnaire"></a>

チェックインアンケートに回答した際に送信されるイベントです。チェックイン機能を有効にした面談タイプで、リードがチェックインアンケートに回答すると送信されます。

チェックイン設定の詳細については、[チェックイン設定](/meeting-settings/reservation-settings/checkin-settings.md)を参照してください。

**ペイロード例:**

```json
{
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_company": "株式会社immedio",
  "created_at": "2023-06-01T09:00:00Z",
  "guest_phone_number": "07011112222"
}
```

**フィールド詳細:**

| フィールド名               | 型 | 説明          |
| -------------------- | - | ----------- |
| `guest_email`        | - | リードのメールアドレス |
| `guest_name`         | - | リードの名前      |
| `guest_phone_number` | - | リードの電話番号    |
| `guest_company`      | - | リードの企業名     |
| `created_at`         | - | 作成日時        |

### New AI SDR Qualify Passed <a href="#new-ai-sdr-qualify-passed" id="new-ai-sdr-qualify-passed"></a>

AI接客フローでクオリフィケーションノードを通過した際に送信されるイベントです。リードがチャットを通じて属性情報を提供し、クオリフィケーションノードの条件評価が完了してフローが次のノードへ進んだタイミングで発火します。

このトリガーを利用することで、クオリフィケーション通過直後のリード属性をZapier経由で外部ツール（Slack通知、CRM登録など）へ即時連携できます。

AI接客のフロー設定の詳細については、[フロー設定](/company-settings/ai-sdr/flow.md)を参照してください。

**ペイロード例:**

```json
{
  "created_at": "2023-06-01T09:00:00+09:00",
  "プロパティ_従業員規模": "100名以上",
  "プロパティ_業種": "IT"
}
```

**フィールド詳細:**

| フィールド名       | 型        | 説明                                                                                                                                        |
| ------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `created_at` | datetime | 作成日時                                                                                                                                      |
| `プロパティ_*`    | string   | [プロパティ設定](/company-settings/mapping-router/property-settings.md)で定義されたプロパティごとのリード属性値。キーは`プロパティ_`の後にプロパティ名が続く形式です。AI接客の会話を通じて収集された値が設定されます |

**注意事項:**

* ペイロードに含まれるプロパティのフィールドは、[プロパティ設定](/company-settings/mapping-router/property-settings.md)で定義されたプロパティに基づいて動的に決まります
* プロパティが未定義の場合、`created_at`のみが送信されます
* Zapierの「Sample data」取得時にも、プロパティ設定に基づいたサンプルデータが返されます

## プロパティの送信について

以下のイベントでは、基本フィールドに加えて、[プロパティ設定](/company-settings/mapping-router/property-settings.md)で定義されたプロパティがペイロードに含まれます。

* New Reservation
* New Questionnaire
* New Survey
* New Followup Email
* New Need More Slots
* New Request Phone Call
* New Form Node Answer
* New Checkin Questionnaire

プロパティのキーは`プロパティ_`の後にプロパティ名が続く形式になります。

**ペイロード例:**

```json
{
  "guest_email": "guest@example.com",
  "guest_name": "Immedio Taro",
  "guest_company": "株式会社immedio",
  "created_at": "2023-06-01T09:00:00Z",
  "guest_phone_number": "07011112222",
  "プロパティ_部署": "営業部",
  "プロパティ_役職": "マネージャー"
}
```

上記の例では、プロパティ設定で「部署」と「役職」というプロパティが定義されており、アンケートの回答項目がそれぞれのプロパティに紐づいている場合のペイロードです。アンケートで回答された値が、対応するプロパティのキーに設定されます。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.immedio.io/company-settings/integrations/zapier.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.