CRM & ventes
Connecter HubSpot à un agent IA autonome
Un agent Atako connecté à HubSpot peut lire et mettre à jour contacts, entreprises, deals et tickets, mais uniquement les objets et actions couverts par son grant.
Workflows possibles
Enrichissement et qualification des leads entrants
Dès qu'un contact arrive dans le CRM, l'agent le récupère avec get_contact, recoupe l'information disponible, met à jour ses propriétés (update_contact), consigne une note de qualification (create_note) et crée une tâche de relance pour le commercial concerné (create_task). Le commercial garde la main sur l'appel ou l'email, l'agent lui évite juste la saisie et la recherche préalable qui précèdent normalement un premier contact utile, souvent remise à plus tard faute de temps disponible dans la journée.
Relance des deals qui stagnent dans le pipeline
L'agent recherche les deals sans mouvement depuis un certain nombre de jours (search_deals, list_pipelines pour connaître les étapes), crée une tâche de relance pour le propriétaire du deal identifié via list_owners, et peut mettre à jour le statut si une règle claire le justifie (update_deal). Rien n'est déplacé sans laisser de trace consultable dans le CRM, ce qui évite les pipelines gonflés par des deals fantômes que personne ne relance vraiment.
Création de tickets support liés à un compte
À partir d'un signal reçu par email ou Slack, l'agent crée un ticket (create_ticket), l'associe au bon contact et à la bonne entreprise (create_association), puis suit son avancement et le met à jour au fil de la conversation (update_ticket). Le ticket reste visible et modifiable par l'équipe support comme n'importe quel autre, avec l'historique complet du compte déjà rattaché dès sa création.
Actions du connecteur
get_contact (lecture)
Récupère un contact CRM par identifiant.
search_contacts (lecture)
Recherche des contacts par texte ou filtres de propriétés.
get_deal (lecture)
Récupère un deal CRM par identifiant.
list_deals (lecture)
Liste les deals CRM, paginé.
list_pipelines (lecture)
Liste les pipelines et leurs étapes (deals ou tickets).
list_owners (lecture)
Liste les propriétaires CRM, filtrable par email.
create_contact (écriture)
Crée un contact CRM.
update_contact (écriture)
Met à jour les propriétés d'un contact.
create_deal (écriture)
Crée un deal CRM.
update_deal (écriture)
Met à jour un deal (étape, montant).
create_ticket (écriture)
Crée un ticket support.
create_task (écriture)
Crée une tâche CRM (relance, appel).
create_note (écriture)
Consigne une note, à associer à un enregistrement.
create_association (écriture)
Associe deux enregistrements CRM entre eux.
Prérequis
- Compte HubSpot avec droit super admin pour créer une private app.
- Créer une private app dans Settings puis Integrations puis Private Apps.
- Sélectionner les scopes nécessaires (contacts, companies, deals, tickets, owners en lecture/écriture).
- Copier le jeton d'accès affiché après création (préfixe pat-).
- Dans Atako, un droit d'administration des intégrations pour accorder le grant à l'agent.
Comment connecter
- 1
Créer la private app HubSpot
Dans Settings puis Integrations puis Private Apps, créer une app, la nommer, puis choisir ses scopes dans l'onglet dédié.
- 2
Générer et copier le jeton
Une fois l'app créée, afficher puis copier le jeton d'accès (pat-...), affiché une seule fois.
- 3
Connecter HubSpot dans Atako
Dans Paramètres puis Intégrations, coller le jeton d'accès.
- 4
Accorder le grant à l'agent
Depuis la page de l'agent ou depuis la connexion, sélectionner les actions précises autorisées et leur portée (lecture seule ou lecture et écriture).
Pourquoi brancher un agent autonome sur HubSpot
HubSpot centralise les contacts, les deals et les tickets d'une équipe commerciale ou support. Le travail répétitif qui va avec, enrichir une fiche, relancer un deal qui traîne, créer une tâche de suivi, se fait généralement au fil de l'eau, quand quelqu'un y pense. Un agent Atako connecté à HubSpot via tool calling fait ce travail en continu, dans son propre environnement, sans attendre qu'un commercial ouvre sa liste de tâches du matin.
La différence avec un scénario d'automatisation classique : l'agent tourne en permanence et prend une décision, pas seulement une action isolée. Il peut recevoir un signal par email ou Slack, chercher le contact ou le deal concerné dans HubSpot, décider s'il faut créer une tâche ou mettre à jour une propriété, puis le faire, dans le cadre exact des actions qui lui ont été accordées.
Le connecteur HubSpot couvre 37 actions selon la documentation Atako (17 lecture, 20 écriture), de la recherche de contacts à la création de propriétés personnalisées. Le cas d'usage produit le plus direct : un agent d'automatisation du RevOps qui surveille le pipeline, enrichit les leads et signale les anomalies de données sans intervention manuelle constante.
Limites et bonnes pratiques
L'API HubSpot impose des limites de débit qui varient selon l'abonnement HubSpot de l'entreprise (nombre de requêtes par intervalle de dix secondes, et par jour), avec des seuils plus stricts encore sur les endpoints de recherche. Un agent qui traite un gros volume de contacts doit donc étaler ses appels plutôt que tout faire d'un coup.
Certaines actions écriture, comme delete_contact ou delete_deal, sont irréversibles côté HubSpot une fois exécutées. Elles ne sont utilisables que si le grant de l'agent les autorise explicitement, ce qui reste rare en pratique pour ce type d'action.
Comme pour toute intégration Atako, la connexion à elle seule ne donne aucun accès : il faut un grant précis (agent, action, portée). Voir le modèle de permissions et les plans pour cadrer ce périmètre avant de brancher l'agent sur votre CRM.
Cas d'usage associés
Intégrations complémentaires
Questions fréquentes
L'agent peut-il envoyer des emails marketing depuis HubSpot ?
Il peut créer un brouillon d'email marketing (create_marketing_email) si ce scope est accordé, mais rien ne part sans une action d'envoi validée par votre équipe : le connecteur ne comporte aucune action d'envoi direct d'email marketing.
Faut-il un plan HubSpot payant pour connecter l'API ?
L'API et les private apps sont disponibles dès le plan gratuit de HubSpot pour les objets standards. Certains scopes avancés, comme la création de propriétés personnalisées, peuvent dépendre du palier tarifaire souscrit.
Comment révoquer l'accès de l'agent à HubSpot ?
Supprimez ou désactivez la private app côté HubSpot, ou révoquez la connexion côté Atako. L'accès est coupé immédiatement et définitivement pour tous les agents qui l'utilisaient.
L'agent peut-il supprimer des contacts du CRM ?
Oui, l'action delete_contact existe, mais seulement si le grant de l'agent l'autorise explicitement avec la portée écriture. Par défaut, aucune action n'est accordée : c'est vous qui décidez si la suppression fait partie du périmètre de l'agent.
À lire ensuite
Sources
- HubSpot Developer Docs, Private apps · consulté le 4 septembre 2026
- HubSpot Developer Docs, API usage guidelines and limits · consulté le 4 septembre 2026
CTO d'Atako
Ce contenu a été rédigé par les agents IA d'Atako, puis relu, corrigé et validé par Romain Laodicina, CTO d'Atako.