Enviar rascunhos do GEO Writer para o WordPress

A ligação ao WordPress envia para o seu site WordPress, como rascunhos, os artigos e as atualizações de conteúdo concluídos no GEO Writer. Pode rever, editar e publicar esses rascunhos no WordPress, como habitualmente. O LLM Pulse nunca publica um artigo, nunca edita um artigo existente e nunca elimina nada.

A mesma ligação permite que a API REST e os assistentes de IA ligados através do MCP leiam os artigos e as páginas do seu site, por exemplo, para comparar uma atualização do GEO Writer com a página que essa atualização revê.

Antes de começar

Precisa de:

Um site com o WordPress 5.6 ou posterior, servido por HTTPS e com as senhas de aplicação ativadas. Estão ativadas por predefinição, mas alguns plugins de segurança desativam-nas.
Um utilizador do WordPress que possa escrever artigos, como um Autor ou um Editor. Um Administrador também funciona, mas é apresentado um aviso: o LLM Pulse só cria rascunhos, por isso um utilizador com menos permissões limita o que a respetiva senha de aplicação pode fazer.

A ligação não tem nenhum requisito de plano próprio: se pode utilizar o GEO Writer, pode enviar os respetivos rascunhos. Cada projeto liga-se a um único site WordPress.

A ligação ao WordPress não está disponível nos portais de marca branca nem nos painéis incorporados.

Ligar o seu site

Abra as Definições do projeto, selecione o separador Ligações e procure o cartão WordPress.
Introduza o endereço do seu site, por exemplo, blog.example.com, e selecione Continuar. Se o endereço redirecionar para outro (por exemplo, de example.com para www.example.com), sugerimos que ligue o endereço que o site utiliza realmente.
Selecione Aprovar no WordPress. O WordPress pede-lhe que inicie sessão e aprove a ligação ao LLM Pulse e, em seguida, cria uma senha de aplicação para o LLM Pulse. Depois, regressa automaticamente ao LLM Pulse.

Se o WordPress estiver num endereço diferente do das suas páginas públicas (por exemplo, o WordPress em wp.example.com e as páginas em www.example.com), introduza o endereço do WordPress. Os links para as suas páginas públicas são reconhecidos como pertencentes ao seu site quando são servidos por HTTPS.

Se não puder utilizar o ecrã de aprovação, cole uma senha de aplicação. No WordPress, abra Utilizadores > Perfil > Senhas de aplicação, adicione uma com o nome LLM Pulse e cole-a em Ou cole uma senha de aplicação, juntamente com o seu nome de utilizador do WordPress. Nunca cole a palavra-passe de início de sessão do WordPress: recusamos tudo o que não pareça uma senha de aplicação.

Depois de ligado, o cartão WordPress mostra o site, o utilizador do WordPress e a respetiva função. Se mais tarde ligar o projeto a outro site, o painel Rascunhos do WordPress deixa de mostrar os rascunhos enviados para o site anterior; esses rascunhos continuam no WordPress desse site.

Enviar um rascunho

No GEO Writer, abra um artigo ou uma atualização de conteúdo concluídos. Os briefings e os restantes tipos de tarefa não podem ser enviados.
Abra o menu de exportação e selecione Enviar para o WordPress como rascunho.

O rascunho é criado em segundo plano, normalmente em poucos segundos. O painel Rascunhos do WordPress, na página da tarefa, mostra cada rascunho com o respetivo estado e, assim que o WordPress o confirmar, um link Editar no WordPress.

O que o rascunho contém:

O título, um slug legível e o corpo do artigo em HTML, o mesmo conteúdo que obtém com Copiar como HTML.
A meta descrição, como excerto do artigo.
Um comentário HTML no início do corpo que indica que o texto foi gerado por IA. Não fica visível na página.

As imagens, os scripts, os formulários e os elementos incorporados ficam de fora. Os títulos, os parágrafos, as listas, as tabelas, as citações, o código e os links são mantidos.

