FastOG

O Guia da Plataforma FastOG

O FastOG gera a imagem que aparece quando alguém compartilha uma das suas páginas — o produto, a categoria, a página inicial, o post do blog. Ele substitui o padrão estático por uma capa dinâmica: a foto do produto, o preço atual, a avaliação, seu logo e o título que você escolher.

Este guia é o mapa. Ele cobre o que cada recurso faz, onde alterá-lo em cada plataforma e qual plano o inclui. Para a API, a assinatura HMAC e os tutoriais de frameworks, comece pela referência da API.

Onde o FastOG é executado

Plataforma Onde o app fica O que o lojista abre
WooCommerce Painel do WordPress → FastOG Studio para editar capas, Plan para alterar o plano, Support para abrir um ticket, Tools para a conexão
Shopify Painel do Shopify → Apps → FastOG Covers, Plan, Support; os detalhes avançados de conexão ficam na parte inferior do app
Wix Painel do Wix → Apps → FastOG Covers, Customize, Plans

Na primeira vez que você abre o app, ele oferece uma configuração rápida: escolha quais tipos de página recebem uma capa e selecione uma aparência inicial. Você pode alterar ambos depois — nada na configuração é permanente.

Como uma capa é escolhida

O FastOG assina uma URL para a página que está sendo compartilhada. A requisição carrega a loja e o tipo de página, e o servidor aplica a regra salva para aquele tipo de página:

  1. A regra do tipo de página — a capa que você editou em Covers para produtos, coleções/categorias, home ou posts do blog.
  2. Uma regra mais específica, se houver correspondência — uma regra para uma tag, categoria, fornecedor ou coleção tem prioridade sobre a regra do tipo de página.
  3. Uma capa por produto, se estiver salva — a mais específica de todas; disponível no Pro e acima.

Se nenhuma delas corresponder, a página mantém a imagem do tema. Cada plataforma dá a cada tipo de página sua própria capa, então alterar a capa do produto não afeta a página inicial.

Capas e tipos de página

Abra Capas (Shopify, Wix) ou FastOG → Studio (WooCommerce) e escolha o tipo de página acima da pré-visualização.

Plataforma Tipos de página
WooCommerce Produto, Categoria, Home, Post do blog
Shopify Produto, Coleção, Home, Post do blog
Wix Produto, Coleção, Home, Post do blog, Página do site

Cada aba tem seu próprio visual, seu próprio texto e seus próprios switches ao vivo. Salvar um tipo de página nunca altera outro. A pré-visualização é a capa real: ela é renderizada a partir do mesmo template e das mesmas props que a página ao vivo usará.

O WooCommerce também coloca um pequeno painel de capa na tela de edição do produto, para que você possa ver e alterar a capa sem sair do produto. O Shopify coloca um bloco FastOG na página do produto no admin pelo mesmo motivo. O Wix mantém tudo no app.

Escolhendo um visual

O visual é o layout que a capa desenha — o template. O seletor mostra o catálogo inteiro, com os visuais bloqueados marcados para o plano que os desbloqueia.

Plano Visuais
Community O conjunto gratuito
Starter O conjunto Starter selecionado
Pro Todos os templates
Scale Todos os templates, além de renderização prioritária

Um visual bloqueado é uma vitrine, não uma escolha: você pode pré-visualizá-lo, e o aviso de upgrade indica o plano que o desbloqueia. O salvamento é recusado no servidor, então a pré-visualização e a capa publicada não podem divergir.

O mesmo seletor é usado quando você começa pelo assistente de configuração, e você pode mudar o visual de um tipo de página sem mexer nos outros.

Copiar e estilizar

Depois da aparência, o editor tem dois grupos de campos:

  • Conteúdo — o título, o subtítulo, o selo, as linhas de recursos, a imagem e qualquer outra coisa que o template exiba. Campos deixados vazios usam os dados da própria loja como fallback quando o template consegue preenchê-los.
  • Estilo — tema, cores, fonte, padrão e o acabamento. Os estilos são por template: um valor que faz sentido em um layout não é forçado em outro.

No WooCommerce e Shopify, todos os planos podem editar o texto e o estilo da regra da loja inteira. No Wix, os campos de conteúdo e estilo de formato livre são do construtor personalizado Pro: o Starter escolhe a aparência, e os campos fixos do preset são exibidos em vez de editados livremente.

