Acervo Vivo Sync: Integração de Acervo de Arte no WordPress

"Aplica-se a: Studio, Guardian, Galleria" "Keyword: sincronizar acervo wordpress integracao plugin sync api webhooks" "Title: Acervo Vivo Sync: Sincronização e Integração de Acervo no WordPress | Central de Ajuda - Acervo Vivo" "Meta: Conecte a curadoria do Acervo Vivo ao seu site WordPress. Sincronize obras, exposições e publicações em tempo real com total soberania." "Slug: plugin-wordpress" "Alt-Capa: Painel de controle do plugin WordPress Acervo Vivo Sync de integração de acervo de arte" "HelpContext: settings" "Guardião Oficial: SME Central de Ajuda e Adinha (IA)"

O Acervo Vivo Sync é o plugin WordPress oficial para sincronizar e expor o catálogo da plataforma curatorial Acervo Vivo (Headless CMS/Airtable). Ele automatiza o espelhamento físico de mídias, gerencia taxonomias e expõe dados em tempo real sob medida para artistas, galerias e colecionadores.

O que é o Acervo Vivo Sync?

O Acervo Vivo Sync é a ponte inteligente entre a curadoria física/catalogação da sua plataforma e o seu site público. Criado sob medida para artistas, galerias e acervos privados, o plugin recria nativamente no WordPress todas as suas obras de arte, mostras, ensaios críticos e catálogos de livros em estruturas organizadas de forma limpa, rápida e totalmente otimizada para o Google.

Diferenciais Técnicos e de Curadoria

Foco Absoluto na Obra (Sem distrações)

O site é projetado para destacar o trabalho artístico. Fichas técnicas, legendas e carrosséis adicionais de imagens são integrados de forma limpa e fluida. As listas de exposições e bibliografias nas páginas de obras são apresentadas em formato textual simples, evitando links de saída que dispensam o foco do seu visitante.

Sincronização Automática ou Em Tempo Real (Instantâneo)

Chega de esperar o dia virar para refletir uma alteração de status ou uma venda. Além da sincronização diária em segundo plano, o plugin possui integração com Webhooks, permitindo que qualquer alteração de curadoria ou disponibilidade no painel reflita no seu site WordPress em poucos segundos.

Soberania Digital (Seus dados pertencem a você)

Livre-se da dependência de plataformas exclusivas (vendor lock-in). Se você decidir cancelar a assinatura, o seu site WordPress permanece 100% no ar, funcional e com todos os dados técnicos e imagens intactos e locais. A plataforma funciona apenas como o canal de curadoria; o legado digital gerado é irrevogavelmente seu.

Asset Mirroring (Imagens Locais e Protegidas)

Ao invés de carregar links temporários da nuvem que expiram rapidamente, o plugin realiza o download físico das fotos principais e carrosséis de imagens diretamente para a Biblioteca de Mídia do seu próprio servidor WordPress, garantindo que as imagens nunca fiquem quebradas.

Pronto para Desenvolvedores e SEO

Com Custom Post Types nativos (obras, exposicoes, textos, publicacoes) e links amigáveis, o plugin é compatível com qualquer tema do mercado e permite que o desenvolvedor do seu site customize o layout como desejar.

Como Funciona? (3 Passos Simples)

Instale o Plugin: Baixe o arquivo .zip e faça o upload na seção "Plugins" do seu WordPress.
Conecte com sua API ID: Insira a chave única de conexão gerada no seu painel do Acervo Vivo na tela de configurações do plugin.
Crie suas Grades Visuais: Use o shortcode [acervo_grade tipo="obras"] para renderizar instantaneamente uma galeria responsiva em qualquer página, utilizando os construtores de sua preferência (Gutenberg, Elementor ou Construtor Clássico).

Funcionalidades Principais

Sincronização em Tempo Real (Webhook): Atualização instantânea de status de venda ou novas obras sem depender do agendamento diário.
Renderização Dinâmica (Arquitetura Limpa): Mantém o banco de dados limpo gravando apenas textos brutos (post_content), montando os layouts premium e badges em tempo de exibição via hook the_content.
Segurança contra Sobrecarga (Race Conditions): Sistema de trava de concorrência que impede "tempestades de sincronização" no servidor (retorna 409 Conflict).
Asset Mirroring (Download Local): Salva as fotos na biblioteca do WordPress de forma idempotente, contornando a expiração de assinaturas CDN externas.
Resolução de IDs Nativos: Traduz as relações do Airtable em IDs de posts reais do WordPress (_acervo_wp_*_ids) para consultas rápidas no frontend.

Sincronização em Tempo Real via Webhook

O plugin expõe um endpoint REST público e seguro para receber alertas de alteração da plataforma de curadoria.

Rota do Webhook

URL: POST /wp-json/acervo-vivo/v1/sync-trigger
Content-Type: application/json

Autenticação

A chamada exige o identificador exclusivo apiId (o mesmo salvo nas configurações do plugin) passado de duas formas:

No cabeçalho da requisição HTTP: X-Acervo-API-ID
No payload JSON: apiId

Exemplos de Teste do Gatilho

Teste 1: Autenticação via Cabeçalho (cURL)

Substitua seu-site.com e seu-api-id com os dados correspondentes:

curl -X POST https://seu-site.com/wp-json/acervo-vivo/v1/sync-trigger \
  -H "Content-Type: application/json" \
  -H "X-Acervo-API-ID: seu-api-id"

Teste 2: Autenticação via Corpo JSON (cURL)

curl -X POST https://seu-site.com/wp-json/acervo-vivo/v1/sync-trigger \
  -H "Content-Type: application/json" \
  -d '{"apiId": "seu-api-id"}'

Teste 3: Utilizando PowerShell

$headers = @{
    "Content-Type" = "application/json"
    "X-Acervo-API-ID" = "seu-api-id"
}
Invoke-RestMethod -Uri "https://seu-site.com/wp-json/acervo-vivo/v1/sync-trigger" -Method Post -Headers $headers

Respostas da API (HTTP Status Codes)

200 OK: Sincronização concluída com sucesso. Exemplo de retorno:

{
  "status": "success",
  "message": "[Webhook] Sincronização via Webhook realizada com sucesso: 12 Obras, 2 Exposições...",
  "stats": {
    "created": 1,
    "updated": 5
  }
}

401 Unauthorized: Chave apiId inválida, ausente ou não configurada no painel.
409 Conflict: Outra rodada de sincronização já está ativa no servidor (trava de segurança temporária ativa).
500 Internal Server Error: Instabilidade na conexão com o servidor do Acervo Vivo ou falha fatal na ingestão de dados.

Exibição de Grades (Shortcode)

Insira o shortcode em qualquer editor de blocos, Elementor ou construtor clássico:

Listagem de Obras: [acervo_grade tipo="obras"]
Filtrar Obras por Linguagem: [acervo_grade tipo="obras" linguagem="Colagem"]
Filtrar Obras por Série: [acervo_grade tipo="obras" serie="Paisagens"]
Limitar quantidade: [acervo_grade tipo="obras" limite="6"]