LiçõesComo corrigir a prévia do seu site ao compartilhar um link

Minilição 23 de 30 · Alcançar pessoas e oferecer serviços

Escolha o cartão que quer compartilhar

Para quem é esta lição?

Para donos de sites cujos links compartilhados mostram uma prévia ausente ou enganosa. Um assistente de programação pode adicionar os metadados da página; você examina o cartão realmente compartilhado.

A prévia é gerada a partir de uma página obtida publicamente.

Objetivo desta lição

  • Conecte título, descrição e imagem pretendidos.
  • Verifique se a imagem pode ser obtida publicamente.
  • Examine a prévia real da plataforma e seus limites.
Explicação, exemplo resolvido e prática

Antes de começar

Sua própria página HTTPS pública de prática e a imagem fornecida para o cartão. Um assistente pode editar e publicar os arquivos. Plataformas sociais não conseguem obter uma página privada localhost e suas prévias em cache podem precisar de atualização.

Confira os conhecimentos iniciais

São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.

  1. Como publicar seu site pelo GitHub

    Conecte um repositório de prática à hospedagem.

Tempo estimado: 15–27 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. As plataformas guardam resultados em cache e decidem o que mostrar. Uma verificação local de metadados não comprova uma prévia real no LinkedIn, Slack ou WhatsApp.

Entenda a ideia

Abra a página fornecida. Seu título é “Practical notes for building a website” e ela inclui share-card.jpg. Decida se o título, a descrição curta e a imagem descrevem com precisão o que o visitante abrirá.

Dê ao assistente o endereço HTTPS público real e peça para conectar esses valores de compartilhamento. A origem reservada https://YOUR-SITE.example/ é um modelo; a plataforma não pode buscar uma imagem que só existe no seu notebook.

Um exemplo concreto

A descrição fornecida é “Small examples, working files and clear checks for your next website feature.” Com o título, promete notas práticas sobre sites, não uma página inicial sem relação.

Use a página e a imagem de compartilhamento fornecidas. Adicione título e descrição específicos do artigo e URL pública absoluta da imagem, mantendo o conteúdo visível consistente. Ajude a verificar a página e a imagem publicadas sem sessão iniciada e depois examine uma prévia real de compartilhamento. Cuide do código de metadados. Não alegue uma atualização na plataforma só por uma imagem local ou solicitação de atualização do cache do provedor.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Na página fornecida, qual título, descrição e imagem o cartão deve mostrar e qual página deve abrir?

Mostrar uma solução comentada

O título é “Practical notes for building a website”; a descrição promete exemplos pequenos, arquivos funcionais e verificações claras; a imagem é share-card.jpg. O cartão deve abrir a página publicada correspondente. Antes, os valores https://YOUR-SITE.example/ precisam ser substituídos pelo meu endereço HTTPS real.

O que uma boa resposta inclui

  • Usa título, descrição e imagem coerentes com a página fornecida.
  • Identifica a página pública real como destino, não localhost nem a origem do modelo.
Como funciona (opcional)

Faça o link compartilhado explicar seu destino

Uma prévia precisa de metadados da página e de uma imagem que a plataforma realmente consiga buscar.

Uma prévia costuma ser montada por uma plataforma que busca a URL e lê os metadados. Ela não é simplesmente uma captura do que seu navegador conectado vê.

Esta lição fornece uma seção head do HTML completa e uma nova imagem de compartilhamento. Você substituirá a origem reservada do exemplo, publicará sua própria página de prática e examinará o que uma solicitação sem autenticação recebe.

Exemplo resolvido

Um título útil informa o que a página oferece. “My site” (meu site) dá muito menos contexto que “Practical notes for building a website” (notas práticas para criar um site), seguido de uma descrição curta.

Open Graph: metadados básicos

Exercício técnico complementar

Por que uma miniatura pode funcionar no seu computador e falhar no Slack?

Mostrar uma solução comentada

A plataforma não consegue acessar localhost nem sua sessão autenticada. Ela também precisa de uma URL de imagem acessível e de metadados HTML corretos no endereço exato compartilhado.

  • Reconhece que a plataforma precisa de acesso público pela rede.
  • Verifica a URL compartilhada e a imagem separadamente.

Etapa 1 · Como corrigir a prévia do seu site ao compartilhar um link

Verifique a imagem publicada

Examine o caminho de imagem que o cartão realmente referencia.

Explicação, exemplo resolvido e prática

Entenda a ideia

Publique a alteração de prática quando pronta e depois abra a URL real da imagem de compartilhamento sem sessão iniciada. Peça ao assistente para confirmar que é a imagem pretendida em vez de arquivo ausente ou página de login.

Mudar a imagem visível da página não muda necessariamente o valor separado usado no compartilhamento. Verifique também a referência entregue.

Um exemplo concreto

Se a URL da imagem abre a página inicial HTML em vez de share-card.jpg, o servidor ainda pode retornar 200. A URL funciona como página, mas não fornece uma imagem para o cartão.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

