Links de compartilhamento com miniatura personalizada

Status: rascunho Atualizado em: 2026-09-19 Issue: #1207 Priority: P2 Impeccable: A — N/A sem UI Design UI: N/A — sem UI Appetite: ~1 dia eng; um fluxo novo pequeno no admin + uma rota pública Responsável: —

Intenção

A comunicação do mandato compartilha hoje links que não são nossos — plenárias no Google Meet, formulários, páginas externas — e o card que aparece no WhatsApp é o genérico do destino (ou nenhum). Quando é uma plenária da campanha, o convite chega sem identidade: sem título escolhido, sem imagem, sem descrição.

Queremos que a equipe consiga criar, dentro do painel, um link curto em jorgesolla1313.com.br/<slug> com título, descrição e imagem escolhidos, para que a miniatura do compartilhamento mostre exatamente o que foi configurado — e o clique leve direto ao destino. Hoje isso exigiria mexer no site a cada evento.

Persona e fluxo

Persona / contexto: equipe de comunicação do mandato (usuária Editor do painel, que já publica notícias, tags e mídia), montando um convite às pressas antes de divulgar no WhatsApp.
Job principal: transformar um link externo em um cartão compartilhável com a identidade que ela escolher, sem depender de ninguém técnico.
Fluxo desejado:
1. No painel, cria um "link de compartilhamento" e preenche: slug, URL de destino (ex.: Google Meet), título, descrição e imagem (opcional; vazio = imagem padrão do site).
2. O próprio formulário mostra as instruções de efetividade (tamanho/formato/limites de texto) e recusa slug duplicado/reservado ou destino inválido, com mensagem clara.
3. Salva/publica e compartilha jorgesolla1313.com.br/<slug> no WhatsApp.
4. A miniatura aparece com os dados configurados; quem clica chega ao destino na hora, sem tela intermediária perceptível.
Anti-goals de produto: NÃO virar encurtador com analytics; NÃO ser um segundo cadastro de conteúdo; NÃO expor a URL de destino na miniatura; NÃO coletar dado de quem clica.

Objetivo e aceite

A equipe cria um link pelo painel e, ao compartilhar a URL curta no WhatsApp, a miniatura mostra o título, a descrição e a imagem configurados (o crawler do WhatsApp lê o HTML servido pelo nosso site — nada de miniatura montada só no navegador).
O clique leva direto ao destino, sem interstício visível.
Sem imagem configurada, a miniatura cai na imagem padrão do site (nunca quebrada/vazia).
Fail-closed: link não publicado → 404; destino fora de http/https, slug duplicado ou slug reservado → recusado no admin com mensagem clara.
A página do link é noindex,nofollow e nunca revela a URL de destino crua na descrição da miniatura.
As instruções de imagem/texto ficam visíveis no próprio formulário, em pt-BR.

Dados (intenção)

Vou apresentar dados? Não — o link não coleta nem persiste dado de quem clica; v1 sem contagem de cliques, analytics ou UTM.
Decisões desbloqueadas: N/A.
Forma: N/A — sem dado apresentado.

Dados da decisão (literais)

Contrato de URL (produto): https://jorgesolla1313.com.br/<slug> — slug de 1 segmento na raiz.
Destino aceito: apenas http/https (ex.: link do Google Meet), validado no admin.
Slug duplicado ou reservado → recusado com mensagem clara. Reservados (colisão com rotas/valores do site): cards, artigos, corte, privacidade, mandato-no-whatsapp, abaixo-assinado, api, admin, noticia, campanha, artigo, evento.
Página do link: noindex,nofollow.
Instruções do admin (literais, pt-BR, visíveis no formulário):
- Imagem: 1200×630 px (proporção 1,91:1), arquivo até 600 KB, formatos JPG/PNG, largura mínima 300 px; evitar imagens muito largas (proporção máx. 4:1).
- Título curto: o WhatsApp mostra no máximo 2 linhas (~60–90 caracteres).
- Descrição: ~80 caracteres já bastam; evitar passar de ~160.
- A imagem precisa ser uma URL pública absoluta — o admin resolve isso sozinho ao subir o arquivo.
- O WhatsApp guarda a miniatura em cache por URL: para trocar a miniatura de um link já compartilhado, usar um slug novo (ou aguardar o cache expirar).

