> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/evento.md).

# Evento

O módulo **Evento** registra um evento personalizado durante o fluxo, permitindo monitorar e automatizar operações em tempo real com base em dados definidos por você.

{% hint style="info" %}
Antes de usar este módulo, o evento precisa ser **cadastrado previamente** na tela **Eventos**, onde você define o nome, a descrição e os campos personalizados (texto, número, data, seleção ou verdadeiro/falso) que fazem parte dele.
{% endhint %}

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **Evento** para a área de trabalho do fluxo.

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter o recurso de **Analytics** habilitado no seu ambiente, além de ter pelo menos um evento já cadastrado na tela **Eventos**.
{% endhint %}

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

### 🏷️ Evento

Selecione o evento já cadastrado que deseja registrar. Ao selecionar, o nome e a descrição do evento são exibidos, junto com um link para ver os detalhes do evento na tela de cadastro.

### 📋 Campos

Após selecionar o evento, os campos personalizados definidos no cadastro dele aparecem automaticamente para você preencher — podendo ser texto, número, data, seleção entre opções ou verdadeiro/falso. Você pode usar variáveis do fluxo nesses campos.

{% hint style="warning" %}
Preencha sempre os campos do evento corretamente. Alguns tipos de campo (como número, data e seleção) são validados apenas no momento da execução do fluxo — um valor inválido pode fazer o módulo seguir pela saída de Erro.
{% endhint %}

### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — o evento foi registrado com sucesso.
* **Erro** — não foi possível registrar o evento (por exemplo, evento não encontrado, Analytics não habilitado, ou limite de créditos atingido).

## 💰 Sobre a cobrança

O registro de eventos é cobrado à parte, dependendo do seu plano:

* Em planos por **conversa**, os eventos entram na cota de conversas do seu plano.
* Em planos por **mensagem**, você tem direito a **100 eventos gratuitos por mês**. A partir do 101º evento no mês, é cobrado **R$ 0,01 por evento registrado**, descontado do saldo da sua conta.

## 💡 Caso de uso

**Cenário:** uma empresa quer acompanhar, em tempo real, quantos clientes concluem uma determinada etapa importante do atendimento.

**Configuração:**

1. Cadastre um evento na tela **Eventos**, com um campo de texto para identificar a etapa concluída.
2. Adicione o módulo **Evento** ao fluxo, no ponto em que a etapa é concluída.
3. Selecione o evento cadastrado e preencha o campo com a informação da etapa.
4. Conecte a saída **Sucesso** para dar continuidade ao atendimento.

**Resultado:** a empresa passa a acompanhar, em tempo real, quantos clientes completam essa etapa do atendimento.

## 📌 Dicas úteis

* Cadastre o evento e seus campos com atenção — depois de criado, os campos existentes não podem ser removidos ou alterados, apenas novos campos podem ser adicionados.
* Sempre conecte a saída **Erro** a algum tratamento, já que o registro do evento pode falhar por diversos motivos.
* Acompanhe o consumo de eventos gratuitos e a cobrança adicional, especialmente em fluxos de alto volume.

## 📝 Resumo

* O módulo **Evento** registra um evento personalizado, previamente cadastrado, para monitoramento e automação.
* Os campos disponíveis dependem do cadastro do evento escolhido.
* O registro pode gerar cobrança adicional após 100 eventos gratuitos por mês, em planos por mensagem.
* O módulo tem uma saída de **Sucesso** e uma de **Erro**.