O Smart Walk-Thru está sendo quebrado

Last Updated dezembro 9, 2025

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 marca de seleção verde ao lado disso dizendo "Etapa executada" quando passar o mouse sobre a página:

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.

iFrames e Condições de Mudança para Condições de Quadro

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? É apenas uma interrupção no sistema? 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 # 1 - se o fluxo estiver funcionando conforme esperado quando executado no Editor através do modo de visualização, isso pode indicar um problema com o WalkMe 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 forem diferentes entre Produção e Controle de Qualidade/sandbox, você vai querer confirmar se o URL da etapa Switch to Frame foi configurado corretamente. Se não tiver certeza, tente selecionar novamente o elemento no iFrame para gerar uma nova etapa Alternar para Frame. Se o fluxo continuar a funcionar corretamente depois disso, você poderá substituir a etapa STF ou atualizar a regra de URL para corresponder à regra de funcionamento.

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 executar o fluxo com sucesso no modo de pré-visualização do Editor, mas não conseguir executá-lo até o final quando ele for publicado.

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

Divisões/Ciclos de Erro 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 condição de "Esperar por" antes de cada ciclo 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 estão corretamente no lugar? 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
×