O Smart Walk-Thru está apresentando falhas

Last Updated maio 1, 2026

Problema

O meu Smart Walk-Thru está quebrando em uma determinada etapa e não avança para a próxima. Como posso solucionar esse problema?

Solução

Existem alguns cenários que podem fazer com que um Smart Walk-Thru seja interrompido inesperadamente.

Observação:

Familiarize-se com o uso da ferramenta Flow Tracker antes de prosseguir com as etapas de solução de problemas abaixo.

A etapa anterior não foi acionada

Uma causa comum de atraso de fluxos é uma etapa que não é acionada corretamente na sequência, "quebrando" o fluxo.

Para ver se esse é o caso, use o Flow Tracker enquanto o Smart Walk-Thru está sendo executado para ver onde o fluxo para.

Se o fluxo terminar inesperadamente, verifique se a última etapa no rastreador de fluxo aparece como acionada. Se a etapa foi Não é acionado, haverá apenas uma única marca de seleção verde ao lado dela que diz "Etapa Reproduzida" ao passar o mouse:

Se a etapa não foi acionada (como a acima), você pode querer reavaliar como o gatilho está configurado e qual o objetivo que ele está tentando alcançar:

  • Se o gatilho estiver definido para "Clique", os usuários estão sendo claramente instruídos a clicar no elemento relevante?
  • Alterar a precisão do elemento para uma porção "maior" do elemento torna menos provável que o usuário perca o clique?
  • Se o acionador estiver definido como "Atualizar página", a página é atualizada corretamente com a ação solicitada ao usuário?
  • Para gatilhos personalizados, você pode confirmar que as regras estão sendo cumpridas no Mecanismo de Regras?
  • Se a regra estiver configurada com jQuery, ela aparece como "true" quando o elemento jQuery estiver visível na página? Se não, pode ser que o jQuery esteja configurado incorretamente (possivelmente devido a um erro ou uma atualização no site).
  • Alterar a regra para "Elemento na tela" permite que a regra seja exibida como verdadeira? Se houver várias regras configuradas, os operadores entre elas fazem sentido? O operador deve ser "Ou" em vez de "E"?

Se a etapa foi acionada, ela aparecerá com duas marcas de seleção dizendo "Etapa Acionada" quando o mouse passar sobre ela. Se esse for o caso, prossiga com o próximo conjunto de possibilidades de solução de problemas.

A etapa atual não pode encontrar seu elemento

Se você suspeitar que um fluxo está quebrando porque um elemento etapa não pode ser encontrado, você pode usar o Rastreador de Fluxo no ambiente e testar o fluxo para ver onde ele está quebrado.

Se o rastreador de fluxo indicar que a etapa é "pesquisar seu elemento", o elemento pode não ser mais reconhecido porque foi alterado ou atualizado recentemente. Nesse caso, tente selecionar novamente o elemento ou alterar as opções de precisão até que ele seja encontrado novamente de forma consistente. Consulte o guia aqui para obter mais informações.

Condições de iFrames e Mudar para Frame

Se a etapa estiver interrompida após a etapa Switch to Frame, há algumas coisas que você deve considerar:

  1. O fluxo funciona quando executado no Preview? modo do Editor? Está quebrando apenas no ambiente publicado?
  2. Quando o elemento dentro do iFrame foi selecionado, ele foi selecionado originalmente em um ambiente de Controle de Qualidade/sandbox? O fluxo funciona corretamente no ambiente em que foi capturado originalmente?

Para o nº 1 - se o fluxo estiver funcionando como esperado ao ser reproduzido no Editor por meio do modo de Visualização, isso pode indicar um problema com o fato de o WalkMe estar disponível nesse quadro no ambiente publicado.

Se a implementação do WalkMe for baseada em snippet-in-site, entre em contato com o administrador do site para confirmar se o snippet do WalkMe também foi adicionado aos iFrames entre domínios.

Se a implementação do WalkMe for baseada em extensão, entre em contato com o Suporte para ver se a extensão está configurada corretamente para carregar nesse iFrame.

Para #2, se os domínios do iFrame diferirem entre Produção e Controle de Qualidade/sandbox, você desejará confirmar que o URL da etapa Mudar para Frame foi configurado corretamente. Se você não tiver certeza, tente selecionar novamente o elemento no iFrame para gerar uma nova etapa Mudar para Frame. Se o fluxo continuar a funcionar corretamente após isso, você pode substituir a etapa STF ou atualizar a regra de URL para corresponder àquela que está funcionando.

O WalkMe não está carregando na página

Em alguns casos, os fluxos podem parecer interrompidos quando chegam a novas páginas onde o WalkMe não está configurado para carregar.

Esse pode ser o caso se você conseguir reproduzir o fluxo com sucesso no modo de visualização do Editor, mas não conseguir reproduzir até a conclusão quando for publicado.

Consulte o guia aqui para solucionar problemas em que o WalkMe pode não estar carregando.

Divisões/Loop de Erros não funcionando corretamente

Em muitos casos, os Smart Walk-Thrus ficam presos ou seguem pelo caminho não intencional quando certas divisões ou funções de ciclo de erro estão envolvidas. Isso geralmente ocorre quando o ciclo de divisão/erro avalia suas regras antes que todos os elementos relevantes da página tenham tempo suficiente para concluir o carregamento. Isso pode fazer com que uma divisão siga incorretamente o caminho "errado" e procure o elemento da etapa errada depois.

Para evitar isso, adicione uma "Aguardar condição" antes de cada loop de divisão e erro para garantir que os elementos relevantes tenham tempo para carregar antes de prosseguir com o restante do fluxo.

Se os ciclos de divisões/erros ainda não estiverem sendo avaliados corretamente, confirme se as regras configuradas fazem sentido. Elas aparecem como "verdadeiras" no mecanismo de regras quando você está na página onde você esperaria que elas fossem verdadeiras? Se houver várias regras, os operadores aplicados estão corretos? Faria mais sentido "Ou" do que "E" (ou vice-versa)?

Se você ainda estiver tendo problemas com o fluxo Smart Walk-Thru depois de analisar essas opções de solução de problemas, entre em contato com o Suporte para obter mais assistência.

Was this article helpful?

Thanks for your feedback!

Faça parte de algo maior.

Interaja com colegas, tire dúvidas e compartilhe ideias.

Explore nossa comunidade
×