Migrar blog do WordPress para HubSpot: quais métodos?

Um blog com centenas de posts é o ativo mais barato e mais difícil de reconstruir que uma operação de marketing tem. Foi produzido ao longo de anos, ganhou autoridade, e boa parte do tráfego orgânico da empresa hoje entra por um punhado desses artigos antigos.

Por isso, quando a decisão de migrar o blog do WordPress para HubSpot aparece, a pergunta que trava a mesa nunca é "dá para fazer". É "o que eu perco no caminho".

A resposta é mais previsível do que parece, porque a HubSpot documenta campo a campo o que a importação carrega. O problema é que quase todo material em português trata o assunto como se existisse um único botão, quando existem quatro caminhos com requisitos diferentes.

Vale marcar a fronteira desde já: migrar o site é outro projeto, com escopo de serviço próprio e redirecionamento de estrutura inteira, tratado no passo a passo da migração de WordPress para a HubSpot. Aqui o assunto é o acervo editorial, campo a campo.

Quais são as formas de migrar um blog do WordPress para a HubSpot?

A HubSpot documenta quatro métodos oficiais de importação de conteúdo para blog: conexão direta com o WordPress, arquivo XML, smart copy e arquivo CSV.

Legenda: migrar blog do WordPress para HubSpot é decidir, campo a campo, o que a importação carrega e o que fica para trás

Todos chegam ao mesmo lugar, um blog dentro do Content Hub (antes CMS Hub), mas partem de pontos de acesso diferentes ao conteúdo de origem.

A maioria das equipes conhece um e assume que é o único.

A diferença entre eles não é de qualidade, é de pré-requisito. Um depende de uma interface técnica estar aberta no seu servidor, outro de você conseguir gerar um arquivo de exportação, outro lê o conteúdo como um visitante leria.

Saber que existem três alternativas transforma bloqueio em desvio. Veja como cada um se posiciona:

Tabela: Métodos e escopo conforme a documentação de importação de conteúdo da HubSpot.

A sequência de decisão é curta: se a origem é WordPress, tente a conexão direta; se ela não conseguir ler o blog, vá para o XML; se a origem não é WordPress nem Squarespace, smart copy; se o acervo é pequeno ou você precisa de controle campo a campo, CSV.

Como funciona o WordPress connect da HubSpot?

O WordPress connect é o método que a HubSpot descreve como o mais rápido e automatizado quando o site suporta a API REST padrão do WordPress.

Você informa a URL da página inicial do blog, a plataforma lê o acervo, lista os posts encontrados e você seleciona o que importar. Está disponível em todos os produtos e planos.

Essa última informação evita uma dúvida comum de orçamento: importar blog não é recurso de plano superior. O que existe é requisito de permissão, porque o usuário precisa das permissões de edição, publicação e importação.

O caminho é direto: nas configurações, em Content > Blog, abra o menu de visualização atual, escolha importar blog, depois posts de blog, depois WordPress connect. Informe a URL da home, escolha qual blog da HubSpot recebe o conteúdo, mande copiar os posts, revise a lista e selecione os que entram.

Dois pontos aparecem no fim e merecem atenção antes do clique. O primeiro é a escolha entre importar como rascunho ou já publicado.

O segundo ponto é a opção de sobrescrever conteúdo existente, útil em uma segunda rodada e perigosa se alguém já editou os posts dentro da HubSpot depois da primeira carga.

Uma observação de honestidade técnica: não existe número oficial publicado para quantidade máxima de posts nesse método, e qualquer limite citado por aí é estimativa de terceiro.

O caminho seguro é rodar uma importação piloto pequena, conferir o resultado e só então processar o acervo inteiro.

Quando usar importação por XML, smart copy ou CSV?

Os três métodos alternativos cobrem os casos em que a conexão direta não se aplica. A importação por XML atende origem em WordPress ou Squarespace e usa o arquivo de exportação da própria plataforma. O smart copy lê blogs de qualquer CMS. O CSV parte de uma planilha montada por você, com os campos do post preenchidos.

A ordem de preferência não é arbitrária.

Importar blog por XML é a alternativa natural quando a API REST está indisponível, porque o arquivo de exportação do WordPress ou do Squarespace é gerado na origem e não depende de a HubSpot acessar seu servidor por uma interface programática. Se o TI não vai liberar a API, esse é o desvio.

O smart copy resolve o cenário mais aberto: qualquer CMS, incluindo plataformas proprietárias e ferramentas sem exportação decente. Ele parte do conteúdo publicado, e por isso é a única opção viável quando o acesso administrativo à origem já foi perdido, situação frequente em blogs herdados de agências anteriores.

O CSV é o método de controle, onde você monta a planilha, decide o valor de cada campo e sobe. Faz sentido para acervos pequenos ou quando a operação prefere padronizar títulos de SEO e meta descrições antes de publicar, em vez de corrigir depois.

Um detalhe de escopo que evita frustração: artigos de base de conhecimento têm importação própria, separada do blog. Se a sua operação mantém os dois no WordPress, são dois projetos.

