Sincronização de Dados do Blog WordPress com o Google Sheets - Fluxo de trabalho n8n

Especialistas em SEO que necessitam de dados de conteúdo estruturados para análise.
Gestores de conteúdo que exigem uma base de dados centralizada de todas as publicações efetuadas.
Desenvolvedores à procura de modelos n8n robustos para lidar com paginação de API.
Qualquer pessoa que precise integrar o seu sistema de gestão de conteúdo WordPress (CMS) com ferramentas externas de relatórios utilizando o n8n.

Gerir e analisar grandes volumes de dados do WordPress pode ser complexo quando se depende apenas do backend. Este fluxo de trabalho n8n avançado resolve este desafio ao criar um espelho das informações críticas do seu blog WordPress — incluindo Publicações, Categorias, Etiquetas e detalhes da Biblioteca de Mídia — diretamente num documento do Google Sheets.

Este fluxo de trabalho n8n específico lida com requisitos complexos, como a paginação da API para publicações e mídia, garantindo que mesmo blogs grandes sejam sincronizados completamente. A lógica utiliza uma abordagem 'upsert' no nó Google Sheets do n8n, o que significa que atualizará as entradas existentes (com base no ID) ou adicionará novas, fornecendo uma solução de sincronização contínua e fiável. Este robusto modelo de automação n8n é concebido para execução diária ou sob demanda, tornando os seus dados de blog imediatamente utilizáveis para relatórios e inteligência de negócios (BI).

Este guia de automação n8n abrangente explica o processo de sincronização em várias fases:

1. Disparo e Inicialização: O fluxo de trabalho n8n é ativado através de um Schedule Trigger (Acionador Programado) ou de uma ativação manual via Webhook. O processo começa por configurar variáveis de paginação cruciais (ex: currentpage, perpage) no nó inicial Variables do n8n.


2. Ciclo de Sincronização de Publicações:

Para configurar este poderoso modelo de fluxo de trabalho n8n, siga estes passos:

1. Importar: Copie o JSON fornecido e importe-o para a sua instância n8n alojada (self-hosted) ou na nuvem.


2. Configuração de Credenciais: Deve configurar dois tipos de credenciais:

1. Preparação da Folha Google: Crie uma nova Folha Google com base no modelo vinculado na nota adesiva do fluxo de trabalho (se disponível) ou crie uma folha com separadores dedicados denominados 'Posts', 'Categories', 'Tags' e 'Media' que correspondam aos cabeçalhos de coluna esperados pelas configurações dos nós Google Sheets do n8n (ex: id, slug, title, date).


2. Personalização: Atualize o nó Variables no início para substituir a base_url de espaço reservado (https://ozwebexpert.com/wp-json/wp/v2/posts) pelo URL real do seu domínio WordPress.


3. Ativação: Ative o acionador n8n (Schedule ou Webhook) para iniciar a sincronização. Execute o fluxo de trabalho n8n manualmente para a primeira sincronização completa.

Este fluxo de trabalho n8n utiliza vários tipos de nós n8n chave para alcançar a sincronização abrangente:

Schedule Trigger / Webhook: Estes são os principais mecanismos de acionamento do n8n que permitem execuções diárias programadas ou execução manual.
Variables (nó Set do n8n): Utilizado para inicializar e armazenar parâmetros de configuração como o URL base da API, o tamanho da paginação (perpage) e a currentpage de início. Isto simplifica a manutenção dentro do modelo n8n geral.
Loop Vars / Loop Vars2 (nó Code do n8n): Essencial para lidar com a paginação. Este código personalizado incrementa a variável currentpage usada no nó HTTP Request subsequente do n8n, permitindo a iteração sobre múltiplas páginas de resultados.
Get Posts / Get Media / Get Categories (nó HTTP Request do n8n): Funcionalidade central para interagir com os endpoints da API REST do WordPress. A configuração chave inclui o uso de Autenticação Básica HTTP e o envio de parâmetros de consulta (perpage, page, embed, fields). O nó Get Posts captura especificamente o cabeçalho de páginas totais (x-wp-totalpages).
Split Out (nó n8n): Usado após cada pedido de API em lote (Get Posts, Get Media, etc.) para transformar o item de resposta única contendo muitos registos em múltiplos itens individuais, permitindo que o nó Google Sheets do n8n os processe um de cada vez.
Update Posts / Update Categories / Update Media (nó Google Sheets do n8n): Configurado para a operação appendOrUpdate. A definição crítica aqui são as 'Colunas Correspondentes' (id, categoryid, mediaid), o que garante que os dados são sincronizados em vez de duplicados. Este robusto nó n8n é vital para o processo de sincronização.

• If (nó n8n): Usado para controlo de fluxo nos ciclos de paginação (If e If1). Compara a página atual com o cabeçalho de páginas totais para decidir se o fluxo de trabalho n8n deve terminar o ciclo ou continuar para a próxima iteração através do nó Loop Vars do n8n.