> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/build/assistentes/builder/componentes/events.md).

# 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`.