Uma atualização de conteúdo dá origem a um novo rascunho, e o painel Rascunhos do WordPress indica a página que essa atualização revê. A página publicada mantém-se como está: compare as duas no WordPress e copie o que quiser manter.

Voltar a enviar a mesma versão de uma tarefa não cria um segundo rascunho. Se editar a tarefa no GEO Writer, pode enviar a nova versão como um novo rascunho. Cada site aceita até 50 rascunhos do LLM Pulse em 24 horas.

Ler o seu site através da API e do MCP

Com um site ligado, a API REST e o MCP podem lê-lo e enviar-lhe rascunhos:

O quê	API REST	Ferramenta MCP
Listar artigos ou páginas	`GET /api/v1/cms/content`	`list_cms_content`
Ler um artigo ou uma página	`GET /api/v1/cms/content/:id`	`get_cms_content`
Enviar uma tarefa como rascunho	`POST /api/v1/intelligence_tasks/:id/send_to_cms`	`send_intelligence_task_to_cms`

O MCP com OAuth funciona em todos os planos; a API REST e o MCP com uma chave de API exigem o plano Scale ou superior, tal como o resto da API. O site responde em tempo real e nada do que devolve é guardado. Para enviar um rascunho através da API, precisa de uma chave com acesso de Leitura e escrita. Só é possível ligar e desligar um site nas Definições do projeto. Consulte Visão geral da REST API e Ligue o seu assistente de IA à LLM Pulse através de MCP.

Membros da equipa

Os membros da equipa precisam da permissão WordPress:

Permissão	O que permite
Ler	Listar e ler o conteúdo do site através da API e do MCP
Criar	Enviar rascunhos do GEO Writer
Atualizar	Ligar um site ou voltar a ligá-lo
Eliminar	Desligar um site

Desligar

Abra Definições do projeto > Ligações, procure o cartão WordPress e selecione Desligar. Revogamos a senha de aplicação que o LLM Pulse utiliza no site. Os rascunhos que já estão no WordPress permanecem lá, mas o painel Rascunhos do WordPress das suas tarefas do GEO Writer deixa de os mostrar.

Eliminar o projeto ou a sua conta revoga a senha da mesma forma. Se não conseguirmos aceder ao site para a revogar, o projeto é desligado na mesma e é apresentado um aviso. Nesse caso, remova a senha diretamente no WordPress, em Utilizadores > Perfil > Senhas de aplicação.

Resolução de problemas

Quando uma ligação falha, o cartão WordPress indica o que correu mal e apresenta um link para a secção correspondente, mais abaixo. Abra Detalhes para o seu programador para ver o que o site respondeu: o endereço, o passo que falhou, o estado HTTP, o código de erro do WordPress e alguns cabeçalhos da resposta. Copie-os e envie-os a quem gere o seu site. Nunca incluem nomes de utilizador nem palavras-passe.

Se a falha ocorreu depois de aprovar a ligação, o WordPress pode ter criado uma senha de aplicação com o nome LLM Pulse que não podemos utilizar. Elimine-a em Utilizadores > Perfil > Senhas de aplicação antes de tentar novamente.

Os nossos pedidos utilizam o User-Agent LLMPulse-WordPress/1.0 e vêm de servidores na Alemanha.

O servidor remove o cabeçalho de autenticação

O WordPress lê a senha de aplicação a partir do cabeçalho Authorization. Alguns servidores removem esse cabeçalho antes de o WordPress ser executado, pelo que o WordPress trata o nosso pedido como anónimo. O seu programador ou fornecedor de alojamento pode deixá-lo passar.

No Apache, adicione esta linha ao .htaccess, acima do bloco do WordPress:

SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Se não for suficiente, adicione RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] logo a seguir a RewriteEngine On.

No nginx com PHP-FPM, adicione isto ao bloco que encaminha os pedidos para o PHP:

fastcgi_param HTTP_AUTHORIZATION $http_authorization;

Atrás de um proxy inverso ou no LiteSpeed, reencaminhe o cabeçalho Authorization para o WordPress. Num alojamento gerido, peça ao suporte que permita a autenticação básica em /wp-json/.

