API do Mercado Livre: o que dá para fazer e como usar com agentes de IA
A API do Mercado Livre dá acesso programático à conta do vendedor: anúncios, pedidos, perguntas de compradores, envios e mensagens pós-venda. É usada por lojistas, integradores e ERPs que operam volume no marketplace. O acesso é feito com um aplicativo registrado no portal de desenvolvedores e autorizado pela conta do vendedor.
Os grandes recursos da API, em português claro.
Criar, editar, pausar e consultar anúncios, com preço, estoque, atributos e categorias.
Listar e detalhar vendas, com itens, comprador, pagamento e status de cada pedido.
Ler as perguntas feitas nos anúncios e publicar respostas em nome do vendedor.
Consultar dados de envio do Mercado Envios, rastreio e etiquetas dos pedidos.
Trocar mensagens com o comprador dentro de um pedido.
Receber avisos em uma URL de retorno quando surgem pedidos, perguntas ou mudanças em itens.
Como se acessa a API do Mercado Livre.
- Com credencial da sua empresaOAuth 2.0: você cria um aplicativo no portal de desenvolvedores, o vendedor autoriza o acesso e a integração recebe um token de acesso com renovação periódica.
- Documentação oficialdevelopers.mercadolivre.com.br
- Respeite os limites de requisição e use notificações em vez de consultar pedidos o tempo todo.
- Dados de comprador são dados pessoais: guarde só o necessário e siga a LGPD e as regras do marketplace.
- Alterações de preço e estoque afetam vendas na hora; deixe essas ações com aprovação.
- api mercado livre
- api do mercado livre pedidos
- integração api mercado livre
- mercado livre api documentação
- webhook mercado livre
- api mercado livre perguntas
- mercado livre developers
O que um agente do iTeam faz com a API do Mercado Livre.
O agente lê a pergunta, consulta ficha técnica e estoque e propõe a resposta; perguntas sobre prazo ou garantia passam por aprovação antes de publicar.
Todo dia o agente cruza os pedidos do marketplace com notas emitidas e recebimentos, e avisa no Teams o que ficou sem nota ou sem baixa.
O agente encontra anúncios pausados, sem estoque ou com preço fora da política e abre uma tarefa para o time comercial.
Ao ver um envio parado, o agente manda mensagem ao comprador com o rastreio e registra o caso para o atendimento acompanhar.
Da credencial ao agente trabalhando, com aprovação.
Criar o aplicativo no Mercado Livre
No portal de desenvolvedores, registre um app com a URL de retorno indicada pelo iTeam e escolha só as permissões que o agente vai usar.
Autorizar e guardar o token no cofre
A conta vendedora autoriza o app; o token fica no cofre do iTeam e cada agente recebe só as ações permitidas, como ler pedidos ou responder perguntas.
Testar com aprovação humana
Os primeiros dias rodam com aprovação em toda resposta e alteração de anúncio, com teto de custo e trilha de auditoria por ação.
Dúvidas sobre a API do Mercado Livre.
A API do Mercado Livre é gratuita?
De forma geral, usar a API não tem cobrança separada para o vendedor; você paga as tarifas normais de venda do Mercado Livre. Vale conferir as condições atuais no portal de desenvolvedores.
Preciso programar para usar a API do Mercado Livre com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da API e aprende os endpoints, e o time de implantação configura credenciais, permissões e testes com você.
Dá para receber pedidos em tempo real pela API do Mercado Livre?
Sim. A API envia notificações para uma URL cadastrada no aplicativo quando há pedidos, perguntas ou mudanças, e o agente consulta o detalhe em seguida.
Como um agente de IA responde perguntas de compradores no Mercado Livre usando a API?
O agente lê as perguntas pelo recurso de perguntas e respostas da API do Mercado Livre e publica a resposta no anúncio. Ele identifica o item, consulta ficha, estoque e prazo e redige o texto. Você escolhe se a resposta sai direto ou espera revisão. No iTeam, o agente de pós-venda pode ter o cargo de atendente do marketplace, com a revisão de alguém do time nas respostas sobre garantia.
A API do Mercado Livre tem sandbox para testar a integração com um agente?
Não: segundo a documentação oficial, o Mercado Livre não oferece sandbox e disponibiliza usuários de teste que operam direto em produção. Você cria esses usuários com o seu token e eles só compram, vendem e perguntam em anúncios de teste. Há um teto de usuários de teste por conta e eles expiram, então anote as credenciais na criação, porque não existe tela para consultá-las depois.
Como autorizar um agente de IA a acessar a conta de vendedor do Mercado Livre?
A autorização é OAuth 2.0: você registra um aplicativo no portal de desenvolvedores e o vendedor concede acesso pela tela de consentimento. O retorno traz um token de acesso de validade curta e um refresh token, que o agente usa para renovar sozinho. Revogar o acesso do aplicativo na conta do vendedor derruba a integração, então vale monitorar erros de autenticação.
Qual a diferença entre consultar pedidos o tempo todo e usar notificações na API do Mercado Livre?
As notificações avisam o seu endereço quando um pedido, anúncio ou pergunta muda, enquanto a consulta repetida gasta chamadas e esbarra nos limites. O Mercado Livre envia apenas o aviso com o recurso afetado; o agente então busca o detalhe daquele pedido. Esse desenho reduz volume, deixa a reação mais rápida e evita varrer a lista de pedidos inteira a cada ciclo.
O agente pode alterar preço e estoque de anúncios no Mercado Livre sozinho?
Tecnicamente pode, já que a API permite editar preço e quantidade do item, mas a mudança vale na hora para o comprador. Por isso a prática segura é deixar o agente propor o ajuste e liberar só dentro de uma faixa que você definiu, como variação máxima por dia. Fora da faixa, a alteração espera aprovação de quem responde pelo canal, com o registro do antes e do depois.
Preciso de desenvolvedor para conectar o Mercado Livre a um agente de IA?
Para criar o aplicativo e configurar o redirecionamento do OAuth, ajuda ter alguém técnico na primeira vez, mas depois o dia a dia é operacional. O registro do aplicativo no portal de desenvolvedores resulta em um par de credenciais do aplicativo. O que mais consome tempo costuma ser decidir as regras de resposta e de preço, não o código de conexão.
Quando não vale a pena usar a API do Mercado Livre com agente de IA?
Não vale para quem vende poucos itens por mês e responde tudo sem fila, porque a rotina manual no painel já dá conta. O ganho aparece quando há muitas perguntas repetidas, catálogo grande ou várias contas. Também não compensa se o seu ERP já sincroniza anúncios e pedidos e o gargalo está em outro ponto, como logística ou compras.
Os dados de comprador vindos da API do Mercado Livre podem ser guardados pelo agente?
Podem ser lidos para atender e entregar, mas nome, endereço e telefone são dados pessoais e pedem finalidade e retenção definidas. O agente deve guardar só o necessário para o pedido em andamento, sem copiar a base de compradores para outro lugar. A LGPD e as regras do próprio marketplace valem juntas; peça ao jurídico a política de retenção antes de ligar o agente.
