n8n + Mercado Livre: como automatizar pedidos do maior marketplace do Brasil

1. 1. Crie uma aplicação no DevCenter do Mercado Livre

   Acesse developers.mercadolivre.com.br/devcenter com a conta do vendedor e clique em "Criar nova aplicação". Preencha nome, descrição e a URL de redirecionamento (pode ser a URL do seu n8n). Na seção de tópicos de notificação, marque orders_v2 — é ele que dispara um aviso a cada venda criada ou alterada. Ao salvar, guarde o App ID e a Secret Key: são as credenciais de tudo que vem a seguir.

2. 2. Autentique via OAuth2 e pegue o primeiro token

   O fluxo é o OAuth2 padrão: você abre a URL de autorização com seu App ID, o Mercado Livre pede permissão ao vendedor e devolve um code na URL de redirecionamento. Troque esse code por um access token com um POST em https://api.mercadolibre.com/oauth/token. A resposta traz o access_token, o expires_in de 21600 segundos e um refresh_token. Anote os dois tokens — o refresh é a chave da renovação.

3. 3. Monte o workflow de renovação automática do token

   Aqui mora a pegadinha da integração. O access token vale só 6 horas, e o refresh token é de uso único: cada renovação devolve um refresh novo, que substitui o anterior. Crie um workflow no n8n com Schedule Trigger a cada 5 horas fazendo POST em /oauth/token com grant_type=refresh_token, e salve o par novo de tokens (num Data Table do n8n, num Google Sheets ou em variável). Se perder um refresh token, o vendedor precisa autorizar tudo de novo manualmente — automatize isso antes de qualquer outra coisa.

4. 4. Configure o Webhook node para receber as vendas

   No workflow principal, comece com um Webhook node em método POST e copie a URL de produção. Cole essa URL no campo "URL de retornos de chamada" da sua aplicação no DevCenter. Pronto: a cada pedido criado ou atualizado, o Mercado Livre faz um POST na sua URL com um JSON enxuto — tópico, user_id e o campo resource, algo como /orders/2000012345678. Importante: responda rápido com status 200, senão a plataforma reenvia a notificação e você processa a mesma venda duas vezes.

5. 5. Busque os detalhes do pedido com HTTP Request

   A notificação não traz o pedido completo, só o caminho do recurso. Adicione um node HTTP Request fazendo GET em https://api.mercadolibre.com{{resource}} com o header Authorization: Bearer seu-access-token (lido de onde o workflow do passo 3 salvou). A resposta traz tudo: itens vendidos, valor, status do pagamento, dados do comprador e do envio. Um node IF na sequência filtra o que interessa — por exemplo, só pedidos com pagamento aprovado.

6. 6. Encaminhe o pedido para onde sua operação vive

   Com o JSON do pedido no fluxo, o resto é o de sempre no n8n: um node de WhatsApp avisa o time ou o cliente, um Google Sheets lança a venda na planilha de controle, um HTTP Request empurra para o ERP ou sistema de emissão de nota. Teste com um pedido real de valor baixo antes de ativar de vez — o sandbox do Mercado Livre é limitado, e na prática quase todo mundo valida em produção mesmo.

Por que não existe um node de Mercado Livre no n8n?

O n8n passa de mil integrações nativas, mas quase todas apontam para ferramentas globais — Shopify tem node oficial, Mercado Livre não. Para o vendedor brasileiro, isso soa estranho: estamos falando do maior marketplace do país, com mais de 100 milhões de visitas mensais e cerca de 5,8 milhões de PMEs e empreendedores vendendo por lá, segundo dados da própria empresa.

A boa notícia é que a ausência do node pesa menos do que parece. A API do Mercado Livre é aberta, bem documentada e estável — e o combo Webhook + HTTP Request do n8n cobre tudo o que um node faria. A diferença real está em dois pontos que o node resolveria sozinho: a autenticação OAuth2 e a renovação do token. É exatamente por isso que este guia dedica um passo inteiro só ao token.

