# 트리거 이벤트 및 범위

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

> 모든 커넥터는 트리거 이벤트가 발생할 때 실행되며, 어떤 퀴즈가 실행할 수 있는지를 정하는 범위로 제한됩니다. 새 응답, 새 리드, 예약 생성·취소·변경의 다섯 이벤트가 각각 언제 발생하는지, 커넥터를 특정 퀴즈로 좁히는 방법, 마케팅 수신 동의 필터와 참고할 만한 조합을 설명합니다.

각 커넥터는 **언제 실행할지**(이벤트)와 **어떤 퀴즈가 실행할 수 있는지**(범위)를 정합니다. 두 조건은 AND로 결합됩니다. 이벤트가 일치하고 *동시에* 출처 퀴즈가 범위 안에 있어야 전송됩니다.

## 트리거 이벤트

모든 커넥터에는 이벤트가 하나 이상 필요합니다.

| 이벤트         | 발생 시점                                                                 |
| ----------- | --------------------------------------------------------------------- |
| **새 응답**    | 누군가 퀴즈를 완료했을 때 — 익명 응답과 같은 사람의 반복 응답을 포함해 **모든** 제출                   |
| **새 리드**    | 누군가 팀에 **처음으로** 연락처를 남겼을 때                                            |
| **예약 생성됨**  | 결과 페이지에서 잡힌 통화가 확정되었을 때. Cal.com 이벤트 유형에 확인이 필요하면 Cal.com에서 확인한 시점입니다 |
| **예약이 취소됨** | 어느 한쪽이 Cal.com에서 통화를 취소했을 때                                           |
| **예약이 변경됨** | Cal.com에서 통화가 다른 시간으로 옮겨졌을 때                                          |

<Callout type="warning">
  **"새 리드"는 그 사람이 처음 연락처를 남길 때 한 번만 발생합니다.** 같은 사람이 나중에 다른 퀴즈에 응답해도 다시 발생하지 않습니다. 리드는 [여러 퀴즈에 걸쳐 중복이 제거](https://docs.rooquiz.com/ko/leads)되기 때문입니다. 제출할 때마다 알림을 받고 싶다면 **새 응답**을 선택하세요.
</Callout>

<Callout type="info">
  **새 응답**은 결과 계산이 끝난 뒤 전송되므로 전송 데이터에는 항상 점수, 레벨 또는 결과 유형이 포함됩니다.
</Callout>

<Callout type="info">
  예약 이벤트는 실제로 성립된 세션만 다룹니다. 대기 중인 요청, 거절된 요청, 대기 중에 변경되거나 철회된 요청은 **아무 이벤트도** 발생시키지 않습니다. 합의되지 않은 미팅에 후속 자동화가 반응하지 않도록 하기 위해서입니다. 예약 이벤트에는 [Cal.com 커넥터](https://docs.rooquiz.com/ko/bookings/calcom)도 필요합니다. 커넥터가 없으면 RooQuiz는 예약 사실을 전혀 알 수 없습니다.
</Callout>

## 트리거 범위

범위는 어떤 퀴즈가 이 커넥터를 실행할 수 있는지 제어합니다.

* **모든 퀴즈** — 기본값입니다. 팀의 모든 퀴즈에서 발생한 이벤트가 전송됩니다.
* **특정 퀴즈** — 선택한 퀴즈만 커넥터를 실행합니다.

<Callout type="info">
  범위는 **이벤트가 발생한 퀴즈**를 기준으로 판단합니다. "새 응답"의 경우 방금 제출된 퀴즈이고, "새 리드"의 경우 가장 최근에 응답한 퀴즈가 아니라 그 사람이 **처음 연락처를 남긴** 퀴즈입니다.
</Callout>

대표적인 활용 예: 핵심 리드 확보용 퀴즈는 Slack으로 보내 팀이 즉시 확인하게 하고, 내부용 퀴즈는 아무도 방해하지 않게 합니다.

## 참고할 만한 조합

| 목표                   | 이벤트               | 범위    |
| -------------------- | ----------------- | ----- |
| 새 고객 소식을 모두에게 알리기    | 새 리드              | 모든 퀴즈 |
| 모든 응답을 자체 백엔드에서 채점하기 | 새 응답              | 모든 퀴즈 |
| 핵심 퀴즈만 추적하기          | 새 리드              | 특정 퀴즈 |
| 일정이 바뀌면 알림 받기        | 예약이 취소됨 + 예약이 변경됨 | 모든 퀴즈 |
| 리드를 ESP에 동기화하기       | 새 리드              | 모든 퀴즈 |

<Callout type="info">
  이벤트나 범위를 바꾸면 **그 이후의 이벤트에만 적용되며**, 지난 이벤트는 다시 전송되지 않습니다.
</Callout>
