--- title: "Criando eventos personalizados" url: https://ajuda.botconversa.com.br/aula/criando-eventos-personalizados section: "Relatórios e métricas" date_modified: 2026-09-06T18:35:20.325155+00:00 language: pt-BR --- # Criando eventos personalizados [Vídeo da aula](https://www.youtube.com/watch?v=v1EH4W_z_kU) **Tempo de leitura:** ~5 min**Para quem é:** Gestor | Dono do negócio ## Resposta rápida Um **evento personalizado** é um indicador de negócio que **você mesmo cria e nomeia** — por exemplo, "Orçamento enviado", "Venda fechada" ou "NPS respondido". Você cria o evento no Painel de Controle e, dentro de um fluxo, usa um **bloco de Ação** para dispará-lo no momento certo. A partir daí, o evento aparece como um card no painel, contando quantas vezes aconteceu. ## O que é um evento personalizado O painel já mede sozinho coisas como conversas, contatos novos e tempos de resposta. Mas cada negócio tem indicadores **próprios** que o BotConversa não tem como adivinhar: quantos orçamentos você enviou, quantas pessoas chegaram à etapa de pagamento, quantas responderam sua pesquisa. O evento personalizado resolve isso. Você dá um nome a um marco importante do seu negócio e manda o BotConversa contar toda vez que ele acontecer. O resultado vira um card no bloco **Dados** do painel, com a contagem do período, a variação em relação ao período anterior (aqui, **subir é bom** — significa que o evento aconteceu mais vezes) e um mini-gráfico de tendência. Importante: criar o evento **não basta**. Ele só começa a contar depois que você o **vincula a um fluxo** através de um bloco de Ação. Um card que existe mas nunca foi vinculado mostra um ícone de tomada com a mensagem para adicioná-lo ao seu fluxo. ## Antes de começar Para o evento funcionar de ponta a ponta você vai precisar de: - Acesso ao **Painel de Controle** (onde você cria e acompanha o evento). - Um **fluxo de conversa** já existente, onde o marco que você quer medir realmente acontece. Veja [O que são fluxos de conversa](/aula/o-que-sao-fluxos-de-conversa). - Saber **em que ponto do fluxo** o marco ocorre (por exemplo, logo depois do bloco que envia o orçamento ao cliente). ## Passo a passo ### Passo 1: Crie o evento no painel No Painel de Controle, role até o bloco **Dados** e encontre a seção **Eventos personalizados**. No canto superior direito dessa seção, clique no botão **Criar** e dê um **nome claro** ao evento — de preferência, o nome do marco que ele representa, como **Orçamento enviado**. ![Seção de Eventos personalizados no bloco Dados, com o botão Criar destacado](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/06-relatorios/criando-eventos-personalizados/passo-1.png) Seção de Eventos personalizados no bloco Dados, com o botão Criar destacado Pronto, o card aparece na grade. Por enquanto ele estará **vazio**, com um ícone de tomada — porque ainda não foi disparado por nenhum fluxo. ### Passo 2: Abra o fluxo onde o marco acontece Vá em **Fluxos** e abra o fluxo no construtor, no ponto exato onde o marco ocorre. Continuando o exemplo: logo após o bloco que envia o orçamento ao cliente. ### Passo 3: Adicione um bloco de Ação No construtor, adicione um **bloco de Ação** nesse ponto e conecte-o na sequência do fluxo. O bloco de Ação executa tarefas nos bastidores, sem mandar mensagem para o cliente. Veja [Bloco de Ação](/aula/bloco-acao). ![Bloco de Ação no construtor com a ação Adicionar evento personalizado selecionada](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/06-relatorios/criando-eventos-personalizados/passo-2.png) Bloco de Ação no construtor com a ação Adicionar evento personalizado selecionada ### Passo 4: Escolha a ação "Adicionar evento personalizado" Dentro do bloco, clique em **Adicionar Ação**, procure por **Adicionar evento personalizado** na lista e selecione o evento que você criou no Passo 1 (no exemplo, **Orçamento enviado**). Salve o fluxo. ### Passo 5: Acompanhe no painel A partir do próximo cliente que passar por aquele ponto do fluxo, o evento começa a contar. Volte ao Painel de Controle → **Dados** → **Eventos personalizados** e o card mostrará a contagem do período crescendo, com a variação e o mini-gráfico. ## Dicas - Use **nomes claros e específicos**: "Pagamento confirmado" diz muito mais que "Evento 1". - Posicione o bloco de Ação **exatamente** no ponto em que o marco ocorre. Se colocar antes, você vai contar gente que ainda não chegou lá. - Você pode disparar o **mesmo evento em vários fluxos**. Por exemplo, contar "Venda fechada" em todos os fluxos que terminam em venda — o card soma tudo. - Um único bloco de Ação aceita **várias ações empilhadas**. Você pode, no mesmo ponto, disparar o evento e ainda aplicar uma etiqueta, por exemplo. ## Casos de uso **Negócio:** uma assistência técnica quer saber quantos orçamentos envia por mês. Ela cria o evento "Orçamento enviado" e adiciona um bloco de Ação logo depois do bloco que manda o orçamento no fluxo de atendimento. No fim do mês, o card mostra, digamos, 300 orçamentos enviados (número ilustrativo). Cruzando com as vendas, ela passa a saber a taxa de fechamento — algo que o painel não media antes. ## Perguntas frequentes Criei o evento mas o card está vazio. Por quê? Porque ele ainda não foi disparado por nenhum fluxo. Adicione um bloco de Ação com a ação **Adicionar evento personalizado** no fluxo, conforme o passo a passo. Posso medir vendas, orçamentos, pesquisas — qualquer coisa? Sim, desde que esse marco aconteça dentro de um fluxo. O nome é livre e você decide o que ele representa. O evento conta retroativamente? Não. Ele começa a contar a partir do momento em que você vincula o bloco de Ação no fluxo. O que passou antes não entra. Posso editar ou excluir um evento? Sim. Cada card tem um menu (três pontinhos) com as opções de editar e excluir. Cuidado: excluir é definitivo. No card, a setinha para cima é boa ou ruim? Boa. Diferente do card de tempos de atendimento, aqui **subir significa que o evento aconteceu mais vezes** — geralmente o que você quer.