# Eventos

Os eventos que incluímos no Builder para serem disparados durante o atendimento e capturar informações específicas, são os chamados **eventos personalizados**. 

{% hint style="warning" %}
Antes de configurarmos no Builder, é necessário criar o evento no [Monitor](/monitor/eventos.md). 
{% endhint %}

```javascript
[
   {
       "event_name": "<nome_do_evento_criado_no_monitor>",
       "details": {
           "field1": "<value1>",
           "field2": "<value2>"
       },
       "extra1": "<value_extra1>",
       "extra2": "<value_extra2>"
   }
]
```

Posteriormente, esses eventos poderão ser convertidos em métricas ou indicadores no [Dashboard](/monitor/dashboard.md).

## Atributos

* **event\_name (obrigatório):** nome do evento, que deve ser previamente parametrizado na seção Monitor > Eventos.
* **details (opcional):** objeto que contém fields, isto é, informações adicionais você deseja armazenar e atrelar ao evento. **Não é permitido** alterar o nome dos campos`field1`e `field2`, somente os valores são editáveis.
* **extra1 e extra2 (opcional):** campos extras de índice que contêm as principais informações do evento para o filtro em relatório. **Não é permitido** alterar o nome dos campos `extra1`  e `extra2`, somente os valores são editáveis.

**Exemplo 1:**

```javascript
[
   {
       "event_name": "aceite_termo",
       "details": {
           "field1": "<? $numero_contrato ?>",
           "field2": "contact.cpf"
       },
       "extra1": "source_whatsapp",
       "extra2": "<? input.text ?>"
   }
]
```

**Exemplo 2:**&#x20;

Suponhamos que exista um menu de assuntos diversos no atendimento e você deseja capturar quais assuntos foram escolhidos pelo usuário para, posteriormente, criar no [Dashboard](/boas-praticas/eventos/eventos-padroes/menu_principal/monitor.md#exemplo-de-configuracao) uma métrica e refletir no gráfico os assuntos mais recorrentes no Assistente.

```javascript
[
   {
       "event_name": "assunto_escolhido",
       "details": {
           "field1": "<?  $email ?>"
       },
       "extra1": "<? $menu_assunto_escolhido ?>",
   }
]
```

Incluímos no atributo `event_name` o nome `assunto_escolhido`, previamente criado no Monitor > Eventos, e o atributo opcional `extra1`, que recebe a nossa principal informação:&#x20;

A [variável de contexto](/build/assistentes/builder/componentes/variables.md) `<? $menu_assunto_escolhido ?>`, criada para armazenar o assunto escolhido pelo usuário.&#x20;

Por fim, optamos por coletar a informação adicional`<? $email ?>`, que virá no campo `fiel1` do objeto `details`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altu.d1.cx/build/assistentes/builder/componentes/events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.