A prévia de links do Slack não está funcionando ou não está atualizando

O Slack expande links com um bot que lê tags do oEmbed, Open Graph e Twitter Card. Os resultados ficam armazenados em cache no Slack por cerca de 30 minutos.

Última atualização

Solução rápida


  1. Verifique a página com o verificador de meta tags.

  2. Certifique-se de que as tags estejam no HTML baixado pelo Slackbot, perto do topo do cabeçalho (head).

  3. Permita o Slackbot-LinkExpanding através do seu firewall ou proteção contra bots.

  4. Aguarde cerca de 30 minutos ou publique o URL com ?v=2.


Por que a pré-visualização do Slack está ausente ou desatualizada

  • O Slack armazenou em cache o último resultado. As respostas são armazenadas em cache globalmente por cerca de 30 minutos.

  • O Slackbot obtém apenas parte da página. Ele usa cabeçalhos HTTP Range para buscar o mínimo possível, portanto, tags muito abaixo na página podem ser ignoradas.

  • A proteção contra bots o bloqueia. O Slack faz requisições com o user-agent Slackbot-LinkExpanding 1.0; uma página de desafio ou um erro 403 significa que nenhuma tag será obtida.

  • A imagem não passa na verificação do Slack. O Slack baixa a imagem para verificá-la, portanto, uma URL de imagem quebrada ou bloqueada descarta a imagem.

  • O link não possui protocolo. Os links só expandem a pré-visualização quando a URL é totalmente qualificada, com http ou https.

Como corrigir

  1. Abra a página no verificador de meta tags para ver as tags do Open Graph e do Twitter.

  2. Coloque og:title, og:description e og:image no início do head.

  3. Permita o user-agent Slackbot-LinkExpanding nas regras do seu CDN ou firewall.

  4. Verifique se a URL da imagem carrega sem cookies ou login.

  5. Publique o link novamente após 30 minutos ou com ?v=2 para testar imediatamente.

Tags que o Slack lê

  • oEmbed, quando a página possui link para um endpoint oEmbed

  • og:title, og:description, og:image

  • twitter:title, twitter:description, twitter:image. Verifique-as com o validador de cards do Twitter

Regras de tamanho de imagem

Não verificado: o Slack não divulga um limite de tamanho ou de arquivo para imagens de pré-visualização (unfurl). Um JPG ou PNG de 1200 x 630 px funciona no Slack e em todas as outras plataformas abordadas aqui.

Como forçar uma atualização

O Slack não tem uma ferramenta de atualização. Aguarde cerca de 30 minutos ou compartilhe a URL com uma query string. As mensagens já publicadas mantêm sua pré-visualização. A ferramenta de atualização mostra o passo a passo para cada aplicativo.

O Slack não respeita o robots.txt para expansão de links, portanto, uma regra Disallow não impedirá nem explicará a falta de uma pré-visualização.

Fontes

Perguntas Frequentes

Por quanto tempo o Slack armazena em cache a prévia de um link?

Cerca de 30 minutos, globalmente em todo o Slack, de acordo com a página de robôs do Slack.

O robots.txt bloqueia as pré-visualizações de links no Slack?

Não. O Slack diz que não respeita o robots.txt para a expansão de links porque age em nome de um usuário.

Por que o Slack mostra o título, mas não a imagem?

O Slack baixa a imagem para verificá-la. Se essa solicitação falhar ou for bloqueada, a prévia do link será exibida sem a imagem.

Verifique sua página e atualize a prévia

Cole sua URL no verificador gratuito para ver as tags exatas que cada aplicativo lê. Assim que as tags estiverem corretas, use a ferramenta de atualização para limpar a pré-visualização antiga.