# Eventos de gatilho e escopo

Source: https://docs.rooquiz.com/pt-BR/connectors/events

> Cada conector é acionado por eventos de gatilho e limitado por um escopo — quais quizzes podem acioná-lo. O que significa cada um dos cinco eventos, como restringir o conector a quizzes específicos e o filtro de consentimento.

Cada conector define **quando é acionado** (eventos) e **quais quizzes podem acioná-lo** (escopo). As duas condições se combinam com E: o evento precisa corresponder *e* o quiz de origem precisa estar no escopo para que algo seja entregue.

## Eventos de gatilho

Todo conector precisa de pelo menos um evento:

| Evento                     | É acionado quando                                                                                                                                                    |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nova resposta**          | Alguém conclui um quiz — **todos** os envios, inclusive os anônimos e as novas tentativas da mesma pessoa                                                            |
| **Novo lead**              | Alguém deixa os dados de contato com a sua equipe **pela primeira vez**                                                                                              |
| **Agendamento criado**     | Uma chamada agendada a partir de uma página de resultado está de pé. Se o tipo de evento do Cal.com exige confirmação, é o momento em que você a confirma no Cal.com |
| **Agendamento cancelado**  | Qualquer uma das partes cancela a chamada no Cal.com                                                                                                                 |
| **Agendamento reagendado** | A chamada é movida para outro horário no Cal.com                                                                                                                     |

<Callout type="warning">
  **"Novo lead" é acionado uma única vez, na primeira vez que a pessoa deixa os dados.** Se a mesma pessoa fizer outro quiz depois, ele não é acionado de novo, porque os leads são [deduplicados entre quizzes](https://docs.rooquiz.com/pt-BR/leads). Se você quer uma notificação a cada envio, escolha **Nova resposta**.
</Callout>

<Callout type="info">
  **Nova resposta** é enviada depois que o resultado é calculado, então a entrega sempre traz a pontuação, o nível ou o tipo de resultado.
</Callout>

<Callout type="info">
  Os eventos de agendamento só cobrem sessões que realmente estão de pé. Uma solicitação pendente, uma solicitação recusada ou uma solicitação pendente que é reagendada ou retirada **não aciona nada** — as automações seguintes não devem agir sobre uma reunião que ainda não foi acordada. Os eventos de agendamento também exigem o [conector do Cal.com](https://docs.rooquiz.com/pt-BR/bookings/calcom); sem ele, o RooQuiz nunca fica sabendo dos agendamentos.
</Callout>

## Escopo de acionamento

O escopo controla quais quizzes podem acionar este conector:

* **Todos os quizzes** — o padrão. Qualquer evento de qualquer quiz da equipe é entregue.
* **Quizzes específicos** — somente os quizzes que você selecionar o acionam.

<Callout type="info">
  O escopo é comparado com **o quiz de onde veio o evento**. Para "Nova resposta", é o quiz que acabou de ser enviado; para "Novo lead", é o quiz em que a pessoa **deixou os dados pela primeira vez** — não o mais recente que ela fez.
</Callout>

Um uso típico: enviar o seu principal quiz de geração de leads para o Slack, para que a equipe veja na hora, e evitar que um quiz interno incomode alguém.

## Combinações que vale copiar

| O que você quer                              | Eventos                            | Escopo              |
| -------------------------------------------- | ---------------------------------- | ------------------- |
| Todos ficam sabendo de um novo cliente       | Novo lead                          | Todos os quizzes    |
| Pontuar cada resposta no seu próprio backend | Nova resposta                      | Todos os quizzes    |
| Acompanhar só o quiz principal               | Novo lead                          | Quizzes específicos |
| Ser avisado quando a agenda muda             | Agendamento cancelado + reagendado | Todos os quizzes    |
| Sincronizar leads com seu ESP                | Novo lead                          | Todos os quizzes    |

<Callout type="info">
  Alterar eventos ou escopo **só afeta os eventos dali em diante** — nada é reenviado.
</Callout>
