7 min de leituraTutoriais

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

A prévia de um link vem das tags Open Graph da página. Por que ela quebra no WhatsApp, Facebook, X e Slack e os passos exatos para corrigir cada uma.

Ana Kowalska
Marketing solutions engineering

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.

Se o cartão renderiza mas a imagem está cortada, esmagada ou obstinadamente desatualizada, isso é um problema de dimensionamento e cache, não de tag ausente: o tamanho da imagem Open Graph cobre as especificações e a zona segura.

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.

Sem registo. Crie uma conta grátis e obtenha 50 links por mês.

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