# トリガーイベントと範囲

Source: https://docs.rooquiz.com/ja/connectors/events

> すべてのコネクターは、トリガーイベントによって動作し、どのクイズから動作させられるかを決めるトリガー範囲によって制限されます。5 つのイベントそれぞれが発生するタイミング、新規リードのイベントが一度しか発生しない理由、コネクターを特定のクイズに絞り込む方法、マーケティングメールへの同意で絞り込む条件、そのまま使える組み合わせの例を説明します。

各コネクターは、**いつ動作するか**(イベント)と、**どのクイズから動作させられるか**(範囲)を決めます。この 2 つは AND で組み合わされます。イベントが一致し、*かつ* 発生元のクイズが範囲内にある場合にのみ配信されます。

## トリガーイベント

すべてのコネクターには、少なくとも 1 つのイベントが必要です。

| イベント            | 発生するタイミング                                                                    |
| --------------- | ---------------------------------------------------------------------------- |
| **新しい回答**       | 誰かがクイズを完了したとき。匿名の回答や、同じ人による再回答も含め、**すべて** の回答が対象です                           |
| **新規リード**       | ある人がチームに **初めて** 連絡先を残したとき                                                   |
| **予約が作成された**    | 結果ページから予約された通話が確定したとき。Cal.com のイベントタイプで確認が必須になっている場合は、あなたが Cal.com で確定した時点です |
| **予約がキャンセルされた** | どちらかの側が Cal.com で通話をキャンセルしたとき                                                |
| **予約が変更された**    | Cal.com で通話が別の時刻に移動したとき                                                      |

<Callout type="warning">
  **「新規リード」は、その人が初めて連絡先を残したときに一度だけ発生します。** リードは[クイズをまたいで重複が排除される](https://docs.rooquiz.com/ja/leads)ため、同じ人が後で別のクイズに回答しても再び発生することはありません。回答のたびに通知を受け取りたい場合は、代わりに **新しい回答** を選んでください。
</Callout>

<Callout type="info">
  **新しい回答** は結果の計算が終わってから送信されるため、配信には必ずスコア、レベル、または結果タイプが含まれます。
</Callout>

<Callout type="info">
  予約イベントの対象は、実際に成立したセッションだけです。承認待ちのリクエスト、却下されたリクエスト、承認待ちのまま変更・取り下げられたリクエストでは、**何も発生しません**。まだ合意していない打ち合わせに、後続の自動化が反応しないようにするためです。また、予約イベントには [Cal.com コネクター](https://docs.rooquiz.com/ja/bookings/calcom)が必要です。コネクターがないと、RooQuiz は予約の発生を把握できません。
</Callout>

## トリガー範囲

範囲は、どのクイズからこのコネクターを動作させられるかを制御します。

* **すべての診断** — デフォルトです。チーム内のどのクイズで発生したイベントも配信されます。
* **指定した診断** — 選択したクイズだけがコネクターを動作させます。

<Callout type="info">
  範囲は、**イベントが発生したクイズ** に対して照合されます。「新しい回答」の場合は、いま回答されたクイズが対象です。「新規リード」の場合は、その人が直近に回答したクイズではなく、**最初に連絡先を残した** クイズが対象です。
</Callout>

典型的な使い方は、主力のリード獲得用クイズを Slack に送ってチームがすぐに確認できるようにし、社内向けのクイズでは誰にも通知が飛ばないようにすることです。

## そのまま使える組み合わせ

| 目的                    | イベント                   | 範囲     |
| --------------------- | ---------------------- | ------ |
| 新しい顧客の情報を全員に知らせる      | 新規リード                  | すべての診断 |
| すべての回答を自社のバックエンドで採点する | 新しい回答                  | すべての診断 |
| 主力のクイズだけを追跡する         | 新規リード                  | 指定した診断 |
| カレンダーの変更を知らせてもらう      | 予約がキャンセルされた + 予約が変更された | すべての診断 |
| リードをメール配信サービスに同期する    | 新規リード                  | すべての診断 |

<Callout type="info">
  イベントや範囲を変更しても、**影響するのはそれ以降のイベントだけ** です。過去のイベントが再送されることはありません。
</Callout>
