# 五個管道

Source: https://docs.rooquiz.com/zh-TW/connectors/channels

> 連接支援五個管道：郵件（走你自己的寄信服務）、Webhook、Slack、Zapier 與 Kit。Webhook、Slack、Zapier 與 Kit 每個團隊只能設定一條連接，郵件最多三條。這一頁說明每個管道分別投遞什麼、收件人與訊息格式怎麼設定、各自需要哪些前置設定。郵件管道每條最多十個收件人，也可以把「答題者電子郵件」作為動態收件人直接通知本人。

Webhook、Slack、Zapier 和 Kit **每個團隊只能配一個**——要換掉已有的，先刪除再重建。郵件**最多可配 3 個**，方便不同團隊或不同事件各收各的通知。

## 郵件

所有方案都可用。透過團隊自己的某個寄信服務寄信——SMTP 伺服器或已連接的 Gmail 帳號，在[寄信服務](https://docs.rooquiz.com/zh-TW/connectors/email-smtp)裡設定。

* **寄信服務** —— 選擇由哪一個寄信服務投遞這個連接器的郵件。
* **收件人** —— 輸入電子郵件後按 Enter,**最多 10 個**。也可以加「答題者電子郵件」這個動態收件人,把通知直接發給對方。
* **主題** —— 最長 200 字元,不允許換行和 HTML。
* **正文** —— 最長 10000 字元,不允許 HTML。
* **寄送條件** —— **每次都寄**，或 **僅特定結果**：選一份測評，再選它的一個或多個等級或結果類型（AI 測評的結果標籤也算），比如只給「初學者」等級寄一封跟進郵件。條件只作用於新增測評紀錄和新增線索；預約類事件永遠不會命中。由於一個人剛成為線索時結果可能還沒算好（AI 測評則一定還沒有），按結果寄送的郵件請用 **新增測評紀錄** 觸發。

想為某一份測評設定按結果寄信，最快的方式是在該測評的 **設定 → 結果頁跟進 → 依結果寄信** 裡設定——見 [測驗設定](https://docs.rooquiz.com/zh-TW/editor/settings#結果頁跟進)。

主題和正文都支援**插入變數**,分兩組:

* **系統變數** —— 線索名、答題者姓名與電子郵件、測評名稱、記錄編號、提交時間、得分、滿分、結果等級、結果類型、報告連結、線索頁連結、團隊名稱；預約類事件還有預約人姓名與電子郵件、預約開始與結束時間，以及原開始時間。
* **測評題目** —— 直接引用某道題的答案。

## Webhook

把事件以 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(`*粗体*`、`_斜体_`、`` `程式碼` ``、`<url|文字>`)和系統變數。留空則使用預設的 Block Kit 格式。

## Zapier

用 Zapier 把線索接到上千個應用:

1. 在 Zapier 新增 Zap,觸發器選 **Webhooks by Zapier**。
2. 事件選 **Catch Hook**,複製它生成的 Webhook URL。
3. 回到 RooQuiz 貼上該 URL 並儲存,再用 **發送測試** 驗證。

## Kit

Kit(原 ConvertKit)是電子郵件行銷工具。點 **連接 Kit** 走 OAuth 授權後:

* **給每條新線索打的標籤** —— 一組固定的標籤（最多 20 個），套用到每個訂閱者身上，比如 `quiz-lead`。輸入一個不存在的名字，儲存時會在 Kit 裡**新增**這個標籤。
* **依結果加標籤** —— 新增規則，按答題者的結果打標籤：每條規則選一份測評、它的一個或多個等級或結果類型（或 AI 結果標籤），以及要打的標籤。在 Kit 裡為每個標籤啟動不同的郵件序列。規則在每次提交時都會套用，所以重答後落到新結果時，也會加上新結果對應的標籤。
* 需要時點 **重新整理標籤** 重新拉取 Kit 側的標籤列表。

在 Kit 裡用這些標籤觸發郵件序列，新線索就能自動進入你的培育流程。

<Callout type="info">
  郵件與 Slack 所有方案都可用。Webhook / Zapier / Kit 是 **Pro 方案專屬**。
</Callout>