O editor por produto, exclusivo do Pro, usa os mesmos campos aplicados a um item (veja abaixo), além da substituição do logo.

Um campo marcado como nunca preenchível é um que o FastOG se recusa a inventar. As avaliações são o caso comum: uma linha de estrelas vazia não é preenchida com uma média falsa.

Sinais ao vivo

Os sinais ao vivo são chaves nos bastidores, não texto que você digita. Eles decidem se a capa pode exibir o valor que o FastOG já conhece no momento do compartilhamento:

Sinal O que mostra Plano
Preço O preço atual, incluindo um preço riscado de comparação quando o produto está em promoção Todos os planos
Promoção A faixa de promoção / tratamento de preço riscado Todos os planos
Estoque Estoque baixo ("Apenas 3 restantes") e esgotado Todos os planos
Avaliação e número de avaliações A média real e o número de avaliações da loja Starter e acima
Piso de avaliação Oculta a linha de estrelas por completo abaixo de uma avaliação ou número de avaliações mínimo Pro e acima

O objetivo da chave é permitir que você mantenha um campo no layout, mas o oculte quando os dados forem fracos. Um produto com 3,1 estrelas e duas avaliações geralmente fica melhor sem linha de estrelas do que com uma linha fraca ao lado do preço.

Desativar um sinal não exclui nada: o valor continua sendo lido da loja, e a capa simplesmente não o imprime. Reativá-lo o exibe novamente na próxima renderização.

Capas por produto e por item

Uma capa por produto é uma capa salva para um item, sobreposta à regra do tipo de página. É um recurso Pro e Scale.

Plataforma Onde abri-la
WooCommerce Tela de edição do produto → o painel Capa do FastOG → Personalizar capa
Shopify Abra o produto no admin da Shopify → o bloco de produto FastOG → Personalizar capa
Wix Ainda não disponível por item; use a capa do tipo de página ou um visual que funcione bem para todos os produtos

No Pro, você pode alterar o visual, o texto, os selos e o estilo para esse produto específico. Produtos sem uma substituição continuam usando a regra do tipo de página. Limpar a substituição em um produto restaura a capa compartilhada; a escolha salva é mantida, não destruída, caso o plano mude depois.

O painel do produto também tem um link para o Studio, então a regra da loja inteira está a um clique de distância quando o produto não precisa de sua própria capa.

Regras para linhas de produtos

Uma regra com escopo refina a capa do produto para um grupo de produtos — uma tag, uma categoria, um tipo de produto, uma coleção (Shopify) ou um fornecedor. É um recurso do plano Scale.

Abra Covers → Covers for specific products (o título é o mesmo no WooCommerce e no Shopify). Adicione uma regra, escolha o escopo e a aparência, e salve. Os produtos que correspondem usam a aparência e o texto da regra; todo o resto mantém a capa do tipo de página.

A correspondência mais específica vence, então você não gerencia uma ordem. O contador de regras mostra quantas da cota do plano você já usou; uma regra pode ser excluída a qualquer momento. O Wix ainda não expõe regras com escopo.

Campanhas e retornos agendados

Um retorno agendado é a metade segura de uma campanha: você publica uma capa de Black Friday ou Sazonal agora e escolhe a data e a hora em que ela deve voltar para a capa que estava no ar antes. A metade do retorno está disponível em todos os planos, incluindo o Community.

Um início agendado é a metade do Scale. No Scale você também pode definir a data em que a capa da campanha entra no ar; abaixo do Scale o início fica pausado, com o design e as datas mantidos para que um upgrade possa retomá-lo. As duas transições são verificadas a cada cinco minutos, e os horários usam o fuso horário exibido abaixo dos campos.

As duas metades precisam de um fim: uma campanha com início mas sem fim nunca sairia do ar, então o formulário recusa isso. Limpar o fim cancela a campanha. Nada é excluído por uma interrupção no plano — as datas e o design permanecem.

Exportar um PNG

A ação Baixar PNG renderiza a capa que você está visualizando em 1200×630 e a baixa. É um recurso Pro e Scale no WooCommerce e no Shopify; o Wix ainda não o oferece.

O arquivo é gerado a partir do próprio template e das props do editor, então corresponde à pré-visualização em vez de um template de exportação separado. Use-o para um anúncio em marketplace, um deck ou uma postagem manual em que você não pode usar a URL ativa.

