> 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/monitor/eventos.md).
# Eventos
## Visão Geral
Eventos são uma forma de **acompanhar as interações e ações no assistente**. Eles são indispensáveis para gerar métricas e indicadores.
Para **buscar**, **criar** ou **editar eventos**, clique em **Monitor > Eventos** no menu lateral do Zenvia NLU.
Após isso, você verá uma página com duas abas: **Monitoramento** e **Parametrização**.
## Monitoramento
Nessa página você busca eventos e verifica atendimentos que passaram por uma determinada situação ou caso de uso como, por exemplo, um transbordo.
Os filtros disponíveis são:
* **Assistente**: selecione “todos” ou escolha um determinado assistente;
* **Canais**: selecione “todos” ou selecione um determinado canal;
* **Período**: escolha um período de tempo
* **Máximo**: 30 dias
* **Padrão**: últimos 7 dias
* **Eventos**: digite o nome do evento que você deseja encontrar. Essa área tem *autocomplete* para facilitar a busca. \
**É necessário escolher no mínimo um e no máximo cinco eventos para filtrar**.
{% hint style="info" %}
**Atenção**: uma pesquisa **com mais de um evento** trará como resultado atendimentos em que **pelo menos um** desses eventos foi disparado
{% endhint %}
Após preencher esses campos, clique no botão “**Filtrar**”, no canto direito da página para visualizar o resultado da pesquisa.
### Exportar eventos
Depois de encontrar os atendimentos em que os eventos aconteceram, você pode exportar um relatório em formato CSV.
Para fazer o download do relatório, clique no botão “**Exportar eventos**” e, na janela que se abrirá, verifique os filtros aplicados, escolha se deseja também incluir os eventos de teste e clique em “**Exportar**”
{% hint style="info" %}
O relatório será gerado com base nos filtros escolhidos por você no momento da pesquisa. Um link para download de um arquivo *zip*, contendo o relatório em CSV, será enviado para seu e-mail de cadastro no Zenvia NLU.
{% endhint %}
## **Parametrização**
Nessa aba você **cria**, **visualiza**, **edita** e **exclui** eventos do seu assistente.
No canto esquerdo superior da tela você vê uma lista expansível para selecionar o tipo de evento que deseja visualizar.
Já no canto direito da página você vê um campo de busca, onde pode pesquisar um evento para ser editado ou apagado.
{% hint style="info" %}
**Bom saber**: **o campo** “**pesquisa**” **e** “**tipo de evento**” **operam juntos**. Então, ao fazer uma busca, verifique se você selecionou o tipo correto de evento
{% endhint %}
O resultado da sua busca será demonstrado em forma de lista, com as seguintes colunas:
**Identificador**: é o nome do evento;\
**Label**: uma breve descrição desse evento; \
**Campos extra1 e extra2**: use para adicionar mais informações aos eventos. Esses campos podem ser usados como valores para relatórios.
No ícone de **lixeira**, no canto direito, é possível **apagar o evento**.
{% hint style="warning" %}
**Atenção**: ao fazer uma exclusão, todas as métricas e gráficos baseados nesse evento serão excluídos do dashboard
{% endhint %}
### Adicionar evento
Para configurar um novo evento, clique em “**+ Adicionar evento**”, no canto superior direito da página de Parametrização.
**Você deverá escolher o** [**tipo de evento**](#tipos-de-eventos)**, entre Personalizado ou API**
Depois disso, você deve preencher:
**Identificador****\***: é o nome da variável usada no nó;\
**Label****\***: breve relato do que traz esse evento; \
[**Campos extra1 e extra2**](#campos-extras): use para adicionar mais informações aos eventos. Esses campos podem ser usados como valores para relatórios. Opcional.
*Os campos label, extra1 e extra2 podem ser alterados depois*
Para saber como **configurar uma API de eventos**, [acesse essa página.](/connect/apis/eventos.md)
## Tipos de Eventos
É importante saber que os eventos estão separados em **três tipos principais**:
### **Eventos Personalizados**
São eventos configurados no Zenvia NLU **de acordo com as suas regras de negócio**. Eles podem tanto **monitorar o desempenho** do assistente bem como os **padrões de uso das pessoas** que conversam com ele.
Aqui a criatividade é quem manda, mas preparamos uma seção especial de [boas práticas na criação de eventos personalizados](/boas-praticas/eventos/eventos-padroes.md), não deixe de conferir!
{% hint style="info" %}
Esse tipo de evento precisa ser configurado no [Builder ](/build/assistentes/builder.md)e constar no fluxograma
{% endhint %}
### **Eventos de API**
Esses são criados para servir a [API de Eventos](/connect/apis/eventos.md). **Eles podem informar ações feitas fora do** Zenvia NLU para monitorar, por exemplo, pendências de processos da sua empresa que foram solicitados inicialmente via assistente.
**Por exemplo**: imagine que uma empresa tem em seu assistente o autosserviço “pedido de cartão de crédito”. Um cliente conversa com o chatbot, faz a solicitação do cartão, e informa todos os dados necessários.
O assistente pode responder algo como "Seu pedido de cartão esta em avaliação". Então, O Zenvia NLU enviará ao sistema de CRM da empresa as informações, e um analista avalia e aprova o pedido. Neste momento pode haver, dentro da API `CRM <>` Zenvia NLU, um Evento de API chamado "cartão aprovado". \
\
Por consequência, as métricas de aprovação (ou recusa) de um cartão poderão ser exibidas no [dashboard](/monitor/dashboard.md) do Zenvia NLU.
## E**ventos de sistema**
Já esse tipo é **chamado automaticamente** e não precisa ser configurado dentro do builder e nem estar no fluxograma do assistente.
Também não é possível criar nem editar o nome desses eventos, somente as opções de “**Label**”, “**Label do extra1**” e “**Label do extra2**”.
Veja a tabela contendo todos os eventos desse tipo:
| **Eventos** | **Descrição** |
| ----------------------------------------- | ------------------------------------------ |
| contact\_return | Retorno a atendimento |
| livechat\_conversation\_accepted | Conversa aceita pelo agente |
| livechat\_conversation\_closed\_by\_agent | Conversa fechada pelo agente |
| livechat\_conversation\_closed\_by\_user | Conversa fechada pelo usuário |
| livechat\_transfer\_timeout | Tempo limite de transferência do Live Chat |
| livechat\_transfer\_to\_agent | Transferência para agente no Live Chat |
| livechat\_user\_inactivity\_timeout | Tempo limite de transferência do Live Chat |
| liveperson\_agent\_transfer | Transferência para agente na Live Person |
| liveperson\_new\_dialog | Novo diálogo na Live Person |
| new\_contact | Novo atendimento |
| new\_dialog | Novo diálogo aberto no assistente |
## **Exemplos**
### Configuração de evento no Builder
Você também vai encontrar muitas informações importantes na aba de [boas práticas](/boas-praticas.md), como os eventos personalizados mais usados e como configurá-los em seu assistente.
### Configuração no Dashboard
{% hint style="info" %}
Aprenda como [criar métricas e indicadores](/monitor/dashboard/metricas.md) no Dashboard
{% endhint %}
#### Visualização expandida e de campos extras
Você também vai encontrar muitas informações importantes na aba de boas práticas, como os eventos personalizados mais usados e como configurá-los em seu assistente.
### Campos extras
Use os campos **extra1 e extra2** para obter mais **informações** das **operações aplicadas a eventos**, que podem ser usadas como **filtro para relatórios.**
**Esses campos são opcionais**, usam valores que estão dentro do assistente e que são capturadas durante os atendimentos, por exemplo, opção do menu escolhida pelo usuário.
Para visualizar os campos extras use a ação de expansão, clicando no **botão expandir** no card da métrica ou do indicador.
.png)
As operações **NPS ou CSAT** apresentam uma visão global da avaliação média de usuários. Sabemos que muitas vezes a opção de avaliar é apresentada em diferentes momentos e serviços durante a interações com o assistente, por isso, os campos **extra 1 e extra 2** mostram o **detalhamentos dessas métricas**.
Um dos campos representa a **categoria**, que é a **identificação do que foi avaliado**, o outro campo representa o **Score**, que é a nota média de **avaliação dada por usuários** por categoria.
**Por exemplo**, a categoria *Atendimento* apresenta um Score *X,* enquanto a categoria *Emissão de faturas*, tem Score *Y*.
Em operações de **divisão** também são feitos cálculos de divisão entre os valores extras dos dois eventos, o resultado é exibido em percentual.
**Exemplo:** (Ocorrências de extras do evento1 / Ocorrências de extras do evento2) \* 100
* O valor "1" ocorreu 180% vezes no extra1 do evento 1 em relação ao evento2
* O valor "0" ocorreu 50% vezes no extra1 do evento 1 em relação ao evento2
* O valor "escolha2" ocorreu 400% vezes no extra2 do evento 1 em relação ao evento2
* O valor "escolha1" ocorreu 50% vezes no extra2 do evento 1 em relação ao evento2
* 8 disparos do evento 1 possuem valor de extra1 que não existem no evento 2
Nas demais **operações, soma, subtração e multiplicação,** o campos extra1 e extra2 mostram o **total de ocorrência de seus valores.**
{% hint style="info" %}
São mostrados apenas os 20 valores mais recorrentes nesses campos e a quantidade de ocorrências
{% endhint %}
### **Boas práticas**
Acesse a aba de [Boas Práticas](/boas-praticas.md) e aprenda a configurar eventos de forma assertiva, além de ver dicas e exemplos de eventos personalizados.