Se você ainda está começando no n8n, vale ler antes o nosso guia de o que é n8n para iniciantes e entender como funciona um webhook — os dois conceitos aparecem o tempo todo aqui.

O token de 6 horas: o detalhe que derruba a maioria das integrações

Todo mundo que integra o Mercado Livre pela primeira vez tropeça no mesmo lugar. A integração funciona lindamente na tarde da configuração e amanhece morta. Motivo: o access token expira em 21.600 segundos — 6 horas — e a documentação oficial deixa claro que o refresh token é de uso único, trocado a cada renovação.

Na prática, isso significa que a renovação não é um detalhe, é um subsistema. O workflow do passo 3 roda sozinho a cada 5 horas, sempre antes de o token vencer, e guarda o par novo. Quem hospeda o n8n em servidor próprio tem uma vantagem aqui: o workflow de renovação roda sem consumir limite de execução de plano — o custo fixo é só a VPS, como mostramos no guia de instalação do n8n self-hosted em VPS.

O que dá para automatizar depois que os pedidos chegam no n8n

Receber o pedido é o começo. O valor aparece no que você constrói em cima:

• Aviso instantâneo de venda no WhatsApp do dono ou do grupo da equipe — o mesmo padrão que usamos na automação de pedidos do WooCommerce com WhatsApp
• Lançamento automático de cada venda numa planilha de controle financeiro ou dashboard
• Integração com ERP ou emissor de nota fiscal via API, sem redigitar pedido
• Mensagem pós-venda ao comprador com prazo de envio e código de rastreio
• Alerta de estoque baixo cruzando as vendas do Mercado Livre com o estoque das outras lojas
• Consolidação multicanal: Mercado Livre + Shopify + WooCommerce caindo no mesmo fluxo de tratamento

Quanto custa manter essa integração no ar

A API do Mercado Livre é gratuita para o vendedor — não há cobrança por chamada nos volumes de uma operação PME. O custo real fica no n8n: no plano cloud, cada pedido processado consome execuções da franquia mensal; no self-hosted, o gasto é o servidor, e uma VPS de entrada dá conta de milhares de pedidos por mês com folga.

Para quem vende volume alto, essa conta tende a favorecer o self-hosted rápido. E há um argumento extra para 2026: o Mercado Livre anunciou R$ 57 bilhões de investimento no Brasil neste ano, o nono aumento consecutivo — o marketplace vai continuar crescendo, e quem automatiza a operação cedo escala junto sem contratar mais gente para digitar pedido.

Perguntas frequentes

Leia também

Guia

n8n integração com Shopify: automatize pedidos e estoque passo a passo

Como integrar n8n com Shopify para automatizar notificações de pedidos, atualização de estoque, e-mail pós-compra e sincronização com CRM. Guia completo.

Ler →

Guia

Como automatizar pedidos do WooCommerce com notificação no WhatsApp (n8n, passo a passo)

Conecte o WooCommerce ao WhatsApp com n8n: webhook de pedido criado, mensagem automática para o cliente e alerta para a equipe. Passo a passo com custos e cuidados.

Ler →

Guia

Como criar alerta automático de estoque baixo no WooCommerce com n8n

Monte um alerta automático de estoque baixo no WooCommerce usando n8n: Schedule Trigger, filtro por stock_quantity e aviso no WhatsApp, Slack ou e-mail. Passo a passo com limites do aviso nativo do WooCommerce.

Ler →

Glossário

Webhook

Entenda o que é webhook, como funciona na prática e como usar no n8n e Make para criar automações em tempo real sem precisar saber programar.

Ler →

Guia

Como instalar n8n em VPS no Brasil (guia completo com custos reais)

Guia passo a passo para instalar n8n self-hosted em VPS no Brasil. Inclui custos reais em reais, comparativo de providers, configuração com Docker e HTTPS.

Ler →

Guia

O que é n8n? Guia completo para iniciantes em 2026

Entenda o que é n8n, como a ferramenta de automação funciona, quanto custa, se é difícil de aprender e como criar seu primeiro workflow sem saber programar.

Ler →