Nó Mercado Livre

O nó de workflow Mercado Livre é um cliente REST para a Mercado Libre / Mercado Livre API. Use-o para consultar pedidos, anúncios (listings) e perguntas de compradores, além de dados de perfil do vendedor.

Node ID no editor: mercadolivre_request
URL padrão: GET https://api.mercadolibre.com/orders/search?seller={{mercadolivre_seller_id}}

O que faz

• Envia requisições HTTP autenticadas para a Mercado Libre API
• Suporta GET, POST, PUT e DELETE
• Retorna HTTP status, data da resposta e headers da resposta
• Auth padrão: Authorization: Bearer {{mercadolivre_access_token}}

Pré-requisitos

1. Conta de vendedor Mercado Livre
2. OAuth access token do app de desenvolvedor Mercado Libre
3. Seller ID (mercadolivre_seller_id) — user ID numérico
4. Integration keys em Configurações → API Keys:
   • mercadolivre_access_token
   • mercadolivre_seller_id

Como configurar

Passo 1 — Criar app de desenvolvedor e obter tokens

Registre um aplicativo em Mercado Libre developers. Complete a autorização OAuth para obter access token. Tokens expiram — implemente refresh ou reautorize periodicamente.

Use GET /users/me (template integrado) para descobrir seu seller ID.

Passo 2 — Definir credenciais

Adicione mercadolivre_access_token e mercadolivre_seller_id como integration keys.

Passo 3 — Configurar o nó

Templates de operação integrados

Exemplo — responder pergunta de comprador (POST):

• URL: https://api.mercadolibre.com/answers
• Method: POST
• Body:

{
  "question_id": {{trigger.body.question_id}},
  "text": "{{variables.answer_text}}"
}

Passo 4 — Usar dados da resposta

Order status: {{mercadolivre_1.data.status}}
Buyer nickname: {{mercadolivre_1.data.buyer.nickname}}
Listing title: {{mercadolivre_1.data.title}}

Saídas do nó

Dicas e boas práticas

• Tokens Mercado Libre expiram — monitore respostas 401 e renove tokens via OAuth
• Order search exige query param seller — use integration key mercadolivre_seller_id
• Configure notificações Mercado Libre para eventos de pedido e pergunta
• Listing IDs (MLB...) diferem de order IDs — use o template correto
• Rate limits se aplicam — evite loops apertados sem nós Delay

Exemplos de uso

WhatsApp de novo pedido para operações

1. Webhook — notificação Mercado Libre orders_v2
2. Mercado Livre GET — pedido por ID
3. Send WhatsApp — alerta interno com comprador e detalhes do item

Resposta automática a perguntas FAQ

1. Webhook — notificação de nova pergunta
2. Mercado Livre GET — detalhes da pergunta
3. AI Agent — gerar resposta a partir dos dados do produto
4. Mercado Livre POST — enviar resposta

FAQ

Por que 401 Unauthorized?
Access token expirado. Reexecute autorização OAuth e atualize mercadolivre_access_token.

Como encontro meu seller ID?
Execute o template Get current user (/users/me) — o campo id é seu seller ID.

Posso criar anúncios via este nó?
Sim — POST em /items conforme documentação Mercado Libre API (não incluído nos templates integrados; configure manualmente).

Por que a busca de pedidos está vazia?
Verifique se mercadolivre_seller_id corresponde ao usuário autorizado do token. Confira filtros de data no endpoint de search.

Referência da API

Relacionado

• Visão geral de E-commerce
• Webhook trigger
• Nós de IA