Instalar o WooSync no WordPress

Como instalar o plugin WooSync no seu WordPress e deixar sua loja WooCommerce pronta para vender no Mercado Livre. Requisitos, download e ativação passo a passo.

Plano Free

O WooSync é um plugin de WordPress que conecta o seu WooCommerce com o Mercado Livre: sincroniza estoque, preços, anúncios, vendas e perguntas quase em tempo real. Este guia leva você do zero até ter o plugin instalado, ativado e pronto para vincular a sua conta do Mercado Livre. Com o plano Free — grátis para sempre e sem cartão — você já pode fazer tudo isso.

Antes de começar

Confira se a sua loja atende aos requisitos mínimos. Se algo ficar abaixo do recomendado, a instalação pode falhar ou o plugin pode não ativar.

• WooCommerce 10 ou superior e PHP 8.2+. Se você não sabe qual versão tem, veja em WooCommerce → Status (ou peça para a sua hospedagem).
• Uma conta do Mercado Livre como vendedor, que você vai vincular depois.
• Uma licença do WooSync. O plano Free já é suficiente: ele inclui 50 anúncios vinculados, 500 sincronizações por mês e 1 conta do Mercado Livre. Quando você crescer, passa para um plano pago sem perder a sua configuração. Veja os detalhes em Planos, preços e licenças.
• Acesso de administrador ao seu WordPress (para enviar e ativar plugins).

Como instalar o plugin

O WooSync é um plugin premium: ele não é encontrado no repositório do WordPress, você o envia como arquivo. A instalação é feita a partir do .zip que você obtém ao registrar a sua conta.

1. Obtenha o arquivo do plugin na sua conta no Hub do WooSync (app.woosync.io). Você vai baixar um arquivo .zip — não descompacte.
2. No seu WordPress, entre em Plugins → Adicionar novo → Enviar plugin.
3. Escolha o .zip do WooSync e envie.
4. Quando a instalação terminar, clique em Ativar.
5. Ao ativar, você verá o novo menu WooSync no painel do WordPress.

Como verificar se ficou tudo certo

1. Entre em WooSync → Painel. É a tela que resume o status geral da sua conta e da conexão.
2. Se você vê o Painel, a instalação está pronta. Ainda não vai haver dados do Mercado Livre porque falta vincular a sua conta (o próximo passo).
3. Dentro do plugin não é preciso ativar nenhuma licença: não existe um campo para informá-la. O WooSync a resolve sozinho a partir do seu domínio, depois que você registrou a conexão no Hub. Lembre-se de que 1 licença = 1 domínio de WordPress: ela é vinculada ao primeiro domínio que a utiliza. Você pode ver o seu plano e a sua licença, apenas para leitura, em WooSync → Painel → «Resumo da sua conta».

Próximo passo: conectar o Mercado Livre

Com o plugin instalado, você já pode vincular a sua conta. A conexão é feita por OAuth oficial: o WooSync não guarda as suas credenciais do Mercado Livre, e os tokens são administrados pelo Hub, que ainda os reconecta sozinho quando vencem. Você dá a permissão só uma vez.

Siga o guia Vincular WooCommerce com o Mercado Livre.

Problemas frequentes

• O envio do .zip falha ou é interrompido → normalmente é o limite de upload do seu WordPress (upload_max_filesize / post_max_size) menor que o arquivo, ou um download incompleto. Baixe o .zip novamente no Hub e, se continuar, peça para a sua hospedagem aumentar o limite de upload. Como alternativa, envie o plugin por FTP para a pasta wp-content/plugins do seu site.
• O menu WooSync não aparece depois de instalar → quase sempre o plugin ficou instalado, mas sem ativar. Vá em Plugins, procure o WooSync na lista e clique em Ativar. Se ao ativar aparecer um erro de requisitos, verifique se você tem WooCommerce 10+ e PHP 8.2+.
• Aviso de versão do WooCommerce ou do PHP → a sua loja está abaixo do mínimo. Atualize o WooCommerce em Plugins e peça para a sua hospedagem subir a versão do PHP para 8.2 ou superior antes de continuar.
• Diz que o domínio já está em uso → cada licença cobre um único domínio de WordPress e fica atrelada ao primeiro que a utiliza. Se o domínio ficou ocupado (por um staging, ou por outra conta da equipe), é preciso excluir essa conexão no Hub para liberá-lo — «Desvincular» não basta —, ou usar outra licença. Verifique a sua conta no Hub ou consulte Planos, preços e licenças.

Veja também

• Vincular WooCommerce com o Mercado Livre — o próximo passo: autorizar a sua conta por OAuth.
• Publicar no Mercado Livre com modelos — configure um modelo uma vez e publique todo o seu catálogo.
• Planos, preços e licenças — o que o Free inclui e como funcionam as licenças por domínio e os slots.