Depois de ativar um fluxo, uma pergunta aparece cedo ou tarde: "o que aconteceu com este cliente?" Ele entrou? Está esperando? A mensagem saiu? Este artigo mostra como responder a isso em poucos cliques, usando o diálogo Execuções do fluxo.
Antes de começar: só aparecem aqui clientes que já entraram no fluxo. Se o cliente nunca entrou, ele não será encontrado nesta busca. Para entender por que alguém não entrou, veja Por que o fluxo não disparou para um cliente.
1. Abra o diálogo Execuções do fluxo
Você tem dois caminhos:
Na lista de fluxos, clique no menu ⋮ da linha do fluxo e escolha Execuções.
Com o fluxo aberto no editor, clique no ícone Execuções do fluxo na barra superior.
2. Busque o cliente
No campo Cliente, clique em Buscar cliente por nome ou e-mail e escolha a pessoa na lista. Lembre-se: a busca só encontra quem já entrou no fluxo.
Ao escolher o cliente, a seção Linha do tempo mostra as execuções dele neste fluxo: "Execuções deste cliente neste fluxo. Abra uma para ver a linha do tempo."
Cada execução aparece com a situação e a data e hora de início. Um mesmo cliente pode ter mais de uma execução, por exemplo uma Em espera e outra Cancelada de um dia anterior.
O que cada situação significa
A situação diz em que ponto a execução está. Estas são as situações que a tela pode mostrar:
Situação | Em linguagem simples |
Em andamento | O cliente está percorrendo o fluxo agora. |
Enviando | O fluxo está no momento de enviar uma mensagem para o cliente. |
Aguardando evento | O fluxo parou num passo que espera algo acontecer, como uma resposta do cliente. |
Em espera | O cliente está num passo de espera (a ação Esperar) e seguirá quando o tempo acabar. |
Agendada | A execução está marcada para continuar mais tarde. |
Concluída | O cliente terminou o fluxo. |
Falhou | Algo deu errado e a execução não seguiu como esperado. |
Erro | Também indica um problema na execução. |
Encerrada | A execução foi encerrada. |
Cancelada | A execução foi interrompida antes de terminar. |
Expirada | A execução chegou ao fim por tempo. |
Pense assim: Em andamento, Enviando, Aguardando evento, Em espera e Agendada são execuções em que o cliente ainda está no fluxo. É isso que o cartão Contatos em fluxo da lista de fluxos conta. As demais são execuções que já terminaram ou foram interrompidas.
Atenção: a diferença exata entre Falhou e Erro, e entre Encerrada, Cancelada e Expirada, ainda está sendo validada. Se uma dessas aparecer e você precisar de certeza sobre o motivo, abra a linha do tempo da execução (próximo passo) ou fale com o suporte.
3. Leia a linha do tempo da execução
Clique em uma execução da lista. O diálogo mostra a Linha do tempo da execução, com a Situação da execução no topo e os eventos em ordem, do mais antigo para o mais recente.
No exemplo da imagem, a execução conta esta história:
Espera iniciada — Esperar: o cliente chegou ao passo Esperar e a contagem começou.
Espera concluída — Esperar, com Saída: Continuar: o tempo de espera acabou e o fluxo seguiu em frente.
Adiada — Enviar SMS: o envio de SMS não saiu na hora. A própria tela explica: "A etapa ficou para depois e o fluxo seguirá dela quando a condição de espera for satisfeita." E mostra o motivo: "Fora da janela de envio configurada no fluxo."
Por que um envio aparece como "Adiada"?
"Adiada" não é erro. No exemplo acima, o horário do envio caiu fora da janela de execução do fluxo. Quando isso acontece, mensagens e outras ações que têm efeito fora da Martz esperam a próxima abertura da janela. Em um fluxo novo, a janela vem ligada, todos os dias, das 08:00 às 20:00, no fuso de São Paulo.
Se você quer que o fluxo envie em outros horários, ajuste a Janela de execução em Configurações do fluxo. Veja Configurações do fluxo.
4. Veja o caminho no canvas
Na linha do tempo da execução, clique em Ver no canvas. O fluxo abre no editor, em modo somente leitura, mostrando a versão que rodou para aquele cliente, com o caminho percorrido marcado.
A faixa no topo
Uma faixa azul avisa que você está vendo uma execução. Ela mostra: Visualizando execução de (nome do cliente), a versão que rodou, se essa versão está publicada atualmente, a situação da execução e se a tela está ao vivo, com o horário da última atualização.
Dois botões ficam na faixa:
Trocar execução: permite escolher outra execução para visualizar.
Voltar ao editor: sai do modo execução e volta a editar o fluxo.
Enquanto você visualiza uma execução, o botão Ativo/Inativo fica desabilitado, com o aviso "Indisponível enquanto você visualiza uma execução." Isso evita que você mude o fluxo sem querer.
O painel "Eventos da execução"
O painel lateral tem duas partes.
Resumo:
Campo | O que mostra |
Início | Quando o cliente entrou no fluxo. |
Fim | Quando a execução terminou. Fica em branco (—) enquanto ela não terminou. |
Duração | Quanto tempo a execução levou. Se ainda está rodando, aparece algo como "34 min até agora". |
Versão | Qual versão do fluxo rodou. |
Passos | Quantas etapas do fluxo já foram processadas. |
Caminhos | Por quantos caminhos o cliente está passando ao mesmo tempo. Na maioria dos fluxos simples é 1. |
Linha do tempo: os mesmos eventos do diálogo, agora do lado do canvas. O primeiro costuma ser como o cliente entrou, por exemplo Entrou pelo gatilho «Pedido pago».
Como ler os cartões e as setas
Os cartões do caminho percorrido aparecem marcados. No exemplo, o cartão Esperar traz a etiqueta Espera concluída e o cartão Enviar SMS, onde o cliente está agora, aparece destacado.
Um cartão pode estar em estados como: já passou, é onde o cliente está agora, falhou, foi bloqueado, foi pulado ou foi interrompido.
As setas mostram qual caminho foi seguido, qual está aguardando e qual não foi tomado.
Em execuções mais antigas, algumas setas podem aparecer tracejadas, com a indicação Ramo deduzido: significa que o caminho foi deduzido, e não registrado passo a passo.
Atualização automática
Enquanto a execução está viva (rodando, enviando, aguardando um evento, em espera ou agendada), a tela se atualiza sozinha, a cada poucos segundos. Você não precisa recarregar a página.
O que você não vai ver aqui
A visualização de execução existe para mostrar o caminho, não o conteúdo. Por isso ela não mostra:
o texto da mensagem que foi enviada ao cliente;
dados técnicos internos da execução;
dados sensíveis, que, quando aparecem, podem vir ocultados (por exemplo, como
[REDACTED_LGPD_30D]).
Além disso, o histórico de execuções fica disponível por tempo limitado. Uma execução antiga pode aparecer sem alguns detalhes. Se você precisa auditar algo antigo, faça isso o quanto antes.
Checklist: validei meu fluxo?
Use esta lista logo depois de ativar um fluxo e na primeira vez que ele rodar para um cliente real.
Antes de ativar, leia o diálogo Deseja ativar este fluxo? Confira os gatilhos que serão ativados, o Início e o Fim, a Janela de execução e os Canais. Se aparecer o alerta de que outro fluxo ativo usa o mesmo gatilho, lembre que o mesmo cliente pode entrar nos dois e receber mensagens repetidas.
Espere o primeiro cliente entrar e abra Execuções do fluxo (menu ⋮ › Execuções).
Busque o cliente por nome ou e-mail. Se ele não aparece, ele ainda não entrou: veja Por que o fluxo não disparou para um cliente.
Confira a situação da execução. Em espera e Aguardando evento são normais quando o fluxo tem esperas.
Abra a linha do tempo e confira: o gatilho que o fez entrar foi o esperado? As esperas duraram o previsto? Algum envio aparece como Adiada? Qual é o motivo?
Clique em Ver no canvas e confirme que o caminho percorrido é o que você desenhou, e que a versão é a que você queria (veja se aparece publicada atualmente).
Olhe os horários. Envios fora da janela de execução ficam adiados até a janela abrir. Se isso não era o que você queria, ajuste a janela.
Dias depois, confira os números do fluxo em Estatísticas do fluxo. Lembre que, para a receita do fluxo aparecer, o interruptor Ativar atribuição de conversão precisa estar ligado em Configurações do fluxo.
Algo não saiu como esperado?
Para saber o que mudou no fluxo e quem alterou, veja Como ver e auditar alterações do fluxo.
Para entender os problemas mais comuns, veja Solução de problemas.
Se mesmo assim o caso continuar sem explicação, fale com o suporte e informe o nome do fluxo, o cliente (sem enviar dados pessoais por canais abertos) e o horário aproximado.