6 min de leituraTutoriais

Prévia de Link Não Aparece? Causas e Como Corrigir

Uma prévia de link é construída a partir das tags Open Graph na página de destino. Por que as prévias quebram no WhatsApp, Facebook, X e Slack - e os passos exatos para corrigir cada uma.

Ana Kowalska
Marketing solutions engineering
Um link sem prévia se transformando em um cartão social completo depois que as tags Open Graph são corrigidas, na paleta de cores do Elido

Uma prévia de link é construída a partir das tags Open Graph no HTML da página de destino - og:title, og:description, og:image e og:url. Quando você cola um link no WhatsApp, Facebook, Slack ou X, o rastreador dessa plataforma busca a página, lê essas tags e renderiza o cartão. Se a prévia não está aparecendo, quase sempre é uma dessas duas coisas: as tags estão ausentes ou quebradas, ou a plataforma armazenou em cache um resultado vazio e ainda o está exibindo.

Esse único fato - a prévia vem do destino, não do link - é o que torna isso corrigível. Você não está depurando a plataforma; está depurando as tags da página e então limpando a memória da plataforma sobre elas. Este guia cobre por que as prévias quebram, as poucas tags que importam, se os links curtos são os culpados (geralmente não são), e a ferramenta exata para atualizar cada plataforma.

Se você também está encurtando o link, como encurtar uma URL cobre esse lado, e a questão do link curto tem sua própria seção abaixo porque é onde as pessoas erram.

As prévias falham por um conjunto pequeno e previsível de razões, e identificá-las é metade da solução.

  • Tags Open Graph ausentes ou malformadas. Sem og:title ou og:image, o rastreador não tem nada para construir um cartão, então você obtém apenas o link. Essa é de longe a causa mais comum.
  • Uma imagem inacessível ou muito grande. A URL do og:image retorna um 404, está atrás de um login ou é grande demais para a plataforma buscar a tempo. O cartão é renderizado sem a imagem, ou não é renderizado de forma alguma.
  • Cache vazio. A plataforma rastreou a URL uma vez antes de as tags existirem, armazenou "sem prévia" e continua exibindo isso até ser forçada a olhar novamente.
  • Renderização somente via JavaScript. A maioria dos rastreadores sociais não executa JavaScript; eles leem o HTML bruto. Se suas tags são injetadas pelo cliente, o rastreador nunca as vê.

Esse último pega aplicativos de página única modernos constantemente. O rastreador solicita o HTML, recebe uma casca vazia e vai embora. O protocolo Open Graph define como as tags devem aparecer no HTML servido, e a solução é sempre garantir que elas estejam no HTML que o rastreador recebe, não adicionadas depois por script.

As tags Open Graph no cabeçalho HTML de uma página - og:title, og:description, og:image, og:url - alimentando um cartão de prévia de link social renderizado

As Tags Open Graph Que Alimentam uma Prévia

Quatro tags fazem quase todo o trabalho. Acerte essas e a maioria das plataformas renderiza um cartão limpo.

og:title é o título do cartão. og:description é a linha de texto abaixo dele. og:image é a imagem - e é a que as pessoas mais frequentemente erram - aponte para uma URL absoluta de uma imagem com aproximadamente 1200x630 pixels, acessível publicamente, não atrás de autenticação. og:url é o endereço canônico da página, o que mantém a prévia estável mesmo quando o link carrega parâmetros de rastreamento.

O X lê sua própria família de tags twitter:card e usa Open Graph como fallback quando elas estão ausentes - é por isso que uma página pode ter uma prévia perfeita no Facebook e aparecer sem formatação no X. A opção segura é incluir ambas: as quatro tags Open Graph mais twitter:card, twitter:title, twitter:description e twitter:image. São algumas linhas de HTML no head da página, e é a diferença entre um cartão que funciona em todos os lugares e um que funciona em apenas um. O Google documenta o comportamento relacionado de rastreadores e tags especiais se você quiser a visão do lado da busca também.