Direção no codebase (hipótese)

Áreas prováveis: rotas públicas em src/app/(frontend)/ (o segmento dinâmico existente já serve listagens e artigos; segmentos estáticos vencem o dinâmico — precedente: /cards); cadastro novo no grupo do admin Publicações; utilitários de SEO em src/utilities/seo.ts (resolveSiteMetadata, toAbsoluteUrl) e revalidação por tag em src/utilities/documents.ts.
Precedente a olhar: /corte/[id] (OG custom + noindex/nofollow) como molde próximo de página de compartilhamento; docs/plans/compartilhar-conteudos-home-whatsapp.md (S4) que adiou "imagem OG por seção/card"; docs/campanha/plano-site-campanha-2026.md §7.1 (compartilhamento por seção com OG).
Risco de acoplamento: o Next 15.4.11 não aceita duas pastas dinâmicas de nomes diferentes no mesmo nível (E337) — a rota nova não pode simplesmente nascer ao lado da existente; roteamento é decisão do plano de implementação. Sem Consent novo (não há dado pessoal) e sem infra de redirects.

Dependências

Nenhuma.

Fora de escopo

Expiração/agendamento automático do link — não pedido agora.
QR code — não pedido agora.
Contagem de cliques/analytics — não pedido agora.
Encurtador genérico/domínio próprio — não pedido agora.
Múltiplos destinos/A-B — não pedido agora.
Pré-visualização custom do card no admin — não pedido agora.
Tracking/UTM — não pedido agora.

Rabbit holes de produto

Vira encurtador. Se alguém "só completar" com analytics, domínio próprio e gestão de links, vira produto de infra. Corte neste item: link utilitário, sem métricas.
Vira segundo CMS. Pedir corpo/richText/edição de página no link puxa a máquina de posts. Corte neste item: só título, descrição e imagem.
Cache do WhatsApp. Prometer "trocar a miniatura" de um link já compartilhado é impossível sem slug novo. Corte neste item: orientação no formulário, sem mecanismo de invalidação.
Colisão de rota/slug. Reservar mal os slugs quebra URLs existentes do site. Corte neste item: lista de reservados explícita + recusa no admin.

Questões em aberto (produto)

Imagem por upload no admin ou URL externa? Opções: A) upload; B) URL externa; C) ambos. Recomendação: A — upload pelo painel, com fallback para a imagem padrão do site; URL externa cria um jeito fácil de quebrar a miniatura. (assumido — validar)
O clique deve ser instantâneo, sem tela intermediária? Opções: A) sim; B) página intermediária com botão. Recomendação: A — instantâneo; a miniatura customizada exige HTML nosso servido aos crawlers, mas a pessoa não pode perceber tela alguma. (assumido — validar)
Quem gerencia os links? Opções: A) Editores (comunicação); B) só admin. Recomendação: A — mesma gente que já publica notícias. (assumido — validar)
Agrupar no admin junto de Publicações? Opções: A) sim; B) grupo próprio. Recomendação: A — é material de comunicação, ao lado de posts e mídia. (assumido — validar)
Expiração/agendamento automático? Opções: A) fora da v1; B) agendar no MVP. Recomendação: A — despublicar manualmente resolve; agendamento vira rabbit hole. (assumido — validar)

Referências

GitHub Issue #1207
Design UI (gate): N/A — sem UI
src/app/(frontend)/corte/[id]/page.tsx e src/utilities/seo.ts — precedente de OG custom + noindex
docs/plans/compartilhar-conteudos-home-whatsapp.md (S4) — adiou OG por seção/card
docs/campanha/plano-site-campanha-2026.md §7.1 — compartilhamento por seção com OG
AGENTS-public.md — convenções do site público (OG, revalidação, cache)

7.9 KiB Raw Blame History Unescape Escape