O que migra de cada post do WordPress para a HubSpot?

A conexão direta com o WordPress traz nove elementos de cada post: título, título de SEO, meta descrição, corpo, informação de autor, data de publicação, imagem destacada, categorias e tags.

É um inventário explícito na documentação, o que permite planejar a conferência pós-importação com precisão em vez de auditar tudo no escuro.

O que pode surpreender positivamente é a presença dos campos de SEO. Título de SEO e meta descrição vêm junto, ou seja, a otimização feita ao longo de anos não precisa ser refeita artigo por artigo. O que fica de fora é curto, mas específico:

Tabela: Escopo do que é e não é importado conforme a documentação de importação de blog WordPress da HubSpot.

A leitura prática é que o conteúdo em si viaja bem. O que exige atenção é a periferia: perfis de autor, estruturas que não são posts comuns e a conferência de como cada imagem destacada se comporta no novo template.

O que não migra e precisa de trabalho manual depois?

Dois itens estão documentados como fora do escopo, que são os tipos de post customizados e imagem de perfil de autor, que a HubSpot registra que não será importada a menos que esteja incluída no corpo do post. São poucos itens, mas ambos podem representar volume real de trabalho dependendo de como o WordPress foi construído.

Tipos de post customizados merecem uma pausa.

No WordPress, é comum que estudos de caso, depoimentos, vagas, cursos, eventos e materiais para download tenham sido criados como estruturas próprias, e não como posts de blog.

Do ponto de vista do gestor, tudo isso "está no blog". Do ponto de vista da importação, não é blog, e não vem. Levantar essa lista antes de qualquer coisa costuma redesenhar o cronograma.

Perfis de autor são um trabalho pequeno e visível: como só a informação do autor viaja, as fotos precisam ser resubidas e associadas dentro da plataforma.

Existe ainda uma terceira frente, que a prática de projeto ensina a checar: links internos apontando para as URLs antigas e referências de imagem ainda servidas pelo domínio de origem. Esses links funcionam no dia da importação e viram problema quando a estrutura antiga sai do ar.

Priorizar os vinte artigos que sustentam o tráfego resolve a maior parte do risco com uma fração do esforço. A priorização fica mais fácil quando a operação já tem clareza sobre como otimizar o blog.

Por que a API REST bloqueada impede importar posts para a HubSpot?

Porque o WordPress connect funciona lendo o blog pela API REST padrão do WordPress. Sem esse acesso, a HubSpot não enxerga o acervo e a importação não parte. A causa mais comum não é uma falha, é um plugin de segurança fazendo exatamente aquilo para que foi instalado, e a própria HubSpot documenta o cenário.

Esse é o ponto que mais gera chamado aberto sem diagnóstico.

O sintoma é discreto. A tela pede a URL da página inicial do blog, você informa, e o resultado é uma falha genérica ou uma lista vazia.

Ninguém pensa em plugin, porque o site está no ar e o blog abre no navegador. E o blog não está quebrado: a API REST é uma porta separada da que o visitante usa, e é comum que esteja fechada por política de hardening.

A verificação é simples e não exige acesso ao servidor. Abra no navegador o endpoint padrão da API, acrescentando /wp-json/wp/v2/posts ao domínio do blog.

Se voltar uma resposta em formato de dados, a interface está acessível. Se voltar erro de autorização, erro 403 ou página de bloqueio, ali está a causa da importação que não anda.

A partir daí a conversa muda de lugar: deixa de ser suporte da HubSpot e passa a ser decisão de quem administra o WordPress, entre liberar o acesso durante a janela de importação ou manter o bloqueio.

Se a resposta for manter o bloqueio, o desvio já está mapeado, que é a importação por XML.

Em projetos de migração, o erro que mais custa tempo aqui é insistir no método automatizado por dias em vez de acionar o desvio na primeira tentativa frustrada.

Importar os posts como rascunho ou publicar direto?

A importação permite trazer os posts como rascunho ou já publicados, e a escolha define o nível de controle.

Rascunho é o padrão recomendável em qualquer acervo com volume relevante, porque permite conferir formatação, imagens e URLs antes de o conteúdo ficar visível. Publicar direto só faz sentido quando o blog de destino ainda não está no ar.

A diferença aparece na hora do erro, não na hora do acerto. Importar publicado significa que qualquer problema de formatação, imagem quebrada ou título duplicado nasce visível para visitante e para buscador. Importar como rascunho significa que o problema nasce interno, e você decide quando ele deixa de ser.

Existe um contraponto legítimo a favor de publicar direto: rascunho em volume alto cria uma fila de revisão que precisa de gente e de prazo, e acervo parado não gera tráfego nenhum.

O arranjo que funciona combina as duas coisas: importar tudo como rascunho, publicar em lotes por prioridade de tráfego e definir uma data limite para o restante mesmo sem revisão individual.

Assim, os artigos que sustentam a operação entram primeiro e conferidos, e a cauda longa não fica presa indefinidamente.

