Pular para o conteúdo principal

Bloco: Incorporação externa (`externalEmbed`)

CampoValor
Identificador do tileexternalEmbed
Rótulo no painelIncorporação externa / Einbettung
Categoriabasic
Tamanhosembedded

O tile de incorporação externa exibe uma ferramenta de reservas ou outra página de terceiros diretamente em um aplicativo web publicado. Os aplicativos iOS e Android instalados renderizam o mesmo iframe restrito dentro do WebView do Capacitor.

Entradas aceitas​

O painel aceita uma destas opções:

  • Uma URL HTTPS pública.
  • Uma marcação contendo um iframe com um atributo src entre aspas.

Somente a URL normalizada do iframe é armazenada. Scoutello ignora largura, altura, estilos, permissões, configurações de sandbox, manipuladores de eventos, scripts e toda a marcação ao redor fornecida pelo provedor. Endereços HTTP, credenciais, portas personalizadas, endereços IP, hosts locais ou internos, hosts controlados por Scoutello e código de iframe malformado são rejeitados. Scoutello não acessa, resolve, captura uma imagem nem faz qualquer outra sondagem da URL enviada.

O painel exibe uma prévia de configuração local e deliberadamente não entra em contato com o provedor. Teste o resultado real no aplicativo web publicado.

Carregamento, privacidade e permissões​

O iframe é carregado automaticamente e de forma lazy quando se aproxima da área visível. Isso pode entrar em contato com o provedor terceirizado antes que a pessoa visitante interaja com o tile. Não há um fluxo integrado de clique para carregar nem de gerenciamento de consentimento.

Antes de salvar, a organização deve confirmar que o provedor é confiável e que todos os avisos de privacidade ou mecanismos de consentimento necessários foram providenciados. Essa confirmação registra uma decisão de configuração; não constitui consentimento da pessoa visitante.

As alturas para dispositivos móveis e computadores podem ser definidas entre 240 e 1.600 pixels. Os valores padrão são 640 pixels em dispositivos móveis e 720 pixels em computadores. Os recursos de pagamento e tela cheia do navegador são opcionais e ficam desativados por padrão. Câmera, microfone, geolocalização, área de transferência, downloads e navegação de nível superior nunca são concedidos.

O runtime usa configurações de sandbox e política de referenciador definidas pelo código. Tokens de sandbox ou de permissão fornecidos pela clientela nunca chegam ao iframe renderizado. Consulte a especificação de iframe da WHATWG para entender a semântica de sandbox do navegador.

Limitações de incorporação​

Os provedores podem proibir a incorporação usando uma diretiva de Política de Segurança de Conteúdo frame-ancestors ou um cabeçalho X-Frame-Options. Como os navegadores não expõem detalhes confiáveis sobre falhas de incorporação entre origens, Scoutello não pode verificar a compatibilidade no painel nem distinguir sempre uma recusa do provedor de uma página vazia do provedor.

Se uma configuração salva se tornar inválida, a experiência da pessoa visitante exibirá um estado de erro seguro e localizado e, quando possível, uma alternativa para abrir o conteúdo externamente.

Provedores que exigem scripts​

Scripts arbitrários de provedores não podem ser executados em uma página Scoutello. Um envio contendo apenas um script é bloqueado e oferece a opção Solicitar integração com o provedor. A solicitação coleta o nome do provedor, a URL da documentação pública, o caso de uso pretendido e um exemplo de script. Remova segredos, credenciais privadas e dados pessoais antes de enviá-la.

O exemplo de script é armazenado somente como texto simples de uma solicitação de suporte e nunca é renderizado nem executado. A aprovação não libera esse trecho. Ela gera uma tarefa de produto para um adaptador de provedor analisado, hospedado em um documento em sandbox em uma origem sem cookies e registrável separadamente, com uma Política de Segurança de Conteúdo específica do provedor e mensagens verificadas quanto à origem. Isso segue as orientações da OWASP para JavaScript de terceiros.

Checklist de suporte​

  • Confirme que o endereço usa HTTPS público e pertence ao provedor pretendido.
  • Confirme que o provedor permite a incorporação de iframe na origem publicada.
  • Ative o pagamento ou a tela cheia somente quando a documentação do provedor exigir.
  • Revise os avisos de privacidade e o comportamento do consentimento antes da publicação.
  • Use a solicitação de integração com o provedor para widgets que funcionam apenas com scripts; nunca cole segredos.