WalkMe não está carregando em um iFrame

Last Updated junho 12, 2026

Problema

O conteúdo do WalkMe não é carregado dentro de um iFrame.

Solução

A correção depende se o iFrame é do mesmo domínio ou entre domínios. Comece identificando o URL do iFrame e siga as etapas relevantes abaixo.

Encontrando o URL do iFrame

O URL do iFrame nem sempre está visível no HTML do site. Use o console do navegador para encontrá-lo. Isso também é útil ao configurar as etapas do Switch para Frame para confirmar que suas regras de URL não se aplicarão a outros iFrames.

No Chrome:

  1. Clique com o botão direito do mouse em um elemento dentro do iFrame e selecione Inspecionar
  2. Vá para a guia Console — você será automaticamente colocado no console do iFrame do elemento que você inspecionou
  3. Digite document.URL e pressione Enter
  4. O URL retornado é o URL de origem desse iFrame

No Firefox:

  1. Clique com o botão direito do mouse em um elemento dentro do iFrame e selecione Inspecionar
  2. Na guia Elemento, localize o iFrame e anote seu nome, ID, classe ou qualquer outro atributo exclusivo
  3. Ir para a guia Console
  4. Abra o menu suspenso e selecione o iFrame que corresponde ao que você viu na guia Elemento
  5. Digite document.URL e pressione Enter
  6. O URL retornado é o URL de origem desse iFrame

iFrame do mesmo domínio

Se o iFrame for do mesmo domínio, você não precisará adicionar o snippet do WalkMe novamente, desde que ele já esteja presente no frame superior.

Se quiser ancorar a um elemento dentro do iFrame do mesmo domínio usando jQuery em vez de um elemento na tela, será necessário configurar o iFrame jQuery.

iFrame entre domínios

Se o iFrame for cross-domain, o snippet do WalkMe precisará estar presente no próprio iFrame.

Se você estiver usando uma extensão, entre em contato com seu Gerente de Sucesso do Cliente ou com o contato do WalkMe para garantir que o domínio do iFrame seja adicionado ao self-regex do pacote correto.

Verificando se o snippet do WalkMe está presente no iFrame

  1. No console do iFrame, digite _walkmeInternals e pressione Enter
  2. Se o resultado for indefinido, o snippet não estará disponível e precisará ser adicionado
  3. Se o resultado retornar um objeto, o WalkMe estará carregando corretamente dentro do iFrame

Incompatibilidade entre iFrame e UUID entre domínios

Ao usar o Smart Walk-Thru com iFrames entre domínios, o Smart Walk-Thru pode falhar na etapa Switch to Frame se o UUID dentro do iFrame não corresponder ao UUID no frame de nível superior (pai).

O que verificar se o seu SWT falha no Switch to Frame:

  • Confirme se o iFrame de destino é entre domínios
  • Compare o UUID no iFrame com o UUID no frame pai.
  • Se os UUIDs não corresponderem, essa incompatibilidade será a causa provável da falha

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
×