Vincular o WooCommerce com o Mercado Livre

Como vincular sua conta de vendedor do Mercado Livre com o WooCommerce de forma segura (OAuth) para sincronizar estoque, preços e vendas em tempo real.

Plano Free

Vincular sua conta do Mercado Livre é o segundo passo depois de instalar o WooSync. Sem esse vínculo, o plugin não consegue publicar, importar nem sincronizar nada: é a porta de entrada para todo o resto. A boa notícia é que isso se faz uma única vez, em poucos cliques, e você não precisa copiar nem colar nenhum token na mão.

Antes de começar

Tenha o WooSync instalado e ativo no seu WooCommerce. Se ainda não fez isso, siga Instalar o WooSync no WordPress.
Tenha uma conta de vendedor do Mercado Livre com a qual você já publique (ou vá publicar). Serve qualquer país onde o Mercado Livre opere.
Faça login no Mercado Livre no mesmo navegador antes de começar, com a conta que você quer conectar. Se você tem várias contas do ML, confira que está logado com a certa para não vincular a que não era.
O plano Free já permite conectar 1 conta do Mercado Livre. Para somar mais contas à mesma loja você precisa de um plano pago com slots (veja Planos, preços e licenças).

Como se conecta (de forma segura)

O WooSync não guarda suas credenciais do Mercado Livre. A autorização é feita por OAuth, o mecanismo oficial do Mercado Livre: você faz login no site do Mercado Livre e concede a permissão ao plugin, sem que seu usuário nem sua senha passem em nenhum momento pelo WooSync. Os tokens de acesso são administrados de forma segura pelo Hub do WooSync e se reconectam sozinhos quando vencem, então a conexão se mantém ativa sem que você precise renovar nada.

Como vincular sua conta do Mercado Livre

No painel do WordPress, entre em WooSync → Conexão (a tela «Conexão com o Mercado Livre»).
Clique no botão «+ Vincular usuário», no canto superior direito.
O Mercado Livre abre: faça login (se ainda não estava) e aceite as permissões que ele pede para a sua loja.
O Mercado Livre devolve você ao seu WooCommerce com a conta vinculada e verificada.

Quando termina, a tela Conexão mostra a conta ativa e o Painel reflete o estado do vínculo ao vivo.

Como conectar várias contas (slots)

Com um plano pago você pode somar slots e conectar mais de uma conta do Mercado Livre à mesma loja —útil se você gerencia várias marcas ou vários usuários do ML—. Cada conexão é adicionada e gerenciada na mesma tela Conexão, repetindo os passos acima com cada conta. Lembre-se de que cada licença cobre 1 domínio do WordPress. Para ver qual plano inclui quantos slots, veja Planos, preços e licenças.

Como verificar o status da conexão

O Painel e a tela Conexão mostram a saúde do vínculo ao vivo. Se estiver tudo em ordem, você verá a conta ativa; se algo precisar de atenção, aparece um aviso com o passo a seguir. Vale a pena revisar essa tela quando você notar que algo deixou de sincronizar, antes de mexer em qualquer outra configuração.

O que você pode fazer depois de conectar

Com a conta vinculada você já pode:

Criar um modelo para publicar seu catálogo → Publicar no Mercado Livre com modelos.
Importar suas publicações existentes do Mercado Livre para o WooCommerce → Importar seus anúncios do Mercado Livre.
Receber suas vendas, perguntas e mensagens do Mercado Livre dentro do WooCommerce (conforme seu plano).

Problemas frequentes

Vinculou a conta errada → causa: no navegador você estava logado no Mercado Livre com outra das suas contas quando aceitou as permissões. Solução: saia da sessão no Mercado Livre, entre de novo com a conta certa e repita o vínculo em Conexão.
A janela do Mercado Livre não abre ou não volta para a loja → causa: um bloqueador de pop-ups ou uma extensão do navegador cortou o redirecionamento do OAuth. Solução: permita as janelas pop-up para a sua loja, teste em uma janela anônima ou em outro navegador, e tente de novo.
A conexão aparece com aviso ou “precisa reconectar” → causa: o Mercado Livre pode invalidar a permissão se você mudou a senha da sua conta do ML ou revogou o acesso ao app no seu perfil do Mercado Livre; quando isso acontece, o token deixa de funcionar e o Hub não consegue renová-lo sozinho. Solução: em Conexão, clique em «Diagnóstico de conexão» para ver o detalhe e, se precisar, volte a Vincular usuário para autorizar novamente.
Não me deixa adicionar outra conta → causa: você está em um plano que só permite 1 conta (o caso do Free) ou já usou todos os seus slots. Solução: revise seu plano e some slots em Planos, preços e licenças.