CRM & sales
HubSpot koppelen aan een autonome AI-agent
Een Atako-agent die met HubSpot is verbonden, kan contacten, bedrijven, deals en tickets lezen en bijwerken, maar alleen de objecten en acties die zijn grant dekt.
Mogelijke workflows
Verrijking en kwalificatie van binnenkomende leads
Zodra een contact het CRM binnenkomt, haalt de agent het op met get_contact, kruist hij de beschikbare informatie, werkt hij de eigenschappen bij (update_contact), legt hij een kwalificatienotitie vast (create_note) en maakt hij een opvolgtaak aan voor de betrokken salesmedewerker (create_task). De salesmedewerker houdt zelf de regie over het gesprek of de e-mail, de agent bespaart hem alleen de invoer en het vooronderzoek die normaal voorafgaan aan een eerste zinvol contact, vaak uitgesteld bij gebrek aan tijd in de dag.
Opvolging van deals die vastlopen in de pipeline
De agent zoekt naar deals zonder beweging sinds een bepaald aantal dagen (search_deals, list_pipelines om de fasen te kennen), maakt een opvolgtaak aan voor de eigenaar van de deal, opgezocht via list_owners, en kan de status bijwerken als een duidelijke regel dat rechtvaardigt (update_deal). Niets wordt verplaatst zonder een raadpleegbaar spoor in het CRM achter te laten, wat voorkomt dat pipelines opgeblazen raken met spookdeals die niemand echt opvolgt.
Aanmaken van supporttickets gekoppeld aan een account
Op basis van een signaal via e-mail of Slack maakt de agent een ticket aan (create_ticket), koppelt hij het aan het juiste contact en bedrijf (create_association), en volgt hij vervolgens de voortgang op en werkt hij het bij naarmate het gesprek vordert (update_ticket). Het ticket blijft zichtbaar en aanpasbaar voor het supportteam als elk ander, met de volledige geschiedenis van het account meteen bij het aanmaken al gekoppeld.
Acties van de connector
get_contact (lezen)
Haalt een CRM-contact op via identifier.
search_contacts (lezen)
Zoekt contacten op tekst of eigenschapfilters.
get_deal (lezen)
Haalt een CRM-deal op via identifier.
list_deals (lezen)
Geeft CRM-deals weer, gepagineerd.
list_pipelines (lezen)
Geeft pipelines en hun fasen weer (deals of tickets).
list_owners (lezen)
Geeft CRM-eigenaren weer, filterbaar op e-mail.
create_contact (schrijven)
Maakt een CRM-contact aan.
update_contact (schrijven)
Werkt de eigenschappen van een contact bij.
create_deal (schrijven)
Maakt een CRM-deal aan.
update_deal (schrijven)
Werkt een deal bij (fase, bedrag).
create_ticket (schrijven)
Maakt een supportticket aan.
create_task (schrijven)
Maakt een CRM-taak aan (opvolging, gesprek).
create_note (schrijven)
Legt een notitie vast, te koppelen aan een record.
create_association (schrijven)
Koppelt twee CRM-records aan elkaar.
Vereisten
- HubSpot-account met superadminrechten om een private app aan te maken.
- Een private app aanmaken via Settings, vervolgens Integrations, vervolgens Private Apps.
- De benodigde scopes selecteren (contacts, companies, deals, tickets, owners in lezen/schrijven).
- Het getoonde toegangstoken kopiëren na het aanmaken (voorvoegsel pat-).
- In Atako, een beheerrecht voor integraties om de grant aan de agent toe te kennen.
Hoe te verbinden
- 1
De HubSpot private app aanmaken
Via Settings, vervolgens Integrations, vervolgens Private Apps, maakt u een app aan, geeft u die een naam en kiest u vervolgens de scopes in het daarvoor bestemde tabblad.
- 2
Het token genereren en kopiëren
Zodra de app is aangemaakt, toont u het toegangstoken (pat-...) en kopieert u het, het wordt maar één keer getoond.
- 3
HubSpot koppelen in Atako
Via Instellingen, vervolgens Integraties, plakt u het toegangstoken.
- 4
De grant toekennen aan de agent
Vanaf de agentpagina of vanaf de verbinding selecteert u de precieze toegestane acties en hun reikwijdte (alleen lezen of lezen en schrijven).
Waarom een autonome agent op HubSpot aansluiten
HubSpot centraliseert de contacten, deals en tickets van een sales- of supportteam. Het repetitieve werk daaromheen, een fiche verrijken, een deal opvolgen die blijft hangen, een opvolgtaak aanmaken, gebeurt doorgaans gaandeweg, wanneer iemand eraan denkt. Een Atako-agent die via tool calling met HubSpot is verbonden, doet dit werk continu, in zijn eigen omgeving, zonder te wachten tot een salesmedewerker 's ochtends zijn takenlijst opent.
Het verschil met een klassiek automatiseringsscenario: de agent draait permanent en neemt een beslissing, niet alleen een geïsoleerde actie. Hij kan een signaal ontvangen via e-mail of Slack, het betrokken contact of de betrokken deal opzoeken in HubSpot, beslissen of er een taak moet worden aangemaakt of een eigenschap moet worden bijgewerkt, en dat vervolgens doen, binnen het exacte kader van de acties die hem zijn toegekend.
De HubSpot-connector dekt volgens de Atako-documentatie 37 acties (17 lezen, 20 schrijven), van contactzoekopdrachten tot het aanmaken van aangepaste eigenschappen. De meest directe productcasus: een agent voor RevOps-automatisering die de pipeline bewaakt, leads verrijkt en dataonregelmatigheden signaleert zonder constante handmatige tussenkomst.
Grenzen en aanbevolen aanpak
De HubSpot-API legt ratelimieten op die variëren naargelang het HubSpot-abonnement van het bedrijf (aantal aanvragen per interval van tien seconden en per dag), met nog strengere drempels op de zoek-endpoints. Een agent die een groot volume contacten verwerkt, moet zijn aanroepen dus spreiden in plaats van alles in één keer te doen.
Bepaalde schrijfacties, zoals delete_contact of delete_deal, zijn eenmaal uitgevoerd onomkeerbaar aan de kant van HubSpot. Ze zijn alleen bruikbaar als de grant van de agent ze expliciet toestaat, wat in de praktijk zeldzaam blijft voor dit soort actie.
Zoals bij elke Atako-integratie geeft de verbinding op zich geen enkele toegang: er is een precieze grant nodig (agent, actie, reikwijdte). Zie het permissiemodel en de plannen om dit werkterrein af te bakenen voordat u de agent op uw CRM aansluit.
Gerelateerde use cases
Vergelijkbare integraties
Veelgestelde vragen
Kan de agent marketing-e-mails versturen vanuit HubSpot?
Hij kan een marketing-e-mailconcept aanmaken (create_marketing_email) als die scope is toegekend, maar er wordt niets verstuurd zonder een verzendactie die door uw team wordt gevalideerd: de connector bevat geen enkele actie voor het rechtstreeks versturen van marketing-e-mails.
Is een betaald HubSpot-plan nodig om de API te koppelen?
De API en private apps zijn al beschikbaar vanaf het gratis plan van HubSpot voor standaardobjecten. Sommige geavanceerde scopes, zoals het aanmaken van aangepaste eigenschappen, kunnen afhangen van het gekozen tariefniveau.
Hoe trekt u de toegang van de agent tot HubSpot in?
Verwijder of deactiveer de private app aan de kant van HubSpot, of trek de verbinding in bij Atako. De toegang wordt in beide gevallen onmiddellijk en definitief afgesloten voor alle agents die deze gebruikten.
Kan de agent contacten uit het CRM verwijderen?
Ja, de actie delete_contact bestaat, maar alleen als de grant van de agent die expliciet toestaat met schrijfreikwijdte. Standaard is geen enkele actie toegekend: u beslist zelf of verwijdering deel uitmaakt van het werkterrein van de agent.
Wat hierna te lezen
Bronnen
- HubSpot Developer Docs, Private apps · geraadpleegd op 4 september 2026
- HubSpot Developer Docs, API usage guidelines and limits · geraadpleegd op 4 september 2026
CTO bij Atako
Deze inhoud is geschreven door de AI-agents van Atako en vervolgens nagelezen, gecorrigeerd en goedgekeurd door Romain Laodicina, CTO van Atako.