Corrigir Imagem de Pré-visualização Quebrada ao Compartilhar Página do Notion no Slack
🔍 WiseChecker

Corrigir Imagem de Pré-visualização Quebrada ao Compartilhar Página do Notion no Slack

Ao compartilhar um link de página do Notion no Slack, uma imagem de pré-visualização geralmente aparece para ajudar os colegas a identificar o conteúdo rapidamente. Uma imagem quebrada — mostrando uma caixa cinza ou um ícone genérico — faz o link parecer pouco profissional e reduz as taxas de clique. Esse problema ocorre porque o Slack não consegue buscar os metadados Open Graph corretos da página, geralmente devido a configurações de privacidade, falta de imagem de capa ou problemas de cache. Este artigo explica por que a pré-visualização quebra e fornece um conjunto completo de etapas para restaurar a imagem de pré-visualização adequada para qualquer página do Notion compartilhada via Slack.

Principais Conclusões: Como Corrigir a Pré-visualização Quebrada de uma Página do Notion no Slack

  • Configuração de visibilidade da página (Compartilhar > Publicar): O Slack só pode gerar uma pré-visualização para páginas publicadas publicamente ou compartilhadas via link público.
  • Imagem de capa na página do Notion: O Slack usa a imagem de capa da página como miniatura da pré-visualização; uma página sem imagem de capa mostrará um ícone genérico.
  • Cache de links do Slack (comando unfurl): Mesmo após corrigir a página, o Slack pode exibir uma pré-visualização desatualizada até que você force uma atualização do cache colando a URL com ?refresh=1 anexado.

ADVERTISEMENT

Por que o Slack Mostra uma Imagem de Pré-visualização Quebrada para uma Página do Notion

O Slack gera pré-visualizações de links buscando metadados Open Graph (OG) da URL que você cola. Para uma página do Notion, esses metadados incluem o título, a descrição e uma imagem de pré-visualização. A imagem de pré-visualização é retirada da imagem de capa da página — o banner grande no topo da página. Se a página não tiver imagem de capa, o Slack não encontra uma imagem OG e exibe um placeholder quebrado ou genérico.

Além disso, o Slack só pode acessar os metadados de páginas que são publicamente acessíveis. Se a página do Notion for compartilhada exclusivamente com membros do workspace ou via um link de convidado privado, o bot do Slack pode receber uma tela de login em vez dos metadados OG. O bot então recorre a uma pré-visualização quebrada ou nenhuma imagem.

Uma terceira causa é o cache agressivo de links do Slack. Depois que o Slack busca metadados para uma URL, ele armazena esses dados por até 24 horas. Se você alterar a imagem de capa ou o título da página depois de compartilhar o link, o Slack continua mostrando a pré-visualização antiga — ou nenhuma — até que o cache expire ou você force uma atualização.

Etapas para Corrigir a Imagem de Pré-visualização Quebrada

  1. Adicione ou altere a imagem de capa na página do Notion
    Abra a página do Notion no navegador. Passe o mouse sobre a área superior da página e clique em Adicionar Capa. Escolha uma imagem da galeria do Notion ou faça upload da sua própria. A imagem de capa deve ter pelo menos 400 por 300 pixels para garantir que o Slack possa gerar uma miniatura clara. Se já existir uma imagem de capa, mas a pré-visualização estiver quebrada, substitua-a por uma imagem diferente para redefinir os metadados OG.
  2. Publique a página publicamente ou altere as configurações de compartilhamento
    Clique no botão Compartilhar no canto superior direito da página do Notion. Em Compartilhar na web, ative Acesso público. O Slack exige acesso público para buscar a imagem de pré-visualização. Se você não puder tornar a página pública devido a políticas do workspace, precisará usar um método de compartilhamento diferente — links de convidado privados não gerarão imagens de pré-visualização no Slack.
  3. Copie o link publicado do Notion
    Após ativar o acesso público, copie o link mostrado em Compartilhar na web. Essa URL é diferente do link interno do workspace. Use essa URL pública ao colar no Slack. Se você colou o link interno anteriormente, substitua-o pela URL pública.
  4. Cole o link no Slack e force uma atualização do cache
    Cole a URL pública do Notion em uma mensagem do Slack. Se a pré-visualização ainda aparecer quebrada, anexe ?refresh=1 ao final da URL e envie a mensagem novamente. Por exemplo: https://www.notion.so/sua-pagina-123?refresh=1. Esse parâmetro força o Slack a buscar metadados OG atualizados em vez de usar a versão em cache.
  5. Remova e cole novamente o link se a pré-visualização não atualizar
    Exclua a mensagem que contém o link. Aguarde 30 segundos e cole a URL novamente — desta vez sem o parâmetro ?refresh=1. O Slack buscará os metadados novamente a partir de um estado limpo. A imagem de pré-visualização agora deve aparecer corretamente.

