API Melhor Envio : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API de Melhor Envio, plateforme brésilienne d'expédition, permet de comparer le fret de plusieurs transporteurs, d'acheter et de générer des étiquettes et de suivre les envois. Elle sert aux boutiques en ligne et aux plateformes e-commerce qui veulent automatiser l'expédition au Brésil. L'accès se fait par une application OAuth 2.0, et un environnement sandbox permet de tester.
Ce que propose l’API Melhor Envio
Devis de fret
Prix et délai de plusieurs transporteurs pour un code postal, un poids et des dimensions.
Panier d'envois
Ajout des envois à acheter, avec expéditeur, destinataire et colis.
Achat et étiquettes
Paiement du fret avec le solde du compte, génération et impression des étiquettes.
Suivi
Statut et événements de chaque envoi.
Agences et transporteurs
Points de dépôt et services disponibles.
Webhooks
Alertes de changement de statut des envois.
Comment accéder à l’API Melhor Envio
- Avec les identifiants de votre entrepriseOAuth 2.0 avec une application enregistrée chez Melhor Envio ; le compte de la boutique autorise les périmètres et le jeton est renouvelé périodiquement.
- Acheter du fret consomme un solde réel : gardez une validation ou un plafond de montant par lot.
- Utilisez le sandbox pour tester avant d'autoriser le compte de production.
- Les adresses des clients sont des données personnelles ; limitez-les à ceux qui en ont besoin (LGPD, la loi brésilienne de protection des données).
Documentation officielle: docs.melhorenvio.com.br
Ce qu’un agent iTeam fait avec l’API Melhor Envio
Étiquettes du jour sans saisie
Les commandes payées entrent dans le panier de Melhor Envio avec le service choisi par l'agent. Le responsable valide le lot et les étiquettes sortent prêtes.
Fret pour une commande hors norme
Pour un gros volume ou un code postal éloigné, l'agent interroge les transporteurs et renvoie au vendeur les options avec délai et prix.
Solde du portefeuille presque épuisé
L'agent surveille le solde servant à payer le fret et prévient la finance avant que l'expédition ne soit bloquée.
Client qui s'inquiète de sa livraison
L'agent récupère le suivi de l'envoi et répond sur WhatsApp avec le dernier événement et la date prévue.
De l’identifiant à l’agent au travail, avec validation
Créer l'application et tester dans le sandbox
Enregistrez l'app chez Melhor Envio, validez les flux dans l'environnement de test, puis autorisez le compte de production.
Enregistrer l'autorisation dans le coffre d'iTeam
L'agent de support ne consulte que le suivi ; celui de l'expédition fait les devis et monte le panier.
Achat avec validation
Au début, le paiement du fret et la génération des étiquettes passent par une validation humaine.
Équipes IA prêtes à l’emploi qui utilisent Melhor Envio
Questions sur l’API Melhor Envio
L'API de Melhor Envio est-elle gratuite ?
En général, oui : l'intégration n'a pas de coût propre, et vous payez le fret acheté avec le solde du compte.
Faut-il programmer pour utiliser l'API de Melhor Envio avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation et l'équipe de déploiement configure les flux.
Existe-t-il un environnement de test ?
Oui, Melhor Envio propose un sandbox pour tester les devis et les étiquettes sans coût réel.