O que fazer com as URLs antigas para migrar blog sem perder ranqueamento?

Mapear cada URL antiga para a nova e criar redirecionamentos 301. Esta é a camada que a importação não cobre: o artigo oficial do WordPress connect trata de copiar conteúdo, não de preservar posicionamento. Migrar blog sem perder ranqueamento depende do redirecionamento, e ele é configurado em outro lugar da plataforma.

Vale insistir nesse ponto, porque ele é a origem de quase toda perda de tráfego em migração de acervo.

A ferramenta fica em Content > Domains & URLs > URL Redirects, e a documentação descreve dois formatos: redirecionamento padrão, de uma URL para outra, e por padrão flexível, que atualiza endereços a partir da estrutura.

O código 301, permanente, é o padrão para novos redirecionamentos. Também existe carga em massa por planilha, único caminho sustentável para centenas de posts.

O padrão flexível é o que economiza trabalho em blog.

Blogs têm estrutura repetitiva, e é comum que a mudança seja só de prefixo, por exemplo de /blog/2019/03/titulo-do-post para /blog/titulo-do-post. Uma regra flexível bem escrita resolve centenas de casos de uma vez, enquanto o redirecionamento padrão fica reservado às exceções.

E existe uma limitação a ler antes de qualquer planejamento: os redirecionamentos da HubSpot só funcionam em domínios conectados e hospedados na plataforma. Se o blog antigo continua servido por um domínio hospedado fora, o redirecionamento precisa ser feito no provedor de origem.

A limitação de domínio amarra a decisão do acervo à de infraestrutura, porque as regras de conexão de domínio na HubSpot determinam o que é possível em cada assinatura, inclusive a existência de um subdomínio primário por tipo de conteúdo. Definir isso antes da importação evita republicar o acervo depois.

Quais configurações de blog faltam depois da importação?

A importação traz conteúdo, não configuração. Depois dela restam as definições do blog em si: template e layout de listagem, perfis de autor, taxonomia consolidada, URL e subdomínio, integração de analytics, exclusão de tráfego interno das métricas, revisão das recomendações de SEO e conferência dos formulários que aparecem nos posts.

O próprio checklist oficial de publicação da HubSpot lista configurar os ajustes do blog como item separado da migração de conteúdo. Cinco frentes costumam ficar pendentes e vale tratá-las como tarefas com responsável:

• Template e listagem. O post migrado assume o template do blog de destino, e detalhes como recorte da imagem destacada, exibição de autor e paginação só aparecem depois da primeira publicação.
• Taxonomia consolidada. Categorias e tags vêm da origem, inclusive as duplicadas e as usadas uma única vez. É o melhor momento para consolidar, porque o esforço já está aberto.
• Autores. Perfis, biografias e fotos precisam ser montados dentro da plataforma, já que a foto não viaja na importação.
• Analytics. Excluir o tráfego interno evita que o primeiro relatório pós-migração seja lido como crescimento quando é o próprio time navegando. O acervo migrado passa a alimentar os relatórios, e a leitura de dados dentro da HubSpot fica confiável na medida em que essa base está limpa.
• SEO técnico. Rodar a revisão das recomendações de SEO da plataforma sobre o acervo recém-importado tende a revelar meta descrições vazias e títulos duplicados que já existiam na origem e passaram desapercebidos por anos.

Nenhuma dessas tarefas é difícil. Todas são invisíveis, e é por isso que somem do cronograma. O trabalho de otimização de conteúdo dentro da HubSpot começa aqui, e é o que transforma uma importação técnica em ganho real de marketing de conteúdo.

Perguntas frequentes sobre migrar blog do WordPress para HubSpot

Afinal, como planejar a migração do acervo sem travar a produção?

Comece pelo levantamento, não pela ferramenta. Quantos posts existem, quantos deles são de fato posts de blog e não estruturas customizadas, quais vinte trazem a maior parte do tráfego e qual é o padrão atual das URLs. Com essas quatro respostas na mão, a escolha entre os quatro métodos leva minutos e o cronograma para de ser chute.

Depois, resolva a ordem: subdomínio definido, importação piloto, validação campo a campo, redirecionamentos mapeados, importação completa como rascunho, publicação em lotes por prioridade e só então o acervo antigo sai do ar.

Essa é a mesma lógica de dependência que governa o resto do projeto, e ela fica mais clara quando implementar a HubSpot é lido como fases encadeadas em vez de tarefas paralelas.

Um acervo bem migrado mantém a máquina de inbound marketing rodando durante a troca de plataforma, em vez de reiniciar do zero.

Falta uma metade da decisão. Quem está calculando o custo de trazer os posts vai precisar decidir o que fazer com as páginas, os formulários e a estrutura do site institucional.

O escopo dessa outra metade, com o que o serviço oficial inclui, o que ele deixa de fora e como tratar os redirecionamentos em volume, está no guia de migração de WordPress para a HubSpot sem perder o SEO.