As mudanças do Mercado Livre não aparecem na minha loja

Por que as mudanças do Mercado Livre podem não aparecer no WooCommerce: webhooks vs. trabalhos agendados, a fila do Action Scheduler travada e como destravá-la com um cron externo.

Você editou algo no Mercado Livre e na sua loja continua antigo. Antes de mexer em qualquer coisa, vale entender que o WooSync traz as mudanças do Mercado Livre por dois caminhos diferentes —e cada um se diagnostica de um jeito.

O primeiro que você precisa entenderO Sincronizador traz o essencial —estoque, preço e status— na hora e por webhooks: o Mercado Livre avisa o nosso servidor assim que há uma mudança, e não depende de nenhuma tarefa agendada do seu WordPress. Já título, descrição, fotos e atributos não vêm por aí: só chegam com uma importação (em massa), que aí sim depende do cron do seu site.

Passo 1 — Qual campo não atualiza?

Se for estoque, preço ou status → deveriam chegar na hora pelo Sincronizador (webhooks). Se não chegam, verifique:

Que em Configuração → Sincronizador esteja ativada a regra Mercado Livre → WooCommerce do campo que te interessa, e salva. Veja O Sincronizador.
Que a conta esteja vinculada e com token verificado em Conexão. Veja Vincular o WooCommerce com o Mercado Livre.

Os webhooks não dependem do WP-Cron do seu site, então esse caminho funciona mesmo que as suas tarefas agendadas estejam paradas.

Se for título, descrição, imagens ou atributos → isso o Sincronizador não traz em tempo real. É informação secundária que só se atualiza quando roda uma importação (manual pelo Importador, ou o trabalho Automático agendado). Que você edite um título no Mercado Livre e ele não mude no WooCommerce é esperado até que rode ou agende uma importação. Veja Quando roda uma importação ou exportação?.

Passo 2 — Se é uma importação/exportação que não roda

Os trabalhos em massa (Importador, Exportador e o Automático agendado) dependem sim das tarefas agendadas do WordPress (WP-Cron / Action Scheduler). Se essas tarefas não são executadas, os trabalhos se acumulam e nada atualiza.

Como diagnosticar: no WordPress, entre em Ferramentas → Agendador de ações (Action Scheduler). Se você vê muitas ações vencidas («past-due») acumuladas na fila —incluindo tarefas do próprio WooSync como woosync_verify_connections_as (a cada ~20 min) ou woosync_refresh_token_seller— é o sinal: o seu WP-Cron não está rodando.

Por que acontece: a maioria das hospedagens compartilhadas desliga ou limita o WP-Cron para economizar recursos. É uma configuração da sua loja/hospedagem, não do WooSync.

A solução: um cron externo

SoluçãoO WooSync inclui um cron externo que dispara os trabalhos de fora do seu site, sem depender do WP-Cron da sua hospedagem.

Em WooSync → Trabalhos (abas Importador / Exportador), procure o banner «O seu servidor corta os processos?». Ali estão as URLs assinadas para configurar um cron externo que rode a cada 1 minuto e vá empurrando a fila. Com isso, a importação, a exportação e o trabalho Automático voltam a rodar de forma confiável, mesmo que a sua hospedagem desligue o WP-Cron. Veja Trabalhos.

Como montar

Copie a URL assinada que esse banner te dá e faça algo executá-la a cada 1 minuto. Você tem dois caminhos:

Com um serviço gratuito (o mais fácil). Existem serviços de cron online gratuitos —por exemplo cron-job.org—: você cria uma conta, adiciona um trabalho apontando para essa URL assinada e o coloca para rodar a cada 1 minuto. Você não mexe no seu servidor.
Com um cron na sua hospedagem (cPanel). Se o seu painel é cPanel, entre em Cron Jobs (Tarefas Cron) e crie um novo com frequência a cada minuto —em formato cron, * * * * *— e este comando: wget -q -O /dev/null "https://SUA-URL-ASSINADA" (ou, com curl, curl -s "https://SUA-URL-ASSINADA" >/dev/null 2>&1).

Os passos exatos e o nome do painel mudam conforme o provedor de hospedagem. Se algo não ficar claro, peça ao seu provedor de hospedagem para configurar um cron que execute essa URL a cada minuto: é um pedido padrão e resolvem rápido.

Se você preferir não usar o cron externo, a outra opção é auditar o seu WordPress com o seu provedor de hospedagem para ver o que está matando os processos agendados e reativá-los.

Você não precisa importar o tempo todo

Um mal-entendido comum: achar que é preciso rodar o Importador continuamente para manter tudo em dia. Não é assim. O urgente (estoque, preço, status) já chega sozinho e na hora pelo Sincronizador. As importações e exportações são processos pesados, pensados para a carga inicial, para mudanças grandes ou para rodar agendados e espaçados (uma vez por dia, ou a cada vários dias) sobre o que não é urgente. Rodá-las de forma agressiva não ajuda e pode saturar o seu servidor. Veja Quando roda uma importação ou exportação?.

Veja também

O Sincronizador — a sincronização instantânea de estoque, preço e status.
Trabalhos — onde fica o cron externo e como rodam os trabalhos em massa.
Quando roda uma importação ou exportação? — quando vale a pena rodar cada coisa.
Vincular o WooCommerce com o Mercado Livre — verifique o status da conexão.