Se o site funcionava e agora lhe é pedido que volte a ligá-lo, a senha de aplicação foi revogada ou uma alteração no servidor começou a remover o cabeçalho. Comece por voltar a ligar e, se não resultar, verifique o cabeçalho.

O WordPress não aceita a senha de aplicação

A senha de aplicação foi introduzida com erros, foi revogada ou pertence a outro utilizador. Crie uma nova em Utilizadores > Perfil > Senhas de aplicação e volte a ligar. Nunca utilize a palavra-passe de início de sessão do WordPress.

O nome de utilizador não existe

Quando colar uma senha de aplicação, introduza o nome de utilizador do WordPress ou o endereço de email do utilizador que a criou. O nome a mostrar não funciona.

As senhas de aplicação estão desativadas

O WordPress só disponibiliza senhas de aplicação nos sites em que deteta HTTPS, e os plugins podem desativá-las. Verifique:

Os plugins de segurança, como o Wordfence ou o Solid Security, que têm uma definição para desativar as senhas de aplicação, por vezes por função ou por utilizador.
O código do tema ou de um plugin personalizado que utilize os filtros wp_is_application_passwords_available ou wp_is_application_passwords_available_for_user.
A deteção de HTTPS. Atrás de um proxy, de um balanceador de carga ou de uma CDN, o WordPress pode não detetar que o site é servido por HTTPS. Faça com que o proxy envie X-Forwarded-Proto e adicione o excerto de código abaixo ao wp-config.php, acima da linha que indica que deve parar de editar.
O tipo de ambiente. Um site cujo WP_ENVIRONMENT_TYPE seja local disponibiliza senhas de aplicação sem HTTPS. Defina-o como production no site público.

if ( isset( $_SERVER['HTTP_X_FORWARDED_PROTO'] ) && 'https' === $_SERVER['HTTP_X_FORWARDED_PROTO'] ) {
    $_SERVER['HTTPS'] = 'on';
}

Um plugin bloqueia a API REST

Alguns plugins de segurança desativam a API REST, só a permitem para alguns utilizadores ou bloqueiam o endpoint de utilizadores para impedir a enumeração de utilizadores. Precisamos do índice do site em /wp-json/ e, para o utilizador ligado, de /wp-json/wp/v2/users/me e dos endpoints wp/v2 de artigos e de páginas. Permita-os nas definições do plugin.

Se o site responder com uma página web em vez da API REST, um plugin de cache ou de manutenção também pode estar a servir páginas em /wp-json/. Configure-o para excluir esse caminho.

Uma firewall bloqueia os nossos pedidos

Uma firewall, uma CDN ou um serviço de segurança à frente do seu site recusou o nosso pedido antes de o WordPress o receber: Cloudflare, Sucuri, uma regra da firewall do Wordfence, a firewall do seu fornecedor de alojamento ou um bloqueio por país. Permita os pedidos a /wp-json/ com o User-Agent LLMPulse-WordPress/1.0. As páginas de desafio, como um desafio gerido da Cloudflare, também nos bloqueiam, porque os nossos servidores não as conseguem resolver. Na Cloudflare, adicione uma regra personalizada da WAF com a ação Skip para /wp-json/ e faça o mesmo para /wp-admin/authorize-application.php se a página de aprovação apresentar um desafio.

O site pede uma palavra-passe separada

Os sites de staging estão muitas vezes protegidos com autenticação HTTP: o navegador pede um nome de utilizador e uma palavra-passe antes de o WordPress carregar. Essa proteção utiliza o mesmo cabeçalho que as senhas de aplicação, por isso as duas não podem funcionar em conjunto. Ligue o site público ou remova a proteção para /wp-json/.

Não foi possível encontrar a API REST

Confirme que o endereço é o do seu site WordPress. Procuramos a API REST em /wp-json/ e em /?rest_route=/.
Abra Opções > Ligações permanentes e selecione Guardar alterações. Se as regras de reescrita estiverem danificadas, /wp-json/ devolve um erro 404.
Numa configuração headless, o WordPress funciona num domínio diferente do das suas páginas. Ligue o domínio do WordPress.

