API da Tray: pedidos, produtos e clientes da loja com agentes de IA
A Tray é uma plataforma brasileira de e-commerce com API REST para integrar a loja a ERPs, marketplaces e hubs. É usada por lojistas e integradores para sincronizar pedidos, catálogo e estoque. O acesso é por aplicativo autorizado pela loja, que gera chaves de acesso.
Os grandes recursos da API, em português claro.
Listar e consultar pedidos, atualizar status e código de rastreio.
Criar e editar produtos, variações, categorias e imagens.
Atualizar estoque e preço por produto ou variação.
Consultar e atualizar cadastros de clientes.
Consultar formas de envio e gerenciar cupons.
Receber avisos de novos pedidos e mudanças por URL de notificação.
Como se acessa a API do Tray.
- Com credencial da sua empresaA loja autoriza um aplicativo cadastrado na Tray, que recebe um código para gerar access token e refresh token.
- Documentação oficialdevelopers.tray.com.br
- A Tray aplica limites de requisição por loja; o agente usa notificações em vez de consultar o tempo todo.
- Dados de clientes e endereços seguem a LGPD.
- Mudanças de preço em massa com aprovação.
- api tray
- tray api documentação
- api tray pedidos
- integração tray erp
- tray commerce api
- webhook tray
- tray api produtos
O que um agente do iTeam faz com a API do Tray.
Quando o pedido é despachado, o agente grava o rastreio na Tray e avisa o cliente no WhatsApp.
Pedidos aguardando pagamento recebem lembrete do agente com o link de pagamento.
O agente revisa produtos sem foto, sem peso ou com descrição curta e propõe correções.
Divergências entre o ERP e a Tray viram alerta com a lista dos SKUs afetados.
Da credencial ao agente trabalhando, com aprovação.
Autorizar o aplicativo na loja
Cadastre o aplicativo de integração na Tray e autorize na loja para gerar as chaves de acesso.
Cadastrar a credencial no cofre do iTeam
A credencial da Tray fica no cofre do iTeam, fora de prompts e planilhas. Cada agente recebe só as ações de que precisa (ler pedidos, atualizar rastreio, ajustar estoque), e o que grava dados passa por aprovação.
Testar com aprovação humana
Antes de liberar, atualize o rastreio de um pedido de teste. Nas primeiras semanas, as ações de escrita ficam com aprovação e tudo fica na auditoria.
Dúvidas sobre a API do Tray.
A API da Tray é gratuita?
O uso da API está incluído para lojas da Tray, dentro dos limites da plataforma; aplicativos de terceiros podem ter custo próprio.
Preciso programar para usar a API da Tray com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam aprende os endpoints da API da Tray pela documentação, e o time de implantação configura credenciais, permissões e o processo. Sua equipe valida o resultado.
A API da Tray serve para integrar com marketplace?
Sim, é a base dos hubs e ERPs que conectam a Tray a marketplaces. O agente do iTeam usa a mesma API para acompanhar a operação.
Quão simples é integrar a loja Tray com um agente de IA?
É simples quando a loja autoriza um aplicativo cadastrado na Tray, que gera access token e refresh token. O agente passa a consultar pedidos, produtos, estoque e clientes. O esforço está em definir regras de preço e estoque que ele pode alterar sem aprovação.
O que influencia o custo de usar a API da Tray com agentes de IA?
Confira no seu plano da Tray o que a API inclui, pois não temos valores. O gasto de IA depende do volume de pedidos e atendimentos. No iTeam há teto por agente. Usar notificações em vez de consultas constantes reduz o consumo de requisições.
A Tray tem ambiente de testes para validar a integração?
Confira na documentação oficial se há loja de testes ou ambiente de homologação. Se não houver, teste com uma loja de desenvolvimento e produtos fictícios. O agente só deve alterar preço e estoque em loja real depois de validado e com aprovação.
Como a Tray limita requisições e como evitar problemas?
A Tray aplica limites por loja, então o agente deve usar notificações em vez de consultar o tempo todo. Agrupe consultas, reaproveite tokens até expirarem e renove-os pelo refresh token para evitar falhas de autenticação.
Onde fica a documentação da Tray e como ela se compara à do WooCommerce ou da Loja Integrada?
A documentação oficial fica em developers.tray.com.br. WooCommerce usa chaves da própria loja, e a Loja Integrada usa chaves da loja e de aplicação. A comparação depende de autenticação, webhooks e cobertura de pedidos e estoque; teste cada uma com um caso real.
Dados de clientes da Tray ficam seguros com um agente de IA?
Ficam, se o acesso for restrito ao necessário e as credenciais ficarem no cofre. Dados de clientes e endereços seguem a LGPD. No iTeam, as permissões são por papel e pessoa, e a trilha registra o que o agente consultou e alterou.
O que um agente de IA pode fazer na Tray?
Ele consulta pedidos e status, atualiza estoque e preços, lê produtos e variações, aplica cupons e responde clientes sobre entrega. Exemplo: responder no WhatsApp onde está o pedido. Mudanças de preço em massa precisam de aprovação, porque afetam a venda na hora.
A API da Tray ajuda a integrar o ERP e os marketplaces com um agente de IA?
Sim, ela serve para sincronizar pedidos, catálogo e estoque com ERPs, marketplaces e hubs. O agente confere divergências e avisa o time. O iTeam integra ERP e planilhas, e o diagnóstico da primeira semana mapeia quais sistemas trocam dados e onde estão os gargalos.