A URL da imagem de compartilhamento retorna 200, mas exibe uma página HTML. Isso é uma verificação de imagem bem-sucedida? O que corrigir?

Mostrar uma solução comentada

Não. O cartão precisa de uma imagem real na URL. Pediria ao assistente para publicar share-card.jpg nesse caminho e verificar que uma solicitação sem login retorna a imagem com conteúdo image/jpeg, não a página inicial alternativa.

O que uma boa resposta inclui

  • Rejeita uma página HTML alternativa como imagem mesmo com resposta 200.
  • Confere a URL pública configurada exata e o conteúdo real da imagem.
Como funciona (opcional)

Coloque a prévia no HTML inicial

Use URLs absolutas canônicas e de imagem que funcionem em uma busca externa.

Examine a seção head do HTML fornecido. og:title, og:description, og:type, og:url e og:image descrevem esta página exata. O caminho da imagem é absoluto porque um robô remoto precisa de um destino inequívoco.

Substitua YOUR-SITE.example em todos os lugares. A imagem é um arquivo real incluído na oficina. Não dependa de JavaScript para inserir metadados essenciais depois do carregamento; o comportamento dos robôs varia.

O cartão horizontal fornecido tem 1672 × 941 pixels. Plataformas podem recortar ou redimensionar de formas diferentes; mantenha detalhes importantes longe das bordas e examine o resultado real. É um recurso inicial, não uma promessa de recorte idêntico em todas as plataformas. Confirme que share-card.jpg está na pasta pública implantada.

Antes de testar qualquer plataforma, abra sua URL og:image implantada exata sem estar conectado e confira uma resposta image/jpeg bem-sucedida com a imagem real visível. Arquivo ausente, origem reservada ou resposta HTML de substituição não passam nessa verificação.

Exemplo resolvido

Uma imagem relativa correta no corpo não corrige um og:image absoluto quebrado. Examine os dois destinos em vez de supor que são iguais.

<meta property="og:image"
  content="https://YOUR-SITE.example/share-card.jpg">
<meta property="og:type" content="website">

Exercício técnico complementar

Você mudou a imagem visível, mas deixou og:image apontando para um arquivo ausente. Qual imagem o robô vai tentar buscar?

Mostrar uma solução comentada

Normalmente tentará a imagem dos metadados, que continua quebrada. Corrija a URL og:image e verifique a resposta real.

  • Lê o destino dos metadados.
  • Não deduz a prévia a partir do corpo renderizado.

Etapa 2 · Como corrigir a prévia do seu site ao compartilhar um link

Examine uma prévia real da plataforma

Considere a obtenção remota e o cache.

Explicação, exemplo resolvido e prática

Entenda a ideia

Depois de publicar, confira as URLs de página e imagem sem login. Use uma ferramenta como LinkedIn Post Inspector, quando disponível, ou compartilhe o link de prática em privado e examine o cartão real. Compare título, descrição e recorte exibidos.

Anote a plataforma e o que mostrou. Se os arquivos públicos estão atuais, mas o cartão é antigo, investigue o cache; pedir atualização é uma etapa, não um resultado visível.

Um exemplo concreto

Comparação ilustrativa: A página pública fornece o título novo e o JPEG, enquanto a plataforma examinada ainda mostra um título antigo. Isso aponta para cache específico dela, não comprova atualização em todas as plataformas.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Que cartão a plataforma escolhida mostrou e o que continua incerto?

Mostrar uma solução comentada

Resultado ilustrativo: A página e o JPEG estão atuais, mas a plataforma ainda mostra o título anterior. Registraria essa prévia antiga, pediria atualização na ferramenta disponível e examinaria o cartão novamente. Um teste apenas no LinkedIn não permitiria afirmar que o WhatsApp atualizou.

O que uma boa resposta inclui

  • Registra o cartão real em uma plataforma identificada e compara título/imagem com a página.
  • Distingue a saída pública atual de um cartão possivelmente em cache.
Como funciona (opcional)

Verifique a resposta antes de culpar o cache

Verifique HTML bruto, redirecionamentos e acesso à imagem e depois teste a plataforma.

Abra a URL compartilhada exata sem entrar e examine a fonte bruta. Siga os redirecionamentos e confira o status final. Busque a imagem separadamente: ela precisa retornar bytes de imagem com tipo de conteúdo adequado, não HTML de substituição.

Depois de a saída do servidor estar correta, use a ferramenta de inspeção da plataforma quando disponível e tente um compartilhamento novo. Mensagens existentes podem manter prévias antigas em cache. Atualizar o cache do seu navegador não limpa o cache de uma plataforma social.

Por exemplo, abra LinkedIn Post Inspector com sua conta e informe a URL pública exata. Meta Sharing Debugger é outra ferramenta específica de plataforma e pode exigir acesso. Nas ferramentas do navegador, selecione a solicitação da imagem em Network e examine Headers → Content-Type e a prévia da resposta. As ferramentas ainda podem estar indisponíveis ou usar cache.

