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ê.

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.

🧭 Como acessar

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

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.

🔍 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.

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.

🔀 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:

Cadastre um evento na tela Eventos, com um campo de texto para identificar a etapa concluída.
Adicione o módulo Evento ao fluxo, no ponto em que a etapa é concluída.
Selecione o evento cadastrado e preencha o campo com a informação da etapa.
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.