# 다섯 가지 채널

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

> 다섯 가지 커넥터 채널인 직접 준비한 SMTP를 통한 이메일, Webhook, Slack, Zapier, Kit가 각각 무엇을 전달하는지 설명합니다. 채널별로 설정할 수 있는 수신자와 메시지 형식, 삽입 가능한 변수, 서명 검증과 봇 초대 같은 주의 사항, 그리고 채널당 커넥터 하나 규칙을 다룹니다.

Webhook, Slack, Zapier, Kit는 **팀당 커넥터 하나**만 허용합니다. 기존 커넥터를 교체하려면 먼저 삭제하세요. 이메일은 **최대 3개**까지 만들 수 있어 팀이나 이벤트별로 알림을 따로 받을 수 있습니다.

## 이메일

모든 요금제에서 사용할 수 있습니다. [메일 발송 서비스](https://docs.rooquiz.com/ko/connectors/email-smtp)에서 설정한 팀 자체 발송 서비스(SMTP 서버 또는 연결된 Gmail 계정) 중 하나로 발송합니다.

* **발송 서비스** — 이 커넥터의 메일을 보낼 발송 서비스를 선택합니다.
* **수신자** — 주소를 입력하고 Enter를 누릅니다. **최대 10개**까지 가능합니다. 동적 수신자인 "응답자 이메일"을 추가해 당사자에게 알릴 수도 있습니다.
* **제목** — 최대 200자. 줄바꿈과 HTML은 사용할 수 없습니다.
* **본문** — 최대 10,000자. HTML은 사용할 수 없습니다.
* **발송 조건** — **항상 발송** 또는 **특정 결과에만** 중에서 고릅니다. 후자를 고르면 퀴즈 하나와 그 퀴즈의 레벨 또는 결과 유형을 하나 이상 선택합니다(AI 퀴즈의 결과 태그도 포함). 예: "초급" 레벨에만 후속 메일 보내기. 조건은 새 응답과 새 리드에 적용되며, 예약 이벤트는 조건에 일치하지 않습니다. 처음 리드가 될 때는 결과가 아직 준비되지 않았을 수 있으므로(AI 퀴즈에서는 항상 준비되지 않음), 결과별 이메일은 **새 응답** 이벤트로 트리거하세요.

퀴즈 하나에 결과별 이메일을 가장 빠르게 설정하려면 해당 퀴즈의 **설정 → 결과 페이지 후속 조치 → 결과별 이메일**을 사용하세요. [퀴즈 설정](https://docs.rooquiz.com/ko/editor/settings#결과-페이지-후속-조치)을 참고하세요.

제목과 본문 모두 **변수 삽입**을 지원하며, 변수는 두 그룹으로 나뉩니다.

* **시스템 변수** — 리드 이름, 응답자 이름과 이메일, 퀴즈 이름, 레코드 번호, 제출 시각, 점수, 만점, 결과 레벨, 결과 유형, 리포트 링크, 리드 상세 링크, 팀 이름, 그리고 예약 이벤트의 경우 참석자 이름과 이메일, 예약 시작·종료 시각, 변경 전 시작 시각
* **퀴즈 문항** — 특정 문항의 답변을 참조합니다.

## 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에 생성됩니다**.
* **결과별 태그** — 결과에 따라 응답자에게 태그를 붙이는 규칙을 추가합니다. 규칙마다 퀴즈 하나, 그 퀴즈의 레벨 또는 결과 유형(또는 AI 결과 태그) 하나 이상, 그리고 붙일 태그를 고릅니다. 태그마다 다른 Kit 시퀀스를 시작하세요. 규칙은 제출할 때마다 적용되므로, 다시 응답해 새로운 결과가 나오면 그 결과의 태그도 추가됩니다.
* 필요할 때 **태그 새로고침**으로 Kit에서 태그 목록을 다시 가져옵니다.

Kit에서 이 태그로 이메일 시퀀스를 트리거하면 새 리드가 곧바로 육성 경로로 들어갑니다.

<Callout type="info">
  이메일과 Slack은 모든 요금제에서 사용할 수 있습니다. Webhook, Zapier, Kit는 **Pro 플랜 전용**입니다.
</Callout>
