Bloco: Incorporação externa (`externalEmbed`)
| Campo | Valor |
|---|---|
| Identificador do tile | externalEmbed |
| Rótulo no painel | Incorporação externa / Einbettung |
| Categoria | basic |
| Tamanhos | embedded |
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
srcentre 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.