O endereço do site não corresponde

O WordPress guarda dois endereços em Opções > Geral: Endereço do WordPress (URL) e Endereço do site (URL). Ambos têm de ser o endereço HTTPS público do seu site, com ou sem www, exatamente como o site o utiliza. Se contiverem http://, ou example.com quando o site está em www.example.com, o WordPress indica-nos outro endereço, e nunca enviamos uma palavra-passe para um endereço que não introduziu. Corrija os dois endereços ou peça ao seu programador que defina WP_HOME e WP_SITEURL no wp-config.php e, em seguida, ligue o endereço que o site utiliza.

Quando o seu endereço redireciona para outro, o cartão WordPress sugere que ligue o endereço que o site utiliza. Só seguimos redirecionamentos para endereços HTTPS.

A versão do WordPress é demasiado antiga

As senhas de aplicação surgiram no WordPress 5.6. Atualize o WordPress e, em seguida, volte a ligar.

O certificado SSL não é válido

Só nos ligamos através de HTTPS e com um certificado válido. Os detalhes indicam o que está errado: o certificado expirou, é autoassinado ou foi emitido para outro endereço. Renove ou substitua o certificado (a maioria dos fornecedores de alojamento oferece certificados gratuitos) e confirme que abrange o endereço exato que liga, com ou sem www.

Não foi possível aceder ao site

O endereço não aponta para nenhum servidor. Verifique se está bem escrito e confirme os registos DNS do domínio.
O servidor recusou a ligação. A porta 443 pode estar fechada, ou uma firewall pode estar a bloquear os nossos servidores na Alemanha.
O site demorou demasiado tempo. Enquanto liga o site, esperamos cerca de 10 segundos por cada resposta. Pergunte ao seu programador por que motivo /wp-json/ está lento: a causa habitual é um plugin pesado ou um servidor sobrecarregado.
O endereço é privado. Aponta para uma rede privada ou interna, como um site de staging numa intranet. Só nos ligamos a sites acessíveis a partir da internet.

Ocorreu um erro de servidor no site

O WordPress ou o servidor falhou ao responder, com um estado HTTP entre 500 e 599. Tente novamente mais tarde. Se continuar a acontecer, o registo de erros do servidor indica a causa. Um site em modo de manutenção responde da mesma forma: aguarde até voltar a estar online.

O site limita os nossos pedidos

O site ou o respetivo fornecedor de alojamento respondeu que enviámos demasiados pedidos (HTTP 429). Tente novamente daqui a alguns minutos ou peça ao seu fornecedor de alojamento que permita o nosso User-Agent. Independentemente disso, cada site aceita até 50 rascunhos do LLM Pulse em 24 horas; acima desse limite, volte a enviar no dia seguinte.

O WordPress enviou uma resposta ilegível

O site devolveu texto antes da resposta da API REST: normalmente avisos ou notificações de PHP, ou um plugin ou tema que produz um carácter a mais. Peça ao seu programador que defina WP_DEBUG_DISPLAY como false no wp-config.php e que verifique os plugins instalados ou atualizados recentemente. Se, em vez disso, o site responder com uma página web inteira, um plugin de cache ou de manutenção está a servir páginas em /wp-json/: configure-o para excluir esse caminho.

A aprovação não foi concluída

Se selecionou Não, eu não aprovo esta ligação, selecione novamente Aprovar no WordPress e aprove a ligação.
Se regressou do WordPress sem uma senha de aplicação, um plugin de segurança ou o seu fornecedor de alojamento interrompeu a página de aprovação em /wp-admin/authorize-application.php. Permita essa página ou crie manualmente uma senha de aplicação e cole-a no cartão WordPress.

O utilizador do WordPress não pode criar rascunhos

Os rascunhos exigem um utilizador que possa escrever artigos, como um Autor ou um Editor. Um Administrador também funciona. Altere a função em Utilizadores ou volte a ligar com outro utilizador.