Planos, cobertura e limites

O FastOG vende cobertura, não créditos de renderização. Um plano cobre um número de itens do seu próprio catálogo e um conjunto de recursos; as renderizações não têm limite.

Community Starter Pro Scale
Preço Grátis $19 / mês $49 / mês $119 / mês
Itens cobertos 100 250 1.000 Ilimitado
Tipos de página Todos Todos Todos Todos
Aparências Conjunto gratuito Conjunto curado Todas Todas
Preço, promoção e estoque Sim Sim Sim Sim
Avaliações (estrelas + contagem) — Sim Sim Sim
Piso de avaliação — — Sim Sim
Capa por produto — — Sim Sim
Mapeamento de metafield — — Sim Sim
Exportação PNG — — Sim Sim
Regras para linhas de produto — — — Sim
Início de campanha — — — Sim
Retorno agendado Sim Sim Sim Sim
Renderização prioritária — — — Sim

O painel de cobertura mostra quantos dos seus itens o plano cobre, detalhados por produtos, categorias, home e posts do blog. Se o catálogo crescer além do limite, o painel indica o próximo plano e o limite dele; ele não para de renderizar silenciosamente. Faça upgrade em Plan (WooCommerce, Shopify) ou Plans (Wix).

A cobrança anual é o mesmo nível por 10 meses em um ano de 12 meses. O Wix cobra pelo próprio Wix; o WooCommerce e o Shopify cobram pela visualização de planos no app.

O Wix usa a mesma escada, mas ainda não expõe a substituição por produto, as regras com escopo nem a exportação PNG. Lá, o plano ainda controla cobertura, aparências, avaliações e o construtor personalizado.

Verificações de integridade e atualizações de cache

O app executa uma verificação de integridade rápida e mantém a lista completa em Detalhes / O que verificamos. Ela responde às perguntas que realmente quebram uma prévia:

  • O FastOG consegue ler os dados e o catálogo desta loja?
  • O og:image da vitrine aponta para o FastOG, ou um tema ou plugin de SEO está prevalecendo?
  • O produto de exemplo é real, e a prévia o utiliza?
  • A chave de assinatura e a conexão ainda são válidas?

Cada constatação traz uma correção quando existe uma. O relatório é o bloco a copiar em uma mensagem de suporte; ele foi feito para ser colado, não interpretado.

Uma capa que mudou nem sempre é uma capa que a plataforma releu. A URL assinada é determinística, então a imagem em si é atualizada; o que fica em cache é a cópia da prévia da página pela plataforma. Refaça o scrape ou aguarde o cache da plataforma expirar — veja o guia de cache e como forçar uma atualização no Facebook. Se o og:image da página ainda for o do tema, a verificação de integridade mostrará que outro plugin ou o tema está prevalecendo.

Suporte

Use Suporte para problemas de configuração, entrega de capas, cobrança ou produto. Inclua a página ou o produto afetado, o que você esperava e o que aconteceu; o relatório de integridade é o anexo mais rápido. Este é um suporte de produto assíncrono, não um chat ao vivo nem uma consultoria geral.

Antes de abrir um ticket, tente a verificação de integridade: ela detecta as causas comuns (não conectado, não servindo capas, um plugin de SEO sobrescrevendo og:image, um cache de plataforma desatualizado).

Solução de problemas em uma página

Sintoma Verifique primeiro
O link compartilhado não tem imagem Verificação de integridade → a vitrine é og:image do FastOG? O tipo de página está coberto?
A prévia mostra o preço antigo O cache da plataforma; a URL ativa é assinada a cada renderização. Faça o re-scrape da página
A capa está com a aparência errada A regra de tipo de página, uma regra com escopo ou uma substituição por produto (a mais específica vence)
Uma aparência bloqueada não salva Ela pertence a um plano superior; o seletor informa o plano
Uma avaliação está faltando O produto ainda não tem avaliações, ou o plano é inferior ao Starter, ou a opção de avaliação está desativada
Uma alteração por produto não fez efeito Capas por produto são Pro/Scale, e o servidor recusa o salvamento abaixo disso
A capa está desfocada no WhatsApp Veja Tamanho da imagem OG e Prévias no WhatsApp

Experimente grátis — sem necessidade de cadastro

Visualize e teste imagens OG dinâmicas em segundos.

Abrir o Testador de Imagens OG Grátis