Essa é a pergunta que leva as pessoas ao blog de um encurtador de URL, e a resposta é tranquilizadora: um link curto limpo não quebra prévias. Quando você compartilha um link curto, o rastreador da plataforma segue o redirecionamento até o destino e lê as tags Open Graph lá, então o cartão mostra a prévia do destino exatamente como a URL longa mostraria.

As prévias quebram em torno de links curtos apenas em casos específicos. Uma cadeia de redirecionamentos - um link curto apontando para outro link curto apontando para a página - pode confundir ou expirar o tempo de um rastreador, portanto, mantenha um único salto, que é a mesma disciplina que mantém os redirecionamentos rápidos e limpos para SEO. Um encurtador que usa mascaramento por iframe em vez de um redirecionamento real quebra a prévia, porque o rastreador vê o invólucro, não o destino - uma das várias razões pelas quais essa técnica é uma má ideia, abordada em cloaking de link e mascaramento de URL. E se o destino em si não tem tags Open Graph, nenhum link curto pode inventá-las. Use um redirecionamento de um único salto em um domínio personalizado apontando para uma página com boas tags, e a prévia é idêntica à do link não encurtado.

Um rastreador de plataforma social seguindo um redirecionamento de link curto de um único salto até a página de destino e lendo suas tags Open Graph, versus um caso quebrado de cadeia de redirecionamentos ou máscara iframe

Se você quer links curtos que redirecionam de forma limpa em um único salto e nunca ficam entre seu público e uma boa prévia, crie um workspace gratuito no Elido e aponte seu primeiro link para uma página com tags adequadas.

Como Corrigir, Plataforma por Plataforma

Assim que as tags estiverem corretas, o trabalho restante é limpar o cache de cada plataforma - e cada plataforma principal oferece uma ferramenta para isso.

  1. Facebook e Instagram. Execute a URL pelo Facebook Sharing Debugger. Ele mostra as tags que encontrou e um botão "Rastrear Novamente" que busca a página de novo e limpa o cartão em cache. Isso também cobre o Instagram, que compartilha o mesmo rastreador.
  2. LinkedIn. Use o LinkedIn Post Inspector. O LinkedIn armazena prévias em cache por cerca de uma semana, e o inspetor é a única maneira de forçar uma atualização antecipada.
  3. X (Twitter). O validador de cartões busca a página novamente e mostra como o cartão será renderizado; confirme que as tags twitter:card estão presentes e teste novamente.
  4. WhatsApp, iMessage, Slack, Discord. Estes não têm uma ferramenta de depuração pública. Eles seguem o Open Graph, mas armazenam em cache de forma agressiva. A solução alternativa é compartilhar uma URL ligeiramente diferente - adicione ou altere um parâmetro de consulta inofensivo - que o aplicativo trata como nova e rastreia do zero.

O padrão é o mesmo em todos os lugares: corrija as tags na página, então force a plataforma a olhar novamente. Uma prévia que está apenas em cache é corrigida em minutos assim que você faz um novo rastreamento; uma prévia que não tinha tags aparece assim que o rastreador vê a página novamente.

A Lista de Verificação Antes de Compartilhar

Antes de um link ser compartilhado com um público, trinta segundos de verificação evitam o constrangimento de um link sem formatação.

  • Confirme que o destino tem og:title, og:description, og:image e og:url, além das tags Twitter Card.
  • Abra a URL do og:image diretamente no navegador - ela deve carregar, publicamente, em aproximadamente 1200x630.
  • Execute a URL final, incluindo o link curto, pelo depurador do Facebook para ver o cartão real.
  • Se você está compartilhando um link curto, verifique se é um único salto até o destino, não uma cadeia.

Faça esses quatro e a prévia aparece na primeira vez, em todas as plataformas que importam. O cartão não é mágica e não é a plataforma sendo difícil - são quatro tags na sua página e um cache para limpar.

