API Hotmart : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API de Hotmart, plateforme brésilienne de produits numériques, donne accès à l'historique des ventes, aux abonnements, aux élèves de l'espace membres et aux coupons d'un producteur. Elle sert aux créateurs de formations, aux sociétés d'enseignement et aux intégrateurs qui relient Hotmart au CRM et au support. L'accès utilise des identifiants générés dans le compte du producteur, et des webhooks signalent les événements d'achat.
Ce que propose l’API Hotmart
Ventes
Historique des transactions, commissions, participants et détail de chaque achat.
Abonnements
Abonnés, statut, facturations et résiliations des produits récurrents.
Espace membres
Élèves, progression et modules de la formation hébergée sur Hotmart.
Coupons
Création et consultation de coupons de réduction par produit.
Webhooks
Alertes d'achat approuvé, de boleto généré (paiement brésilien par bordereau), de remboursement, d'annulation et d'autres événements.
Produits
Consultation des produits et des offres du compte.
Comment accéder à l’API Hotmart
- Avec les identifiants de votre entrepriseIdentifiants (client id, client secret et basic) générés dans l'espace outils pour développeurs du compte Hotmart, échangés contre un jeton d'accès.
- Les acheteurs sont des données personnelles : à n'utiliser que pour le support et une communication consentie (LGPD, la loi brésilienne de protection des données).
- L'API impose des limites de requêtes ; privilégiez les webhooks pour les événements en temps réel.
- Validez la signature des webhooks pour ne pas traiter de fausses alertes.
Documentation officielle: developers.hotmart.com
Ce qu’un agent iTeam fait avec l’API Hotmart
Boleto généré et non payé
Le webhook de boleto prévient l'agent, qui relance l'acheteur sur WhatsApp avant l'échéance et renvoie le lien quand il le demande.
Abonné dont le paiement est refusé
L'agent repère les abonnements en retard de paiement et guide la mise à jour de la carte, sans que l'équipe ait à courir derrière chaque cas.
Élève bloqué dans la formation
Grâce à la progression de l'espace membres, l'agent retrouve les élèves qui n'ont pas dépassé le premier module et leur envoie un message de relance.
Demande de remboursement
Avant de rembourser, l'agent confirme l'achat, le délai de garantie et le motif, et remet le dossier prêt pour validation.
De l’identifiant à l’agent au travail, avec validation
Générer les identifiants dans Hotmart
Dans le compte du producteur, créez les identifiants d'API et configurez les webhooks des événements utiles.
Enregistrer dans le coffre d'iTeam
Identifiants et secret du webhook sont conservés dans le coffre ; l'agent de support voit les ventes et les élèves, mais ne modifie pas les produits.
Tester avec validation
Les messages aux acheteurs démarrent relus, et les remboursements passent toujours par une validation humaine.
Équipes IA prêtes à l’emploi pour ce travail
Service client WhatsApp
Vos clients ont une réponse sur WhatsApp à toute heure, et votre équipe reprend la conversation là où l'agent l'a laissée.
Support client et SAV
Chaque ticket reçoit une réponse fondée sur votre base Confluence, et les cas délicats arrivent chez la bonne personne avec un brouillon prêt.
Standard téléphonique IA
L'agent décroche, comprend la demande, prend le rendez-vous ou transmet un message clair à la bonne personne.
SAV e-commerce
L'agent lit la commande dans Shopify ou WooCommerce, donne le vrai statut de livraison et prépare les retours, pendant que vous gérez la boutique.
Customer success et fidélisation
L'équipe repère les clients qui décrochent, prépare la bonne relance et dit à votre CSM qui appeler cette semaine.
Satisfaction et avis clients
Les réponses à vos enquêtes et vos avis sont lus, classés par thème et transformés en liste d'actions avec un responsable.
Questions sur l’API Hotmart
L'API de Hotmart est-elle gratuite ?
En général, oui : les producteurs accèdent à l'API sans coût supplémentaire ; Hotmart prélève ses frais sur les ventes.
Faut-il programmer pour utiliser l'API de Hotmart avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation de Hotmart et l'équipe de déploiement configure les flux.
Peut-on recevoir la vente en temps réel ?
Oui, grâce aux webhooks, qui signalent achat approuvé, remboursement et autres événements dès qu'ils se produisent.