A página e a imagem de destino precisam ser acessíveis sem sua sessão de proprietário por visitantes ou robôs. A ferramenta de diagnóstico é separada: LinkedIn ou Meta podem exigir acesso para usar o inspetor. Entrar na ferramenta não torna um destino privado acessível ao robô. Se não tiver acesso, registre a limitação e separe as verificações de resposta bruta de uma prévia de plataforma não observada.

No WhatsApp ou Slack, compartilhe a URL pública de prática em uma conversa de teste que você controla e registre a prévia ou sua ausência. Não afirme que uma plataforma passou quando só examinou respostas HTTP; se faltar conta ou ferramenta, registre o limite.

Exemplo resolvido

Uma solicitação de imagem que retorna 200 text/html pode ser uma página de substituição de aplicação de página única. Status 200 sozinho não prova que uma imagem foi servida.

LinkedIn Post Inspector · Meta Sharing Debugger

Exercício técnico complementar

A solicitação og:image retorna 200 com uma página de acesso. A verificação da imagem teve sucesso?

Mostrar uma solução comentada

Não. O robô recebeu HTML em vez da imagem. Corrija rotas e acesso para a URL retornar o arquivo real sem entrar na conta.

  • Verifica tipo de conteúdo e corpo além do status.
  • Exige acesso sem autenticação aos bytes reais da imagem.

Etapa 3 · Como corrigir a prévia do seu site ao compartilhar um link

Conclua um cartão específico do artigo

Mantenha alinhadas a identidade compartilhada e a página real.

Explicação, exemplo resolvido e prática

Entenda a ideia

Peça ao assistente para adicionar o artigo de referência “Fix a mismatched contact link”, com seu próprio título de compartilhamento, descrição e URL. Pode reutilizar share-card.jpg; sua identidade ainda deve descrever o artigo, não a página inicial.

Publique o artigo no site de prática, abra sua página pública exata e a imagem e confira o cartão novamente. Registre qualquer plataforma cuja verificação não foi possível.

Um exemplo concreto

O título do cartão deve ser “Fix a mismatched contact link”. A descrição explica comparar href e id, corrigir a âncora e conferir o resultado. Reutilizar o título genérico da página inicial esconderia o que esse link ensina.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Apresente o link do artigo e o registro real de verificação de imagem e plataforma.

O que entregar: A URL pública de prática e os resultados observados de imagem e prévia, incluindo limitações de cache.

Mostrar uma solução comentada

Entrega ilustrativa: article.html identifica “Fix a mismatched contact link”, descreve a correção e aponta à URL publicada; share-card.jpg abre sem login. A plataforma examinada mostra o título do artigo. As demais não foram testadas, então não afirmei atualização das suas prévias.

O que uma boa resposta inclui

  • Dá ao artigo seu próprio título, descrição e URL pública correspondentes.
  • Fornece observações reais de imagem/plataforma e identifica plataformas não verificadas.
Como funciona (opcional)

Sua tarefa: obter a prévia de um artigo específico

Dê ao link direto para um artigo específico seu próprio título, descrição e imagem corretos.

Crie uma página de artigo com seus metadados e uma mensagem descritiva de compartilhamento. Mantenha canonical/og:url nesse artigo, não na página inicial.

Publique apenas no site de prática, teste as respostas sem autenticação e registre a prévia real de uma plataforma se disponível. Se ela recusar ou mantiver um resultado antigo, documente a observação em vez de declarar sucesso pelo HTML sozinho.

Exemplo resolvido

Dois artigos diferentes que sempre mostram a prévia da página inicial podem ser compartilháveis tecnicamente, mas não ajudam o destinatário a entender o link específico.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Exercício técnico complementar

Produza uma prévia própria do artigo e um registro de teste de resposta e plataforma.

Mostrar uma solução comentada

Substitua a origem reservada em canonical, og:url e og:image. Publique o JPEG fornecido junto ao HTML. Abra as duas URLs exatas desconectado e examine a resposta em Network: a página deve ser HTML e a imagem, bytes reais image/jpeg, não HTML de substituição.

Para um artigo específico, dê a ele seu próprio título, descrição e URL canônica/OG em vez de reutilizar a identidade da página inicial. O artigo completo de referência demonstra essa seção head separada do HTML.

Use LinkedIn Post Inspector ou Meta Sharing Debugger quando sua conta tiver acesso e registre o resultado real e a hora do teste. Uma prévia antiga em cache é uma observação diferente de uma saída atual incorreta do servidor. Verificações de fonte local não comprovam uma prévia real do WhatsApp.

  • Os metadados descrevem o artigo exato compartilhado.
  • O HTML bruto e o acesso à imagem são verificados; o resultado da plataforma é registrado com honestidade.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.