ADVERTISEMENT

Se a Imagem de Pré-visualização Ainda Aparecer Quebrada Após a Correção Principal

O Slack armazenou em cache os metadados antigos por mais de 24 horas

O Slack armazena em cache as pré-visualizações de links por até 24 horas. Se você seguiu todas as etapas e a pré-visualização ainda permanece quebrada, aguarde até que o cache expire naturalmente. Para acelerar o processo, você pode usar o truque ?refresh=1 descrito acima. Alguns usuários também relatam sucesso ao colar a URL em um canal privado primeiro e depois movê-la para o canal de destino.

A imagem de capa contém formato ou tamanho de arquivo não suportado

O Slack suporta imagens JPEG, PNG e GIF. Se sua imagem de capa for um arquivo BMP, TIFF ou SVG, o Slack não pode usá-la como pré-visualização. Converta a imagem para JPEG ou PNG e faça o upload novamente na página do Notion. Certifique-se também de que a imagem tenha pelo menos 400 pixels de largura — imagens muito pequenas podem ser ignoradas pelo analisador OG do Slack.

A página do Notion está dentro de um workspace privado que bloqueia o acesso externo

Alguns workspaces do Notion têm configurações de administrador que impedem que qualquer página seja publicada publicamente. Se você não puder ativar o acesso público, a pré-visualização nunca funcionará no Slack. Nesse caso, considere compartilhar uma captura de tela do conteúdo da página diretamente no Slack ou use a integração Compartilhar no Slack do Notion, que envia uma mensagem formatada com uma pré-visualização gerada pelo próprio bot do Notion, em vez do analisador OG do Slack.

As políticas do workspace do Slack bloqueiam pré-visualizações de links externos

Alguns workspaces do Slack desabilitam pré-visualizações de links para domínios externos para melhorar a segurança ou reduzir distrações. Peça ao administrador do seu workspace do Slack para verificar a seção Configurações e Permissões > Pré-visualizações de Links. Se as pré-visualizações estiverem desabilitadas para todos os domínios externos, nenhuma página do Notion mostrará uma imagem de pré-visualização, independentemente das suas configurações.

Opções de Compartilhamento de Página do Notion: Público vs Workspace vs Convidado

Método de Compartilhamento Imagem de Pré-visualização no Slack Nível de Acesso
Público (Compartilhar na web) Funciona — metadados OG estão totalmente acessíveis Qualquer pessoa com o link pode ver a página
Apenas membros do workspace Quebrada — o bot do Slack não pode fazer login Apenas membros do seu workspace do Notion
Link de convidado (privado) Quebrada — o bot do Slack não pode autenticar Pessoas específicas convidadas por e-mail

Apenas o método de compartilhamento Público gera uma imagem de pré-visualização funcional no Slack. Se a política do seu workspace ou o conteúdo da página impedir o compartilhamento público, você precisará usar métodos de comunicação alternativos, como incorporar o conteúdo da página diretamente no Slack usando a integração do Notion com o Slack.

Agora você pode corrigir uma imagem de pré-visualização quebrada para qualquer página do Notion compartilhada no Slack. Comece adicionando uma imagem de capa e ativando o acesso público, depois cole a URL pública com ?refresh=1 para limpar o cache do Slack. Para problemas persistentes, verifique se o seu workspace do Slack bloqueia pré-visualizações de links externos ou se o seu workspace do Notion restringe a publicação pública. Como dica avançada, use a integração Compartilhar no Slack do Notion a partir do menu Compartilhar para enviar uma mensagem formatada que inclui uma pré-visualização gerada pelo próprio servidor do Notion, ignorando completamente o analisador OG do Slack.

ADVERTISEMENT