
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.
- 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.
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.