# 5 つのチャネル

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

> コネクターの 5 つのチャネルを詳しく説明します。自社の SMTP サーバーを使うメール、Webhook、Slack、Zapier、Kit について、それぞれが何を届けるのか、設定できる受信者やメッセージの形式、挿入できる変数、署名の検証や Slack ボットの招待といった注意点をまとめています。コネクターは Webhook、Slack、Zapier、Kit ではチームごとに 1 つ、メールでは最大 3 つまで作成できます。

Webhook、Slack、Zapier、Kit で作成できるのは **チームごとに 1 つのコネクター** です。既存のものを置き換えるには、先に削除してください。メールは **最大 3 つ** まで作成できるので、チームやイベントごとに別々の通知を用意できます。

## メール

すべてのプランで利用できます。チーム独自の送信サービス(SMTP サーバー、または接続した Gmail アカウント)のいずれかを通じて送信します。送信サービスは[メール送信サービス](https://docs.rooquiz.com/ja/connectors/email-smtp)で設定します。

* **送信サービス** — このコネクターのメールをどの送信サービスから送るかを選びます。
* **受信者** — アドレスを入力して Enter キーを押します。**最大 10 件** です。動的な受信者である「回答者のメールアドレス」を追加して、本人に通知することもできます。
* **件名** — 200 文字まで。改行と HTML は使えません。
* **本文** — 10,000 文字まで。HTML は使えません。
* **送信条件** — **毎回送信** または **特定の結果のみ** を選びます。後者では、クイズを 1 つと、そのレベルまたは結果タイプを 1 つ以上選びます(AIクイズの結果タグも対象です)。たとえば「初級」レベルの人にだけフォローアップを送る、といった使い方です。条件が適用されるのは新しい回答と新しいリードで、予約イベントは一致しません。リードになった時点では結果がまだ出ていないことがある(AIクイズでは必ずそうなる)ため、結果に応じたメールは **新しい回答** をトリガーにしてください。

1 つのクイズで結果に応じたメールを設定するいちばん手早い方法は、そのクイズの **設定 → 結果ページのフォローアップ → 結果別メール** です。[クイズの設定](https://docs.rooquiz.com/ja/editor/settings#結果ページのフォローアップ)をご覧ください。

件名と本文はどちらも **変数の挿入** に対応しており、変数は 2 つのグループに分かれています。

* **システム変数** — リード名、回答者の名前とメールアドレス、クイズ名、レコード番号、回答日時、スコア、満点、結果レベル、結果タイプ、レポートのリンク、リードページのリンク、チーム名。予約イベントでは、参加者の名前とメールアドレス、予約の開始・終了時刻、変更前の開始時刻も使えます。
* **クイズの設問** — 特定の設問への回答を参照します。

## Webhook

各イベントを自社の URL に POST します。URL は **HTTPS** である必要があります。

<Callout type="warning">
  **署名シークレットは作成時に一度だけ表示されます**。ダイアログを閉じると二度と表示されないので、すぐにコピーしてください。
</Callout>

すべての配信には `X-Rooquiz-Signature` ヘッダーが付きます。これは、そのシークレットを使ってリクエストボディから計算した **HMAC-SHA256** です。リクエストが本当に RooQuiz から送られたものであることを確認するために、サーバー側で検証してください。

## Slack

**Slackに接続** をクリックして OAuth の手順を進め、チャンネルを選びます。

<Callout type="warning">
  ボットはチャンネルに自動では追加 **されません**。先に対象のチャンネルで `/invite @rooquiz` を実行してください。**プライベートチャンネルでは必須** です。実行しないと、配信は `not_in_channel` で失敗します。
</Callout>

Slack の mrkdwn(`*bold*`、`_italic_`、`` `code` ``、`<url|text>`)とシステム変数を使って **メッセージテンプレート** を指定できます。空欄にすると、デフォルトの Block Kit の形式が使われます。

## Zapier

Zapier を使うと、数千のアプリと連携できます。

1. Zapier で Zap を作成し、トリガーとして **Webhooks by Zapier** を選びます。
2. **Catch Hook** イベントを選び、生成された Webhook URL をコピーします。
3. その URL を RooQuiz に貼り付けて保存し、**テスト送信** で確認します。

## Kit

Kit(旧 ConvertKit)はメールマーケティングツールです。**Kitに接続** をクリックして OAuth の手順を完了すると、次の設定ができます。

* **新規リードに付けるタグ** — すべての購読者に付ける、最大 20 個の固定のタグです。例:`quiz-lead`。まだ存在しない名前を入力すると、保存時に **Kit 上で作成されます**。
* **結果別タグ** — 回答者の結果に応じてタグを付けるルールを追加します。各ルールでは、クイズを 1 つと、そのレベルまたは結果タイプ(または AI の結果タグ)を 1 つ以上、そして付けるタグを選びます。タグごとに別々の Kit シーケンスを開始できます。ルールは送信のたびに適用されるため、再回答で新しい結果になった場合は、その結果のタグも追加されます。
* 必要に応じて **タグを更新** をクリックし、Kit からタグの一覧を取得し直します。

Kit でそれらのタグをトリガーにしたメールシーケンスを設定すれば、新しいリードがそのままナーチャリングの流れに乗ります。

<Callout type="info">
  メールと Slack はすべてのプランで利用できます。Webhook、Zapier、Kit は **Pro プラン限定** です。
</Callout>
