> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metrito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos

> Configure quais ações viram eventos de conversão e como cada acionador é disparado.

## O que é um evento no Metrito

Um **evento** é uma ação que aconteceu — uma visualização de página, um envio de formulário, uma compra, uma mensagem no WhatsApp. Na tela de **Eventos** você define **quais ações** o Metrito registra e **quais delas são enviadas como conversão** para os pixels da Meta.

Cada evento pode ser:

* **Só no Metrito** — para acompanhamento interno (funil, sessões, relatórios).
* **Enviado também à Meta (CAPI)** — quando você associa o evento a um evento padrão da Meta (ex.: `Purchase`, `Lead`, `Contact`).

## Eventos criados automaticamente

Dois eventos nascem sozinhos — você não precisa criá-los:

<CardGroup cols={2}>
  <Card title="Visualização de Página (PageView)" icon="eye">
    Criado automaticamente quando o container é criado. Dispara a cada página carregada. Pode ser removido, se quiser.
  </Card>

  <Card title="Compra aprovada (Purchase)" icon="cart-shopping">
    Criado automaticamente quando você conecta um [checkout](/tracking/checkouts). Dispara `Purchase` para a Meta a cada compra aprovada em qualquer checkout conectado e ativo.
  </Card>
</CardGroup>

<Note>
  Para o `Purchase` disparar, o rastreamento do checkout precisa estar **ativado**. Confira o interruptor na tela de [Integrações](/integracoes/overview) (coluna **Tracking**) ou na seção de [Checkouts](/tracking/checkouts).
</Note>

## Criar um evento

Clique em **Novo evento**. O assistente tem três passos: **Evento**, **Acionador** e **Ajustes**.

<Steps>
  <Step title="Evento">
    Dê um nome ao evento e, se quiser enviá-lo à Meta, associe-o a um evento padrão (ex.: `Lead`, `Contact`, `Purchase`).
  </Step>

  <Step title="Acionador">
    Escolha **o que** dispara o evento (veja a lista de acionadores abaixo).
  </Step>

  <Step title="Ajustes">
    Refine **onde** e **quando** o acionador vale — páginas incluídas/excluídas, elemento-alvo, termos, etc.
  </Step>
</Steps>

## Os acionadores

O acionador é o gatilho do evento. Eles cobrem ações no **site**, **WhatsApp**, **checkout** e **links rastreáveis**:

| Acionador                            | Dispara quando…                                              |
| ------------------------------------ | ------------------------------------------------------------ |
| **Visualização de Página**           | uma página é carregada                                       |
| **Duração da Visualização**          | o visitante fica X tempo na página                           |
| **Duração da Visualização de Vídeo** | o vídeo é assistido por X tempo                              |
| **Envio de Formulário**              | um formulário é enviado                                      |
| **Clique em Elemento**               | um elemento específico é clicado                             |
| **Visualização de Elemento**         | um elemento entra na tela                                    |
| **Hover em Elemento**                | o mouse passa sobre um elemento                              |
| **Profundidade de Rolagem**          | o visitante rola até X% da página                            |
| **Compra aprovada no checkout**      | um checkout conectado aprova uma compra (dispara `Purchase`) |
| **Mensagem no WhatsApp**             | uma mensagem contém os termos configurados                   |
| **Clique em link rastreável**        | um link de redirect é clicado                                |

## Configurando os acionadores mais usados

### Acionadores de site (página e elemento)

Nos **Ajustes**, você decide o alcance do acionador:

* **Em todo o site, com exceções** — vale em todas as páginas, menos as que você excluir.
* **Apenas em páginas específicas** — vale só nas páginas que você listar.

Para **Clique em Elemento** (e similares), você identifica o elemento-alvo de uma destas formas:

* **Por link** — cole o link inteiro **ou um trecho**. Um trecho funciona: por exemplo, `pay.hotmart.com` casa com qualquer link de checkout da Hotmart, sem precisar do ID específico.
* **Por classe CSS** — ex.: `.btn-comprar`.
* **Por ID CSS** — ex.: `#finalizar-compra`.

<Tip>
  Usar **trecho de link** é ótimo para checkouts: coloque só até a barra (ex.: `pay.hotmart.com/`) e o acionador pega qualquer produto daquele checkout.
</Tip>

### Mensagem no WhatsApp

Esse acionador usa **Termos de acionamento** — *quais palavras/frases inclusas na mensagem devem disparar o evento?* Sempre que o **operador** envia ao lead uma mensagem que contém um dos termos, o evento dispara.

<Warning>
  A mensagem precisa ser **idêntica** ao termo configurado, incluindo **acentuação, espaços e letras maiúsculas**. Use termos específicos (ex.: "Pagamento aprovado ✅") para evitar disparos por engano.
</Warning>

### Clique em link rastreável

Associa o evento a um [link de redirect](/tracking/links-de-redirect): toda vez que o link é clicado, o evento dispara. Útil para medir cliques em botões de WhatsApp, bio do Instagram, etc.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Checkouts" icon="cart-shopping" href="/tracking/checkouts">
    Conecte seu checkout para o `Purchase` disparar sozinho.
  </Card>

  <Card title="Sessões e leads" icon="list" href="/tracking/sessoes">
    Veja os eventos disparando em ordem e audite cada um.
  </Card>
</CardGroup>