API do Melhor Envio: o que dá para fazer e como usar com agentes de IA
A API do Melhor Envio permite cotar frete entre várias transportadoras, comprar e gerar etiquetas e acompanhar envios. É usada por lojas virtuais e plataformas de e-commerce que querem automatizar a expedição. O acesso é por aplicativo com OAuth 2.0, e existe ambiente sandbox para testes.
Os grandes recursos da API, em português claro.
Preço e prazo de várias transportadoras para um CEP, peso e dimensões.
Inclusão dos envios que serão comprados, com remetente, destinatário e volumes.
Pagamento dos fretes com o saldo da conta e geração e impressão de etiquetas.
Situação e eventos de cada envio.
Pontos de postagem e serviços disponíveis.
Avisos de mudança de situação dos envios.
Como se acessa a API do Melhor Envio.
- Com credencial da sua empresaOAuth 2.0 com aplicativo cadastrado no Melhor Envio; a conta da loja autoriza os escopos e o token é renovado periodicamente.
- Documentação oficialdocs.melhorenvio.com.br
- Comprar frete consome saldo real: mantenha aprovação ou teto de valor por lote.
- Use o sandbox para testar antes de autorizar a conta de produção.
- Endereços de clientes são dados pessoais; restrinja a quem precisa (LGPD).
- api melhor envio
- melhor envio api cotação
- melhor envio api etiqueta
- melhor envio sandbox
- integração api melhor envio
- melhor envio api documentação
- melhor envio webhook
O que um agente do iTeam faz com a API do Melhor Envio.
Os pedidos pagos entram no carrinho do Melhor Envio com o serviço escolhido pelo agente. O responsável aprova o lote e as etiquetas saem prontas.
Para um volume grande ou um CEP remoto, o agente cota as transportadoras e devolve ao vendedor as opções com prazo e preço.
O agente acompanha o saldo usado para pagar fretes e avisa o financeiro antes de travar a expedição.
O agente busca o rastreio do envio e responde no WhatsApp com o último evento e a previsão.
Da credencial ao agente trabalhando, com aprovação.
Crie o aplicativo e teste no sandbox
Cadastre o app no Melhor Envio, valide os fluxos no ambiente de testes e depois autorize na conta de produção.
Cadastre a autorização no cofre do iTeam
O agente de atendimento só consulta rastreio; o de expedição cota e monta o carrinho.
Compra com aprovação
Pagamento de fretes e geração de etiquetas passam por aprovação humana no início.
Dúvidas sobre a API do Melhor Envio.
A API do Melhor Envio é gratuita?
De forma geral, sim: a integração não tem custo próprio, e você paga os fretes comprados com o saldo da conta.
Preciso programar para usar a API do Melhor Envio com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação e o time de implantação configura os fluxos.
Existe ambiente de teste?
Sim, o Melhor Envio oferece sandbox para testar cotações e etiquetas sem custo real.
Como um agente de IA cota e compra frete usando a API do Melhor Envio?
A API calcula cotações entre várias transportadoras, coloca o envio no carrinho, compra a etiqueta e permite imprimi-la e rastrear. O agente escolhe a opção pelo critério definido, como menor preço dentro do prazo, e gera a etiqueta do pedido. Comprar consome saldo real, por isso há teto por lote. No iTeam, o rastreio vai ao cliente pelo WhatsApp.
O Melhor Envio tem sandbox para testar frete sem gastar saldo?
Sim: segundo guias de integração, há um ambiente sandbox em endereço separado do de produção, com aplicativo e conta próprios para testar cotação e geração de etiqueta. Confira na documentação do Melhor Envio como cadastrar o aplicativo no sandbox. Use-o para validar o fluxo inteiro antes de autorizar a conta real da loja.
Como funciona o OAuth 2.0 do Melhor Envio para a conta da loja?
Você cadastra um aplicativo no Melhor Envio, e a conta da loja autoriza os escopos por um link de consentimento, o que devolve um código trocado por token de acesso e de renovação. Os escopos definem o que o agente pode fazer, como calcular fretes ou comprar etiquetas. Peça só o necessário e renove o token antes da expiração.
O agente pode comprar etiquetas do Melhor Envio sozinho?
Pode, porque a API compra a etiqueta com o saldo da conta, mas isso é gasto real. Defina um teto por lote e por dia e uma lista de transportadoras permitidas, e peça aprovação acima do teto. O agente deve checar endereço e peso antes de comprar, porque etiqueta errada gera custo e reenvio. Registre a compra de cada pedido.
Como o agente acompanha o rastreio de envios do Melhor Envio?
Pela consulta de rastreio e pelos webhooks de atualização de status, quando disponíveis para o seu aplicativo. O agente avisa o cliente quando o objeto é postado, sai para entrega ou fica retido. Em atrasos, abre um chamado ou escala. Confira na documentação do Melhor Envio quais eventos são enviados, em vez de depender de consultas repetidas.
Qual a diferença entre usar o Melhor Envio e a API direta dos Correios?
O Melhor Envio é um intermediário que reúne várias transportadoras e Correios sob uma conta só, com cotação comparada. A API dos Correios exige contrato próprio e atende só aos Correios. Para lojas pequenas sem contrato, o intermediário é mais prático; quem tem contrato e volume pode preferir o acesso direto. Compare custo, prazo e suporte antes de decidir.
Endereços de clientes no Melhor Envio exigem cuidado de LGPD?
Sim: nome, endereço e telefone são dados pessoais, usados apenas para a entrega. O agente de logística precisa deles, mas outros agentes não. Evite expor endereços em conversas abertas e defina quanto tempo guardar o histórico de envios. A trilha de auditoria registra qual agente gerou cada etiqueta, o que ajuda a prestar contas.
Preciso programar para usar o Melhor Envio com um agente?
Para cadastrar o aplicativo e fazer a autorização OAuth, ajuda ter alguém técnico na primeira vez. Depois, o agente cota e compra seguindo as regras que você configurou. Se a loja usa uma plataforma de e-commerce que já integra com o Melhor Envio, às vezes o agente só precisa ler os pedidos e disparar a compra, reduzindo o esforço.