Relacionados no Blog

Perguntas frequentes

Por que a prévia do meu link não está aparecendo?

Uma prévia de link é construída a partir das meta tags Open Graph no HTML da página de destino - og:title, og:description, og:image e og:url. Se essas tags estiverem ausentes, malformadas ou se a imagem estiver inacessível, a plataforma não tem nada para renderizar e exibe apenas o link sem formatação. A outra causa comum é o cache: a plataforma já acessou a página uma vez, armazenou um resultado vazio ou antigo, e continua exibindo-o até que você force uma atualização com a ferramenta de depuração dela.

Como corrijo uma prévia de link no Facebook ou no LinkedIn?

Execute a URL pela ferramenta da própria plataforma: o Facebook Sharing Debugger ou o LinkedIn Post Inspector. Cada um busca a página novamente, mostra exatamente quais tags Open Graph encontrou, e permite que você faça um novo rastreamento para limpar a versão em cache. Corrija as tags ausentes ou incorretas na página primeiro, depois faça o novo rastreamento - a prévia é atualizada em minutos. Essas ferramentas de depuração são a maneira mais rápida de diagnosticar e atualizar uma prévia quebrada.

Links curtos quebram as prévias de link?

Não, se o encurtador usar um redirecionamento normal. Quando você compartilha um link curto, o rastreador da plataforma segue o redirecionamento até o destino e lê as tags Open Graph lá, então a prévia mostra o cartão do destino. As prévias quebram quando o destino não tem tags, quando uma cadeia de redirecionamentos confunde o rastreador, ou quando o link usa mascaramento por iframe em vez de um redirecionamento. Um link curto limpo de um único salto para uma página com boas tags tem a mesma prévia que a URL longa teria.

Por que a prévia do meu link funciona em uma plataforma, mas não em outra?

Cada plataforma executa seu próprio rastreador com suas próprias regras e seu próprio cache. O Facebook lê Open Graph, o X lê tags Twitter Card (e usa Open Graph como fallback), e alguns aplicativos mal renderizam prévias. Portanto, uma página com Open Graph, mas sem tags Twitter Card, pode parecer perfeita no Facebook e aparecer sem formatação no X. A solução é incluir tanto as tags Open Graph quanto as tags principais do Twitter Card, e então limpar o cache de cada plataforma separadamente com sua ferramenta de depuração.

Quanto tempo leva para uma prévia de link corrigida ser atualizada?

Se o problema eram tags ausentes, a prévia aparece na próxima vez que a plataforma rastrear a URL - geralmente minutos após você fazer um novo rastreamento na ferramenta de depuração. Se o problema era uma prévia incorreta em cache, ela permanece errada até que o cache expire ou você force uma atualização, o que as ferramentas de depuração fazem sob demanda. O caso lento é uma plataforma que armazena em cache de forma agressiva e não oferece atualização manual, onde você pode esperar horas - ou compartilhar uma URL ligeiramente diferente para contornar o cache.

Posso alterar a imagem que aparece em uma prévia de link?

Sim - defina a tag og:image na página de destino com a imagem que você deseja, em um tamanho seguro (1200x630 pixels é o padrão confiável), e então faça um novo rastreamento da URL na ferramenta de depuração de cada plataforma para limpar a antiga. A imagem da prévia sempre vem das tags da página de destino, não do link em si, portanto, um link curto não pode substituí-la. Controle a imagem controlando o og:image na página para a qual o link aponta.

Experimente Elido

Cole uma URL, obtenha um link curto

Sem cadastro. O link vive 30 dias. Cadastre-se para mantê-lo para sempre.

Grátis, sem necessidade de registo · 2 por dia

Experimente o Elido

Encurtador de URL hospedado na UE: domínios personalizados, análises profundas e API aberta. Plano gratuito - sem cartão de crédito.

Tags
link preview not showing
fix link preview
open graph tags
social media preview
link preview image
og tags

Continuar lendo