Last updated: 2026-05-26 · Bluesky · By SocialKit Team
Os cartões de pré-visualização de link no Bluesky e Mastodon parecem simples, mas quebram por razões diferentes em cada plataforma. Este guia explica o porquê — registos embed do AT Protocol no Bluesky, fetch OpenGraph no servidor do Mastodon — e mostra como agendar publicações com um cartão funcional em todas as ocasiões.
Antes de começar
Precisas de uma conta no Bluesky (qualquer handle) e/ou uma conta no Mastodon em qualquer instância. Para agendar publicações com links com antecedência, também precisas de uma conta SocialKit — o teste gratuito de 7 dias (0,00 € hoje) cobre ambas as plataformas.
Do lado do proprietário da página: o URL que vais partilhar deve ter tags meta OpenGraph corretas (`og:title`, `og:description`, `og:image`) para que apareça um cartão em qualquer uma das redes. Se és proprietário da página de destino, verifica essas tags primeiro. Se estás a partilhar um URL de terceiros, só podes influenciar a tua publicação — não se a página deles tem tags OG — por isso ajusta as tuas expectativas.
No Bluesky, um cartão de pré-visualização de link não é apenas um URL renderizado — é um registo `app.bsky.embed.external` explícito anexado à tua publicação no momento da sua criação. Em junho de 2026, quando colas um URL na app web do Bluesky ou num compositor de terceiros compatível, o cliente vai buscar as tags OpenGraph da página e empacota o título, a descrição e a miniatura nesse registo embed. O AT Protocol armazena-o a seguir ao texto da publicação. Se o registo embed estiver ausente, não aparece nenhum cartão — mesmo que o URL conste no texto da publicação.
Tip: Um URL nu escrito no corpo de uma publicação sem o registo embed aparecerá como texto simples na maioria dos clientes Bluesky, não como cartão. Confirma sempre que a pré-visualização do cartão é renderizada no compositor antes de publicar.
Cola o URL num browser e vê o código fonte (Ctrl/Cmd + U), depois procura `og:title`, `og:description` e `og:image`. As três devem estar presentes. Se `og:image` estiver ausente, alguns clientes geram um cartão só de texto; se as dimensões da imagem forem demasiado pequenas (o Bluesky espera pelo menos 800 px de largura em junho de 2026), a miniatura pode ficar em branco ou mal recortada. Para as tuas próprias páginas, corrige as tags no CMS ou no `<head>` e valida com um validador gratuito de tags OG antes de distribuir o link.
Tip: As imagens dos cartões do Bluesky são exibidas numa proporção 1,91:1 (aproximadamente 1200 × 628 px), igual à especificação padrão de imagem OG. Um `og:image` quadrado será exibido com letterbox em vez de recortado na maioria dos clientes — usa uma imagem de 1200 × 628 px para o melhor resultado.
Abre o compositor do SocialKit e seleciona a tua conta do Bluesky ligada como destino. Cola o teu URL no corpo da publicação. Em junho de 2026, o SocialKit vai buscar os dados OpenGraph da página e mostra uma pré-visualização em tempo real do cartão no compositor para que possas confirmar o título, a descrição e a miniatura antes de agendar. Se o cartão estiver em branco ou mostrar texto de marcador, o problema é provavelmente as tags OG da página de destino — corrige-as primeiro (ver Passo 2) e depois atualiza o compositor.
Tip: Se estás a partilhar um link para uma página que alterou recentemente as suas tags OG, algumas caches de CDN ou de pré-visualização podem demorar minutos a horas a atualizar. Adicionar um parâmetro de cache-busting (ex. `?v=2`) força um fetch novo na maioria dos compositores, mas altera o URL canónico — usa apenas em páginas que possuis e onde a alteração do URL seja aceitável.
Os cartões de link do Mastodon funcionam de forma diferente do Bluesky. Quando a tua instância principal recebe uma publicação com um URL, o seu servidor vai buscar a página de destino de forma assíncrona e analisa as suas tags OpenGraph — normalmente em alguns segundos, por vezes até um minuto em instâncias com muita carga ou com limites de taxa. O cartão aparece depois desse fetch do lado do servidor estar concluído. Em junho de 2026 isto significa: (a) o cartão pode não aparecer imediatamente mesmo que as tags OG estejam corretas; (b) se o URL de destino estiver atrás de um CAPTCHA que bloqueia bots ou de um desafio Cloudflare, a instância pode não conseguir fazer o fetch e o cartão nunca aparecerá; (c) o comportamento dos cartões pode variar entre versões do Mastodon (a linha estável atual é a 4.x).
Tip: O Mastodon não armazena o cartão no registo da publicação como o Bluesky — é gerado a pedido a partir do URL sempre que um cliente carrega a publicação. Isto significa que corrigir uma tag OG com erros na página de destino acabará por corrigir o cartão em todas as publicações passadas do Mastodon que lhe façam referência, assim que a instância atualize a sua cache.
No compositor do SocialKit, seleciona a tua conta do Mastodon ligada ao lado de (ou em vez de) Bluesky. Escreve o texto da tua publicação e cola o URL. Usa a personalização por plataforma para adaptar a legenda se estiveres a publicar em ambas as redes ao mesmo tempo — o limite de caracteres padrão do Mastodon é 500 (algumas instâncias aumentam este valor; verifica o limite da tua instância nas configurações da tua conta), enquanto o limite do Bluesky é de 300 grafemas em junho de 2026. Define uma hora específica ou usa os dados de melhor momento e depois agenda. O SocialKit publica automaticamente no Mastodon na hora agendada; não é necessária qualquer interação com o telemóvel.
Tip: O campo de Aviso de Conteúdo (CW) do Mastodon é uma caixa de texto separada que esconde o conteúdo da publicação atrás de um clique. É comummente usado para spoilers, temas sensíveis ou threads longas — não para publicações de link padrão. Deixa-o em branco a menos que as normas da tua comunidade o exijam.
Se o link na tua publicação aponta para uma página que possuis, adiciona parâmetros UTM para que o Google Analytics 4 (ou qualquer plataforma de análise) separe os cliques do Bluesky dos cliques do Mastodon. Um conjunto mínimo tem este aspeto: `?utm_source=bluesky&utm_medium=social&utm_campaign=a-tua-campanha`. Usa o gerador UTM gratuito do SocialKit para os criar sem erros de digitação e depois cola o URL com tags no compositor antes de o cartão de pré-visualização ser obtido. O cartão mostrará os metadados da página de destino mesmo que o URL inclua parâmetros.
Tip: Tanto o Bluesky como o Mastodon passam os URLs sem modificações — nenhum remove os parâmetros UTM como algumas plataformas fazem. A miniatura e o título do cartão provêm das tags OG da página de destino independentemente da query string, por isso os URLs com tags UTM geram pré-visualizações de cartão corretas.
Ainda na mesma sessão do compositor do SocialKit, adiciona o X (Twitter), Threads ou qualquer uma das outras nove plataformas suportadas como destinos adicionais. Cada uma tem o seu próprio campo de legenda — mantém o Bluesky abaixo de 300 grafemas, o Mastodon abaixo do limite da tua instância, o X (Twitter) abaixo de 280 caracteres (contas padrão, em junho de 2026; os planos premium diferem) e o Threads abaixo de 500 caracteres. O comportamento dos cartões de link varia por plataforma: o X renderiza um cartão de pré-visualização e não conta o URL no limite de caracteres; o Threads e o Bluesky mostram cartões integrados; o Mastodon vai buscar um de forma assíncrona. Agenda todos os destinos numa única sessão.
No Bluesky: a causa mais comum é que o compositor não gerou um registo embed, seja porque o fetch OG falhou (bloqueio de bots, servidor lento, tags em falta) seja porque colaste o URL depois de escrever outro texto e o cliente não voltou a iniciar um fetch. Para corrigir, limpa a publicação, cola primeiro o URL, espera que a pré-visualização do cartão apareça e depois adiciona o texto da legenda à volta. Se o cartão ainda não aparecer, as tags OG da página de destino estão em falta ou a devolver erros.
No Mastodon: a causa mais comum é que a tua instância ainda não terminou o fetch assíncrono, ou o servidor de destino bloqueou o pedido da instância (Cloudflare, CAPTCHA ou bloqueio ao nível do IP). Não há solução alternativa para um URL de destino bloqueado que não seja usar um redirecionamento ou um destino diferente. Aguardar 30–60 segundos e atualizar a publicação resolve normalmente uma situação de fetch lento em junho de 2026.
Em junho de 2026, o Bluesky não suporta a edição de registos de publicação após a publicação — esta é uma decisão de design deliberada do AT Protocol em torno da imutabilidade das publicações e da integridade da federação. Se um post for publicado com um cartão com erros ou em falta, a tua única opção é apagá-lo e republicar com o embed corrigido. Isto torna a confirmação do cartão na pré-visualização do SocialKit antes de agendar mais importante no Bluesky do que em qualquer outra plataforma.
O Mastodon suporta a edição de publicações em instâncias com a versão 3.5.0 ou posterior; as publicações editadas mostram um emblema de histórico de edição em clientes que o suportem. No entanto, se a edição de uma publicação do Mastodon atualiza a cache do cartão de link depende da instância em junho de 2026.
O compositor do SocialKit vai buscar dados OpenGraph e mostra uma pré-visualização em tempo real do cartão antes de agendares — para que deteções pré-visualizações com erros antes de ficarem em direto. Agenda no Bluesky, Mastodon e outras nove plataformas a partir de um único calendário. Publicações agendadas ilimitadas em todos os planos, teste gratuito de 7 dias, 0,00 € hoje.
Agenda publicações com links no Bluesky e Mastodon com o SocialKitSchedule and cross-post to all 11 networks from one calendar on one flat plan. 7-day free trial — €0.00 due today.
0,00 € hoje · cancela quando quiseres · garantia de reembolso de 7 dias
FAQ
The questions people ask before they schedule — answered honestly, hedged where platform behavior changes.
0,00 € hoje · cancela quando quiseres · garantia de reembolso de 7 dias