API HubSpot : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API HubSpot donne accès aux objets du CRM, comme les contacts, les entreprises, les transactions et les tickets, ainsi qu'au marketing, aux conversations et aux propriétés personnalisées. Elle sert aux équipes commerciales, au RevOps et aux intégrateurs. L'accès est ouvert, par une application privée avec jeton ou une app publique avec OAuth, et la disponibilité des fonctions dépend de l'offre.
Ce que propose l’API HubSpot
Objets du CRM
Contacts, entreprises, transactions, tickets, produits et objets personnalisés.
Associations
Liens entre objets, comme un contact avec une entreprise et une transaction.
Engagements
Notes, tâches, e-mails, appels et réunions consignés dans la chronologie.
Pipelines
Étapes des transactions et des tickets, et passage de l'une à l'autre.
Propriétés
Champs standard et personnalisés de chaque objet.
Recherche
Requêtes avec filtres sur les objets du CRM.
Webhooks
Alertes de création et de modification d'enregistrements pour les apps.
Comment accéder à l’API HubSpot
- API publiqueApplication privée avec jeton d'accès et périmètres choisis dans le compte, ou app publique avec OAuth 2.0. Les anciennes clés d'API ont été abandonnées.
- Les limites de requêtes varient selon l'offre ; utilisez la recherche et les lots plutôt que des appels unitaires.
- Choisissez des périmètres minimaux dans l'app privée.
- Les contacts reposent sur une base légale et un consentement : respectez les préférences de communication (RGPD).
Documentation officielle: developers.hubspot.com
Ce qu’un agent iTeam fait avec l’API HubSpot
Transaction bloquée à une étape
L'agent repère les transactions sans activité depuis deux semaines et envoie au commercial un résumé du dernier contact avec une suggestion de prochaine étape.
Compte rendu de réunion sans effort
Après l'appel, l'agent crée la note sur la transaction, met à jour des propriétés comme le budget et le délai et planifie la tâche de relance.
Ticket avec contexte
À l'ouverture d'un ticket, l'agent associe l'entreprise et le contrat et résume les dernières interactions pour le support.
Base propre
L'agent repère les contacts en doublon et les entreprises sans domaine et propose les corrections par lot, à valider.
De l’identifiant à l’agent au travail, avec validation
Créer une app privée dans HubSpot
Un super admin définit les périmètres minimaux, par exemple lecture et écriture des transactions et des contacts.
Enregistrer le jeton dans le coffre d'iTeam
Le jeton est conservé dans le coffre et chaque agent a ses propres droits ; le SDR ne modifie pas les pipelines.
Tester avec validation
Notes et tâches peuvent être automatiques ; changements d'étape, fusions et suppressions passent par une validation.
Équipes IA prêtes à l’emploi qui utilisent HubSpot
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.
Standard téléphonique IA
L'agent décroche, comprend la demande, prend le rendez-vous ou transmet un message clair à la bonne personne.
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.
Prospection commerciale
L'équipe construit la liste de comptes, trouve le bon interlocuteur et prépare un premier message qui parle de son entreprise, pas de la vôtre.
Qualification des leads
Chaque formulaire reçoit une réponse rapide, quelques bonnes questions, et un rendez-vous si le lead est prêt à acheter.
Vente sur WhatsApp
L'agent répond aux demandes de prix, prépare le devis ou le lien de paiement et relance au bon moment, sous le contrôle du vendeur.
Questions sur l’API HubSpot
L'API HubSpot est-elle gratuite ?
En général, l'API est disponible, y compris dans l'offre gratuite, mais certains objets et certaines limites dépendent des offres payantes.
Faut-il programmer pour utiliser l'API HubSpot avec iTeam ?
Pas nécessairement. HubSpot dispose d'un connecteur prêt à l'emploi dans le catalogue, et l'équipe de déploiement configure les flux.
Peut-on utiliser des propriétés personnalisées ?
Oui, l'API lit et écrit les propriétés personnalisées comme les propriétés standard.
