Você incorporou um Perplexity Space no seu site ou intranet usando um iframe, mas o espaço mostra uma área em branco, um spinner de carregamento que nunca termina ou uma mensagem de erro. Isso geralmente acontece porque as configurações de incorporação do Space restringem o acesso a domínios específicos ou porque seu navegador bloqueia conteúdo de origem cruzada. Este artigo explica a causa técnica do problema e fornece três correções passo a passo para fazer seu Space incorporado funcionar novamente.
Principais conclusões: Corrigindo falhas de carregamento do iframe do Perplexity Space
- Space > Compartilhar > Configurações de Incorporação > Domínios Permitidos: Adicione o domínio do seu site à lista de permissões para que o iframe possa carregar o conteúdo.
- Ferramentas do Desenvolvedor do Navegador > Console: Verifique se há erros de origem cruzada que indicam uma solicitação bloqueada.
- Space > Compartilhar > Configurações de Incorporação > Acesso Público: Defina o Space como “Qualquer pessoa com o link” se os visitantes do seu site não estiverem logados no Perplexity.
Por que o iframe do Perplexity Space não carrega
Os Perplexity Spaces são projetados com restrições de segurança que impedem que sites não autorizados os incorporem. Quando você incorpora um Space usando um iframe, o navegador envia uma solicitação aos servidores do Perplexity. O servidor verifica o cabeçalho Referer da solicitação para ver se o domínio de incorporação é permitido. Se o domínio não estiver na lista de permissões do Space, o servidor retorna uma página em branco ou um erro de origem cruzada. Além disso, se o Space estiver definido como privado ou restrito apenas a usuários logados, os visitantes que não estiverem autenticados verão um iframe vazio. A Política de Segurança de Conteúdo (CSP) do navegador ou o bloqueio de cookies de terceiros também podem impedir a renderização do iframe.
Bloqueio de Compartilhamento de Recursos de Origem Cruzada (CORS)
Navegadores modernos aplicam políticas CORS que restringem como uma página da web pode solicitar recursos de um domínio diferente. Se o seu site é example.com e o servidor do Perplexity é perplexity.ai, o navegador trata isso como uma solicitação de origem cruzada. O servidor do Perplexity deve incluir o cabeçalho Access-Control-Allow-Origin com seu domínio. Esse cabeçalho só é adicionado quando seu domínio está na lista de permissões do Space. Sem ele, o navegador bloqueia o conteúdo do iframe.
Exigência de Autenticação
Spaces configurados como “Apenas pessoas específicas” ou “Qualquer pessoa com o link (exige login)” não carregam para visitantes anônimos. O iframe tenta carregar o Space, mas o Perplexity redireciona para uma página de login. A página de login não pode ser renderizada dentro do iframe devido aos cabeçalhos X-Frame-Options. O resultado é um iframe em branco ou um erro de redirecionamento.
Passos para corrigir o iframe do Perplexity Space incorporado
Siga estes passos em ordem. Teste o iframe após cada etapa para verificar se o problema foi resolvido.
- Verifique as configurações de incorporação do Space
Abra o Perplexity Space que deseja incorporar. Clique no botão Compartilhar no canto superior direito. Na caixa de diálogo Compartilhar, clique em Incorporar. Em Domínios Permitidos, certifique-se de que o domínio do seu site esteja listado. Por exemplo, se seu site éwww.example.com, digitewww.example.come clique em Adicionar. Se você usa vários subdomínios, adicione cada um separadamente. Clique em Salvar. - Defina o Space como acesso público
Na mesma caixa de diálogo Compartilhar, verifique a configuração de Acesso. Escolha Qualquer pessoa com o link e desative a opção Exigir login. Isso permite que todos os visitantes visualizem o Space sem fazer login no Perplexity. Clique em Salvar. - Copie o código de incorporação novamente
Após alterar as configurações, clique em Copiar Código de Incorporação. Substitua o código iframe antigo em seu site pelo novo. O novo código inclui a lista de domínios permitidos e as configurações de acesso atualizadas. - Limpe o cache do navegador e teste
Abra uma janela privada ou anônima. Navegue até a página onde o iframe está incorporado. Se o Space carregar, a correção está completa. Se ainda falhar, prossiga para a próxima etapa. - Verifique o console do navegador em busca de erros
Na janela normal do navegador, pressione F12 para abrir as Ferramentas do Desenvolvedor. Clique na aba Console. Recarregue a página. Procure por mensagens de erro contendoAccess-Control-Allow-Origin,CORSouX-Frame-Options. Essas mensagens indicam exatamente qual domínio ou política está bloqueando o iframe.
Se o iframe ainda não carregar após a correção principal
Alguns sites têm sua própria Política de Segurança de Conteúdo que bloqueia iframes de fontes externas. Talvez seja necessário ajustar os cabeçalhos CSP do seu site para permitir iframes de perplexity.ai e todos os subdomínios. Adicione a seguinte diretiva à configuração do servidor ou ao arquivo .htaccess:
Content-Security-Policy: frame-src 'self' https://perplexity.ai;
Se você usa um CMS como WordPress, instale um plugin de segurança que permita modificar cabeçalhos HTTP. Adicione a mesma diretiva frame-src nas configurações de CSP do plugin.
Se o embed do Perplexity Space ainda tiver problemas
Se o iframe permanecer em branco após seguir todos os passos, verifique estes fatores adicionais.
Cookies de terceiros estão bloqueados
O Perplexity usa cookies para manter o estado da sessão. Alguns navegadores bloqueiam cookies de terceiros por padrão. Instrua os visitantes do seu site a adicionar perplexity.ai à lista de cookies de terceiros permitidos nas configurações do navegador. Alternativamente, você pode orientar os visitantes a fazer login no Perplexity em uma aba separada antes de visualizar o Space incorporado.
Atributo sandbox do iframe restringe o conteúdo
Se você adicionou o atributo sandbox à tag iframe, ele pode bloquear scripts ou formulários necessários para o Perplexity. Remova o atributo sandbox ou adicione o valor allow-scripts allow-same-origin allow-forms. A tag iframe atualizada deve ficar assim:
<iframe src="https://www.perplexity.ai/s/seu-id-do-space" allow="clipboard-read; clipboard-write"></iframe>
Space contém arquivos grandes ou conversas longas
Spaces com muitas páginas ou arquivos grandes anexados podem demorar mais para carregar. O iframe pode parecer em branco até que o conteúdo termine de carregar. Aguarde pelo menos 10 segundos. Se o Space ainda não aparecer, reduza a quantidade de conteúdo no Space removendo páginas ou arquivos não utilizados.
Embed do Perplexity Space: Acesso Público vs Acesso Restrito
| Item | Acesso Público (Qualquer pessoa com o link) | Acesso Restrito (Exige login) |
|---|---|---|
| Autenticação do visitante | Não é necessária | Necessária — o visitante deve fazer login no Perplexity |
| Carregamento do iframe em sites externos | Funciona se o domínio for permitido | Falha — o redirecionamento de login é bloqueado por X-Frame-Options |
| Melhor caso de uso | Sites públicos, blogs, bases de conhecimento | Wikis internos onde todos os usuários têm contas Perplexity |
| Risco de segurança | Qualquer pessoa com o link pode visualizar o Space | Apenas usuários autenticados com acesso podem visualizar |
Se você precisa incorporar um Space em um site público, sempre use Acesso Público. Para ferramentas internas onde todos os visitantes têm uma conta Perplexity, o Acesso Restrito é aceitável, mas exige que os usuários façam login primeiro em uma aba separada.
Conclusão
Agora você pode corrigir um iframe do Perplexity Space que não carrega adicionando seu domínio à lista de Domínios Permitidos e definindo o Space como Acesso Público. Sempre copie o código de incorporação após alterar essas configurações. Para problemas persistentes, verifique os erros no console do navegador e ajuste a Política de Segurança de Conteúdo do seu site para permitir frames de perplexity.ai. Se o seu site usar uma CSP restritiva, a diretiva frame-src é a maneira mais confiável de garantir que o iframe seja renderizado corretamente.