logo
Links•

Escolha a imagem que aparece no link no WhatsApp

Defina imagem, título e descrição que aparecem quando seu link curto da CodeQR é compartilhado no WhatsApp, Facebook, LinkedIn, X e Slack.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Quando alguém cola o seu link curto no WhatsApp, no LinkedIn ou no Slack, o aplicativo busca a página e desenha um cartão. A Visualização de link personalizado deixa você decidir o que esse cartão mostra, sem mexer na página de destino.

Disponibilidade

  • Plano: Starter ou superior.
  • Onde: Visualização de link personalizado no construtor de links. O painel Prévias Sociais, à direita, mostra o resultado para X, Facebook e LinkedIn enquanto você digita.

Antes de começar

  • Tenha uma imagem de 1200 × 630 pixels. Bem menor que isso sai borrada, e alguns aplicativos recusam arquivos muito grandes — cerca de 1 MB é um teto confortável.
  • O cartão só muda o que os robôs veem. Quem abre o link é redirecionado ao destino como sempre, então prévia e destino podem ser diferentes de propósito.
  • Todas as plataformas guardam o cartão em cache. Defina a prévia antes de compartilhar o link — veja a solução de problemas.

Passos

  1. No construtor de links, ligue Visualização de link personalizado. A CodeQR preenche os campos com o que leu da sua página de destino.
  2. Envie uma imagem, cole a URL de uma imagem ou busque no Unsplash. O tamanho recomendado fica escrito ao lado do campo.
  3. Edite Título e Descrição. Os contadores mostram os limites: 120 e 240 caracteres, e o que passar disso é cortado ao salvar.
  4. Confira o painel Prévias Sociais à direita e salve.

A seção Visualização de link personalizado com imagem, título e descrição

The Social Previews panel showing X, Facebook and LinkedIn cards

O que cada plataforma mostra

O cartão é servido aos robôs — WhatsApp, Facebook, Messenger, LinkedIn, X, Slack, Telegram, Discord e iMessage buscam o link antes de desenhá-lo. Verificado ao vivo: com a prévia personalizada ligada, todos recebem o seu título, a sua descrição e a sua imagem, enquanto o navegador recebe um redirecionamento simples.

Duas consequências que valem lembrar:

  • As tags da própria página de destino deixam de valer para aquele cartão. Se o cartão está errado, o conserto é no link.
  • O que já foi compartilhado não muda. A mensagem enviada ontem continua com o cartão de ontem.

Faça o mesmo pela API

proxy liga o cartão personalizado; os três campos o preenchem:

curl -X PUT https://api.codeqr.io/links/<linkId> \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": true,
    "title": "Planos de agosto — 20% até o dia 31",
    "description": "Compare os planos e escolha o que serve à sua campanha.",
    "image": "https://example.com/og/agosto.png"
  }'

Envie proxy: true junto com os campos — um link com a chave ligada e nada preenchido gera um cartão vazio. Títulos são guardados com 120 caracteres e descrições com 240; valores maiores são cortados no servidor, não recusados. Os mesmos campos existem nas ferramentas create_link e update_link do MCP.

Verifique se funcionou

Acrescente ?bot=1 ao seu link curto e a CodeQR responde com o próprio cartão, sem esperar por nenhuma plataforma:

curl -sS "https://go.example.com/planos-agosto?bot=1" | grep 'og:'
<meta property="og:title" content="Planos de agosto — 20% até o dia 31"
<meta property="og:description" content="Compare os planos e escolha o que serve à sua campanha."
<meta property="og:image" content="https://example.com/og/agosto.png"

Depois confirme que o mesmo link continua redirecionando gente:

curl -sSI https://go.example.com/planos-agosto
HTTP/2 302
location: https://example.com/planos

Para uma última conferência no mundo real, cole o link numa conversa sua consigo mesmo antes de mandar para alguém.

Solução de problemas

Mudei a prévia e o WhatsApp continua mostrando o cartão antigo

Cada plataforma guarda o cartão que buscou, e o WhatsApp guarda por link, sem jeito de forçar atualização. A saída é um endereço novo: troque a chave em Link Curto — ou crie um segundo link — e compartilhe esse. Para Facebook e Messenger, o Sharing Debugger rebusca o link; o LinkedIn tem o Post Inspector. Nenhum dos dois resolve o WhatsApp.

A prévia mostra a imagem da página de destino, não a minha

A chave está desligada, ou os campos estão vazios e a CodeQR usou o que leu da página. Ligue Visualização de link personalizado, preencha os três campos e salve.

A primeira pessoa que compartilhou não viu imagem

Alguns aplicativos montam o cartão na primeira busca e guardam aquilo. Se naquele momento a imagem ainda estava subindo ou demorou a responder, o cartão saiu sem ela. Espere o envio da imagem terminar e compartilhe depois.

O cartão está certo no X e errado no WhatsApp

Cada plataforma tem o próprio cache e as próprias regras de tamanho de imagem. Confira o cartão com ?bot=1 primeiro: se as tags estão certas ali, a diferença é o cache da plataforma, não o seu link.

O botão de IA da descrição não faz nada

Ele fica desabilitado enquanto não houver um Título. Escreva o título primeiro.

Nada que eu faço muda o cartão, e o link não é meu

As opções de prévia ficam no link, então só quem tem acesso àquele workspace consegue alterá-las.

Artigos relacionados