API da Shopee: o que dá para fazer e como usar com agentes de IA
A Shopee Open Platform é a API oficial para vendedores e integradores da Shopee. Ela permite ler e atualizar pedidos, anúncios, estoque, preços e informações de envio. O acesso é feito por um app registrado na plataforma e autorizado pela loja.
Os grandes recursos da API, em português claro.
Listar pedidos por status e período, consultar detalhes do comprador e itens, e acompanhar cancelamentos e devoluções.
Criar e editar anúncios, variações, fotos e atributos de categoria.
Atualizar quantidades e preços por item ou variação, inclusive em lote.
Consultar opções de envio, gerar documentos de expedição e acompanhar o rastreio.
Ler avaliações e, conforme as permissões do app, interagir com mensagens de compradores.
Receber eventos, como mudança de status de pedido, em uma URL do integrador.
Como se acessa a API do Shopee.
- Para parceiros e clientesCada requisição é assinada com as chaves do app (partner id e chave secreta), e a loja autoriza o app por um fluxo de consentimento que gera tokens de acesso renováveis.
- Documentação oficialopen.shopee.com
- A Shopee aplica limites de chamadas por app e por loja; o agente agenda as consultas em vez de varrer tudo a cada minuto.
- Dados de comprador (nome, endereço) são pessoais: o agente só os usa para a entrega e o atendimento, conforme a LGPD.
- Os tokens expiram e precisam ser renovados; o iTeam cuida da renovação e avisa se a autorização da loja cair.
- api shopee
- shopee open platform
- api da shopee pedidos
- integração api shopee
- shopee api documentação
- api shopee estoque
- shopee api push notification
O que um agente do iTeam faz com a API do Shopee.
O agente cruza vendas do dia com o estoque da Shopee e alerta compras quando um item campeão vai zerar em poucos dias.
Todo pedido pago que não foi despachado no prazo de envio aparece numa lista para a expedição, com o motivo provável.
O agente lê avaliações de 1 e 2 estrelas, agrupa por causa (atraso, defeito, tamanho) e rascunha resposta para aprovação.
Quando o preço muda no ERP, o agente propõe a atualização dos anúncios na Shopee e aplica depois do ok do comercial.
Da credencial ao agente trabalhando, com aprovação.
Registrar o app na Open Platform
Crie a conta de desenvolvedor na Shopee Open Platform, registre o app e peça à loja que autorize o acesso pelo fluxo de consentimento.
Cadastrar a credencial no cofre do iTeam
A credencial da Shopee fica no cofre do iTeam, fora de prompts e planilhas. Cada agente recebe só as ações de que precisa (ler pedidos, atualizar estoque, responder avaliações), e o que grava dados passa por aprovação.
Testar com aprovação humana
Antes de liberar, altere o estoque de um único SKU e confira na Central do Vendedor. Nas primeiras semanas, as ações de escrita ficam com aprovação e tudo fica na auditoria.
Dúvidas sobre a API do Shopee.
A API da Shopee é gratuita?
O uso da Open Platform não tem cobrança por chamada para vendedores e integradores aprovados, mas depende da aprovação do app e das regras do programa de parceiros. Confirme as condições vigentes no portal da Shopee.
Preciso programar para usar a API da Shopee com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam aprende os endpoints da API da Shopee pela documentação, e o time de implantação configura credenciais, permissões e o processo. Sua equipe valida o resultado.
A API da Shopee permite responder o chat dos compradores?
Há recursos de mensagens na plataforma, mas a disponibilidade depende do tipo de app e das permissões concedidas. No diagnóstico o iTeam confirma o que está liberado para a sua loja.
Quais tarefas de pedidos e estoque um agente de IA executa na Shopee Open Platform?
A Open Platform da Shopee expõe pedidos, produtos, estoque, preço, logística e chat, e o agente trabalha sobre esses recursos. Ele lista pedidos novos, confere se há saldo, atualiza a quantidade e pede o código de envio. Divergências, como pedido sem estoque, viram tarefa para uma pessoa. No iTeam esse fluxo roda como processo com etapas e responsável por exceção.
Como a autenticação da API da Shopee funciona com partner id e assinatura?
Cada chamada é assinada com a chave secreta do app, calculada sobre o partner id, o caminho da API, o horário e os tokens, e vai na URL. A loja autoriza o app por um link de consentimento e o retorno traz o código para obter os tokens de acesso e de renovação. Um erro de assinatura costuma indicar relógio desajustado ou ordem errada dos campos.
A Shopee tem ambiente de teste para validar a integração antes de produção?
Sim, o console de desenvolvedor cria credenciais de teste e um host de sandbox separado do de produção. Você autoriza uma loja de teste ao app e roda as chamadas ali. Guias de integradores avisam que alguns recursos só se comportam de verdade em produção, então confira na documentação oficial o que o sandbox cobre antes de contar com ele para logística.
Qualquer pessoa pode usar a API da Shopee ou precisa de aprovação?
Há cadastro como desenvolvedor e criação de um app no portal, e a ida para produção passa pela aprovação da Shopee. Como o acesso se dá por parceiros, a empresa precisa decidir se registra o próprio app ou usa um integrador já homologado. Confira na documentação oficial os requisitos para a região Brasil e o status do app antes de prometer uma data.
Como evitar estourar o limite de chamadas da Shopee com um agente de IA?
A Shopee limita chamadas por app e por loja, então o agente deve consultar em lotes e priorizar as notificações push em vez de varrer pedidos a cada minuto. Com os avisos de mudança de pedido, ele só busca o detalhe do que mudou. Em picos de campanha, enfileirar as atualizações de preço evita erro de limite e deixa o resto do trabalho andando.
O agente pode responder o chat dos compradores da Shopee?
A API tem recurso de chat, então o agente pode ler a mensagem e responder com dados do pedido e do envio. O ideal é começar com respostas de consulta, como rastreio e prazo, e deixar reclamação e pedido de devolução para uma pessoa. Respeite as regras de comunicação da Shopee, que costumam restringir contato fora da plataforma.
O que acontece na Shopee quando o token de acesso expira?
As chamadas passam a falhar até que o token seja renovado com o refresh token, e se a autorização da loja for removida é preciso refazer o consentimento. Um agente bem montado renova antes do vencimento e dispara um aviso quando a renovação falha. Sem esse alerta, a integração fica muda por horas e a perda só aparece em pedidos parados.
Vale a pena ligar a Shopee a um agente de IA para uma loja pequena?
Vale se a loja recebe muitas perguntas repetidas ou mantém estoque em mais de um canal, porque aí o agente evita overselling e responde fora do horário. Para poucos pedidos por semana, o painel da Shopee resolve e a integração dá mais trabalho do que retorno. Comece por um fluxo só, como sincronizar estoque, e meça antes de ampliar.
