API da Nuvemshop: o que dá para fazer e como usar com agentes de IA
A API da Nuvemshop permite ler e atualizar produtos, variações, estoque, pedidos, clientes e cupons da loja, além de receber eventos por webhook. É usada por lojistas, agências e desenvolvedores de apps para a plataforma. O acesso acontece por um app autorizado pelo dono da loja.
Os grandes recursos da API, em português claro.
Cadastro, edição de preço, descrição, imagens e variações de produto.
Atualização das quantidades disponíveis por variação.
Consulta e atualização de pedidos, pagamento e status de envio.
Leitura dos dados de clientes cadastrados na loja.
Criação e gestão de cupons de desconto.
Avisos de novo pedido, pagamento, alteração de produto e outros eventos.
Como se acessa a API do Nuvemshop.
- Com credencial da sua empresaUsa OAuth 2.0: o app é criado no portal de parceiros da Nuvemshop e o lojista o autoriza, gerando o token de acesso daquela loja.
- Documentação oficialtiendanube.github.io/api-documentation
- Há limite de requisições por loja; evite varreduras completas frequentes.
- Peça só os escopos que o processo usa.
- Dados de clientes estão sob a LGPD.
- api nuvemshop
- nuvemshop api
- api da nuvemshop pedidos
- nuvemshop api documentação
- webhook nuvemshop
- integração api nuvemshop
- tiendanube api
O que um agente do iTeam faz com a API do Nuvemshop.
O agente de atendimento consulta o pedido pelo número e responde ao cliente com pagamento, envio e rastreio.
O agente reescreve descrições fracas a partir da ficha técnica e sobe para a loja depois da aprovação do responsável.
Quando uma variação campeã de vendas chega ao mínimo, o agente avisa compras com o histórico de giro.
O agente cria um cupom de uso único para um cliente que reclamou de atraso, dentro do limite de desconto aprovado.
Da credencial ao agente trabalhando, com aprovação.
Criar o app no portal de parceiros
Crie um app na Nuvemshop com os escopos necessários (produtos, pedidos, clientes) e instale na loja da empresa.
Guardar o token no cofre
O token gerado na instalação fica no cofre do iTeam, e cada agente recebe só as ações que precisa.
Testar com aprovação
Mantenha alterações de preço, produto e cupom sob aprovação nas primeiras semanas.
Dúvidas sobre a API do Nuvemshop.
A API da Nuvemshop é gratuita?
De forma geral, a API faz parte da plataforma e não tem cobrança separada; o que pode haver é custo de apps de terceiros ou do plano da loja.
Preciso programar para usar a API da Nuvemshop com o iTeam?
Não necessariamente. O time de implantação do iTeam cria o app, configura as ações a partir da documentação e você só aprova o que o agente faz.
A API da Nuvemshop serve para a Tiendanube?
Sim. Nuvemshop e Tiendanube são a mesma plataforma e compartilham a mesma API.
O que um agente de IA faz numa loja Nuvemshop pela API?
A API lê e atualiza produtos, variações, estoque, pedidos, clientes e cupons, além de enviar eventos por webhook. O agente responde onde está o pedido, atualiza estoque, cria cupom de recompra e avisa sobre carrinho parado. Alterações de preço pedem aprovação. No iTeam, o atendimento da loja também roda pelo WhatsApp.
Como funciona o limite de requisições da API da Nuvemshop?
Funciona como um balde: por padrão cabem quarenta requisições e o balde esvazia duas por segundo, separadamente para cada par de app e loja. Quando enche, a API devolve erro 429. O agente deve ler os cabeçalhos de limite e desacelerar. Planos mais altos da loja podem ter limite multiplicado; confira na documentação.
A Nuvemshop tem ambiente de testes para a API?
O portal de parceiros permite criar apps e, segundo a documentação, usar lojas de teste para validar a integração; confira o passo a passo atual no portal. Sem sandbox dedicado a dados, use uma loja de demonstração com produtos fictícios. Só depois peça a autorização do lojista real, para o agente não tocar estoque de verdade durante o ensaio.
Como o lojista autoriza um app da Nuvemshop a acessar a loja?
O app é criado no portal de parceiros e, ao instalá-lo, o lojista concede as permissões pelo fluxo OAuth 2.0, o que gera o token de acesso daquela loja. O token vale para o par app e loja. Peça só os escopos que o processo usa, como ler pedidos, porque o lojista vê a lista antes de aceitar.
Como o agente acompanha pedidos novos na Nuvemshop sem varrer a loja?
Pelos webhooks: você assina eventos, como pedido criado ou pago, e a Nuvemshop avisa o seu endereço. O agente busca o detalhe só do pedido avisado. Isso evita varreduras completas, que consomem o balde de requisições. Valide a origem do aviso e trate repetições para não notificar o cliente duas vezes.
O agente pode alterar estoque de variações na Nuvemshop sozinho?
Pode: a API atualiza o estoque por variação. O risco é sobrescrever o saldo que o ERP ou outro canal controla. Defina qual sistema é a fonte do estoque e deixe o agente apenas refletir esse valor, com limites para alterações grandes. Registre o saldo anterior em cada atualização para poder reverter.
Dados de clientes da Nuvemshop precisam seguir a LGPD?
Sim: nome, endereço, telefone e histórico de pedidos são pessoais. O agente deve acessar o necessário para atender o cliente que escreveu, e não a base inteira. Defina por quanto tempo guardar as conversas e quem lê o histórico. A Nuvemshop também publica regras para apps sobre dados de lojistas, que valem para a sua integração.
A API da Nuvemshop é paga e há exigências para desenvolvedores?
A documentação encontrada não indica cobrança pelo uso da API, mas exige cadastro como parceiro para criar apps no portal. O custo do projeto está no desenvolvimento e no modelo de IA. Confira no portal de parceiros as condições atuais e se há revisão do app para listá-lo na loja de aplicativos.
