- Kennisbank
- Account & Opstelling
- Integraties
- Gebruik de HubSpot Agent CLI
Gebruik de HubSpot Agent CLI
Laatst bijgewerkt: 29 september 2026
Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:
De HubSpot Agent CLI koppelt AI-codeeragenten, zoals die in de ChatGPT-app, de Claude-app en Claude Code, aan je HubSpot-account. Nadat u de Agent CLI met HubSpot hebt gekoppeld, kunt u een AI-agent vragen om repetitieve CRM-taken uit te voeren, gegevens te analyseren, samenvattingen te genereren en te helpen bij het beheren van processen in uw account. Wanneer u taken aan AI-agenten delegeert, kunnen zij de Agent CLI gebruiken om routinematig werk voor u te automatiseren, waardoor uw team meer tijd kan besteden aan strategische initiatieven.
In plaats van bijvoorbeeld elke week handmatig records te controleren, kunt u een AI-agent vragen om onvolledige records te identificeren, de activiteiten in de pijplijn samen te vatten of accountbeoordelingen voor te bereiden met behulp van informatie uit HubSpot.
Als je een ontwikkelaar bent die aangepaste scripts wil schrijven of de HubSpot Agent CLI handmatig in je terminal wil gebruiken, raadpleeg dan de ontwikkelaarsdocumentatie van HubSpot.
Voordat je aan de slag gaat
Zorg ervoor dat je toegang hebt tot een AI-codeeragent voordat je de HubSpot Agent CLI gaat gebruiken. Ondersteunde agents zijn onder andere die in de ChatGPT-app, de Claude-app,Claude Code en vele andere compatibele AI-codeeragents.
Let op: als je Claude Cowork gebruikt in een Team- of Enterprise-account, moet de beheerder van je organisatie mogelijk api.hubapi.com op de allowlist zetten voordat de CLI kan worden geïnstalleerd of uitgevoerd. Lees meer over het toevoegen aan de allowlist in Claude Cowork.
Wanneer gebruik je de HubSpot Agent CLI?
De Agent CLI is handig voor repetitieve of terugkerende operationele taken waarbij grote hoeveelheden CRM-gegevens moeten worden doorgenomen. Denk hierbij aan taken zoals het uitvoeren van een wekelijkse pipeline-evaluatie, het in bulk bijwerken van records of het versturen van geplande samenvattingen naar je team na een terugkerende maandelijkse vergadering. Bekijk meer voorbeelden van gebruiksscenario’s.
Als je eenmalige vragen wilt stellen of inhoud wilt opstellen op basis van je HubSpot-gegevens, zijn de HubSpot-connector voor Claude of de HubSpot-connector voor ChatGPT opties waarvoor geen CLI-installatie nodig is.
Waar AI-agenten toegang toe hebben met de HubSpot Agent CLI
De HubSpot Agent CLI kan acties uitvoeren met de rechten van de gekoppelde HubSpot-gebruiker. Afhankelijk van je gebruikersrechten kan dit onder meer het aanmaken, bijwerken of verwijderen van records in je account omvatten.
Nadat de HubSpot Agent CLI is gekoppeld, kunnen AI-agenten werken met informatie in je hele HubSpot-account, waaronder:
- Contacten, bedrijven, deals, tickets, aangepaste objecten en andere CRM-records.
- Workflows.
- Pijplijnen en pijplijnfasen.
- Eigenschappen en aangepaste eigenschappen.
- Omzetrecords (alleen-lezen): contracten, facturen, bestellingen, betalingen, offertes, offertesjablonen en abonnementen (BETA).
- Koppelingen tussen records.
- Activiteitengeschiedenis.
Let op: controleer altijd door AI gegenereerde aanbevelingen en voorgestelde acties voordat je wijzigingen doorvoert in je CRM-gegevens.
Aanbevolen werkwijzen
Wanneer u werkt met AI-agenten die zijn gekoppeld aan HubSpot:
- Begin met rapportages, overzichten en analysetaken voordat u acties uitvoert die gegevens wijzigen.
- Wanneer u geplande of terugkerende taken instelt, begin dan met één specifiek gebruiksscenario voordat u dit uitbreidt naar bredere automatisering.
- Controleer gegenereerde aanbevelingen en grootschalige updates voordat u wijzigingen doorvoert.
- Sommige acties kunnen HubSpot-gegevens verwijderen of overschrijven. Gebruik, indien beschikbaar, de optie --dry-runom een voorbeeld van de wijzigingen te bekijken voordat u ze toepast.
- Gebruik duidelijke, specifieke instructies die het gewenste resultaat beschrijven.
- Volg het beleid van je organisatie op het gebied van gegevensbeheer en beveiliging.
De HubSpot Agent CLI koppelen
Volg de onderstaande stappen om je agent te instrueren de HubSpot Agent CLI te installeren. Als je een ontwikkelaar bent, lees dan meer over het handmatig installeren van de HubSpot Agent CLI.
- Open je AI-agent.
- Plak de volgende prompt in de werkruimte van je agent om de Agent CLI te installeren.
Install the HubSpot Agent CLI in this agent workspace. If this workspace uses a POSIX shell (macOS, Linux, WSL, or Bash), run `curl -fsSL https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.sh | sh`. If it uses Windows PowerShell, run `irm https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.ps1 | iex`. Then authenticate with `hubspot auth login`, install HubSpot Agent CLI Skills with `npx skills add hubspot/agent-cli-skills`, and use `hubspot --help` to explore what's available.
- Meld je aan bij je HubSpot-account wanneer daarom wordt gevraagd.
- Controleer de gevraagde machtigingen.
- Klik op 'App verbinden'.
Nadat de authenticatie is voltooid, heeft de AI-agent toegang tot HubSpot-gegevens op basis van je machtigingen.
Voorbeelden van gebruikssituaties
De volgende voorbeelden laten zien hoe verschillende teams AI-agenten kunnen gebruiken die via de HubSpot Agent CLI zijn aangesloten.
Marketingteams
| Taak | Voorbeeldopdracht voor de AI-agent |
| Identificeer contacten die opvolging of gegevensopschoning nodig hebben. | Zoek elke maandag om 8.00 uur contacten die goed bij het bedrijf passen, maar waarvoor geen deal is gekoppeld, geen recente verkoopactiviteit is of waarvoor belangrijke aanvullende velden ontbreken, en stuur vervolgens een geprioriteerde opschoningslijst met voorgestelde vervolgacties naar RevOps. |
| Controleer e-mailcampagnes op onderwerpen en CTA's die niet voldoen aan de richtlijnen voor de merkstem. | Controleer mijn laatste 10 e-mailcampagnes en markeer onderwerpen of CTA's die niet voldoen aan onze richtlijnen voor de merkstem. Vermeld elk probleem met de naam van de campagne, de gemarkeerde tekst en een voorgestelde aanpassing. |
| Identificeer berichtpatronen op goed presterende landingspagina’s die correleren met hogere conversiepercentages. | Analyseer mijn best presterende landingspagina’s op conversiepercentage. Identificeer veelvoorkomende berichtpatronen, zoals de structuur van de koptekst, de formulering van de CTA of het type aanbieding, en vat samen wat ze gemeen hebben. |
| Stel een lijst samen van contactpersonen die geen e-mails in een nurture-reeks hebben geopend, om hen opnieuw te betrekken. | Zoek alle contactpersonen die momenteel zijn ingeschreven voor een nurture-reeks en die de afgelopen 30 dagen geen e-mails hebben geopend. Maak een segment aan met hun naam, bedrijf, levenscyclusfase en datum van laatste activiteit. |
| Houd de huidige pijplijnstatus bij van deals die afkomstig zijn uit een webinar-campagne. | Zoek alle deals met een leadbron ‘webinar’ en toon hun huidige pijplijnfase, eigenaar, bedrag en datum van laatste activiteit. Vat samen hoeveel er actief, vastgelopen of afgesloten zijn. |
| Breng patronen in sector, bedrijfsgrootte en leadbron in kaart onder de meest geschikte klanten. | Bekijk mijn afgesloten en gewonnen deals van de afgelopen 12 maanden en geef een overzicht van de meest voorkomende combinaties van branche, bedrijfsgrootte en leadbron. Breng eventuele patronen in kaart die kunnen helpen bij het verfijnen van ons ideale klantprofiel. |
| Houd actieve sequenties in de gaten en markeer significante dalingen in de open rates van e-mails. | Controleer alle actieve sequenties en vergelijk de open rates van de afgelopen twee weken met die van de twee weken daarvoor. Markeer alle sequenties waarbij de open rates met meer dan 20% zijn gedaald, en vermeld de naam van de sequentie, de huidige rate en de vorige rate. |
Verkoop- en omzetteams
| Taak | Voorbeeldopdracht voor de AI-agent |
| Houd de status van de pijplijn in de gaten en identificeer deals die aandacht nodig hebben. | Controleer elke ochtend om 7.00 uur mijn pijplijn op deals die deze week worden afgesloten en waar de afgelopen 5 dagen geen activiteit in is geweest, en stuur mij een overzicht. |
| Zoek inactieve deals met een hoge waarde die moeten worden opgevolgd en beoordeeld. | Zoek alle openstaande deals van meer dan $[bedrag] waarbij de afgelopen 14 dagen geen activiteit is geweest. Sorteer op dealwaarde en vermeld de naam van de deal, de eigenaar, de afsluitdatum en de laatste activiteit. |
| Bereid een klantgesprek voor door de geschiedenis van de deal, support, e-mails en notities samen te vatten. | Ik heb morgen een vergadering met [Bedrijf]. Geef een overzicht van hun openstaande en recent afgesloten deals, de laatste 5 supporttickets, recente e-mailactiviteit en eventuele notities die in de afgelopen 60 dagen zijn vastgelegd. |
| Analyseer mislukte deals om te bepalen in welke pijplijnfasen kansen het langst vastliepen. | Bekijk deals waarvan de afsluitdatum in het afgelopen kwartaal is verstreken. Geef voor elke deal aan in welke pijplijnfase deze het langst heeft vastgezeten en identificeer de twee of drie fasen waarin deals het vaakst vastlopen. |
| Maak een dagelijks overzicht van deals waarvan de afsluitdatum nadert, maar waarvoor geen recente activiteit is. | Zoek elke dag om 8.00 uur naar deals die binnen de komende 7 dagen worden afgesloten en waar de afgelopen 3 dagen geen activiteit in is geweest. Stuur mij een overzicht met de naam van de deal, de verantwoordelijke, het bedrag, de afsluitdatum en het type van de laatste activiteit. |
Verkoopmanagers
| Taak | Voorbeeldopdracht voor de AI-agent |
| Analyseer gespreksverslagen op thema’s voor coaching en productfeedback. | Analyseer recente gespreksverslagen op gespreksduur, vermeldingen van concurrenten, feedback van klanten en aarzelingen bij potentiële klanten, en maak vervolgens een dashboard voor coaching en productfeedback met voorbeelden uit de verslagen en links naar de bron-gesprekken. |
| Identificeer verkopers of teams met ongewoon hoge of lage gespreksduurpatronen. | Analyseer gespreksverslagen van de afgelopen 30 dagen en bereken de gemiddelde gespreksduur per vertegenwoordiger. Markeer iedereen met een percentage boven de 70% of onder de 30%, en voeg voor elk een voorbeeldfragment uit het verslag toe. |
| Zoek terugkerende vermeldingen van concurrenten in recente verkoopgesprekken. | Bekijk gesprekstranscripten van de afgelopen 60 dagen en identificeer de concurrenten die het vaakst worden genoemd. Geef voor elk daarvan aan in hoeveel gesprekken ze werden genoemd, in welke fasen van de deal ze ter sprake kwamen, en voeg een voorbeeldcitaat toe. |
| Vat de thema’s van aarzelingen bij potentiële klanten samen per segment, dealfase of productgebied. | Doorzoek recente gesprekstranscripten op taalgebruik dat wijst op aarzeling of bezwaren bij potentiële klanten. Groepeer de thema’s per dealfase en prospectsegment, en vat de top 5 aarzelingspatronen samen met voorbeeldcitaten. |
| Selecteer voorbeelden uit de transcripties die thema’s voor coaching of productfeedback ondersteunen. | Zoek in de gespreksverslagen van de afgelopen 30 dagen drie tot vijf voorbeelden van sterke verkennende vragen en drie tot vijf voorbeelden van gemiste momenten om bezwaren weg te nemen. Vermeld de naam van de verkoper, de datum van het gesprek en een direct citaat uit elk voorbeeld. |
| Maak een dashboard dat inzichten uit gesprekken koppelt aan de bronrecords en transcripties. | Maak een coachingdashboard met een overzicht van de gespreksduurverhoudingen, vermeldingen van concurrenten en bezwaarthema’s uit gesprekken van de afgelopen 30 dagen. Voeg bij elk inzicht een link toe naar het bron-gesprek en het bijbehorende dealrecord. |
RevOps- en CRM-beheerders
| Opdracht | Voorbeeldopdracht voor de AI-agent |
| Ruim CRM-velden op zonder dat dit gevolgen heeft voor downstream-assets. | Zoek dubbele of verouderde CRM-eigenschappen en laat zien waar deze worden gebruikt in workflows, rapporten en weergaven. Geef vervolgens een voorbeeld van een opschoningsplan om velden te vervangen, te verwijderen of te herschikken voordat de wijzigingen worden doorgevoerd. |
| Identificeer dubbele eigenschappen die dezelfde informatie verzamelen voor verschillende objecten. | Scan alle eigenschappen van contacten, bedrijven en deals en markeer alle eigenschappen die onder verschillende namen dezelfde informatie lijken te verzamelen. Maak een lijst van de eigenschapsnamen, de bijbehorende objecten en een voorgestelde actie voor elk dubbel paar. |
| Zoek verouderde velden die nog steeds voorkomen in workflows, rapporten, weergaven of recordlay-outs. | Zoek alle CRM-eigenschappen die de afgelopen 12 maanden niet zijn bijgewerkt, maar nog steeds voorkomen in actieve workflows, opgeslagen rapporten, lijstweergaven of recordkaartlay-outs. Geef aan waar elk veld wordt gebruikt voordat er wijzigingen worden aangebracht. |
| Bekijk vooraf de gevolgen van het verwijderen of vervangen van een CRM-eigenschap voordat u wijzigingen doorvoert. | Ik wil de eigenschap [Naam eigenschap] verwijderen. Laat me, voordat er wijzigingen worden aangebracht, alle workflows, rapporten, lijsten en recordlay-outs zien waarin deze wordt gebruikt, en geef een voorbeeld van wat niet meer zou werken of moet worden bijgewerkt. |
| Herschik recordvelden zodat beheerders en vertegenwoordigers de belangrijkste informatie als eerste zien. | Verplaats voor de lay-out van het contactrecord deze velden naar de bovenkant van de zijbalk met eigenschappen: [Veld 1], [Veld 2], [Veld 3]. Bekijk een voorbeeld voordat u de wijzigingen toepast. |
| Genereer een overzicht van de opschoning waarin wordt weergegeven wat er is gewijzigd en wat nog moet worden gecontroleerd. | Genereer na voltooiing van de CRM-opruiming een overzicht van alle eigenschappen die zijn verwijderd, vervangen of hernoemd, welke assets zijn bijgewerkt en een lijst van alle velden die nog handmatig moeten worden gecontroleerd. |
Operationele teams
| Taak | Voorbeeldprompt voor de AI-agent |
| Consolideer gerelateerde supporttickets en bewaar de opschoningsgeschiedenis. | Voeg dubbele supporttickets samen, bewaar de details van het bronticket, stuur elk bovenliggend ticket door naar de juiste pijplijnfase en stuur het team een overzicht van de opschoning met alle records die nog moeten worden gecontroleerd. |
| Zoek dubbele of gerelateerde supporttickets van dezelfde klant of met hetzelfde type probleem. | Zoek alle openstaande supporttickets van hetzelfde bedrijf die binnen 30 dagen na elkaar zijn aangemaakt. Groepeer ze per bedrijf en probleemtype, en markeer alle tickets die duplicaten lijken te zijn. |
| Voeg de ticketcontext samen in een bovenliggend record, met behoud van de brongegevens. | Voeg voor de hierboven geïdentificeerde dubbele tickets de beschrijving, de contactgeschiedenis en de notities van elk bronticket samen in de notities van het bovenliggende record, voordat u de duplicaten sluit. |
| Leid de samengevoegde tickets naar de juiste pijplijnfase op basis van de huidige status. | Controleer voor elk samengevoegd bovenliggend ticket de huidige status en verplaats het naar de juiste pijplijnfase: open issues naar ‘In behandeling’, tickets die wachten op een reactie naar ‘In afwachting van klant’ en opgeloste issues naar ‘Gesloten’. |
| Markeer tickets die vóór het samenvoegen door een medewerker moeten worden gecontroleerd. | Markeer, voordat je tickets samenvoegt, records met een openstaand betalingsgeschil, een actieve SLA-teller of een notitie die is gemarkeerd als escalatie. Voeg deze niet samen. Zet ze in plaats daarvan op de lijst voor handmatige beoordeling. |
| Stuur een overzicht van de opschoning met samengevoegde records, openstaande vragen en de verantwoordelijken voor de opvolging. | Nadat de ticketconsolidatie is voltooid, stuur je de leidinggevende van het ondersteuningsteam een overzicht met daarin elk aangemaakt bovenliggend ticket, welke brontickets erin zijn samengevoegd, eventuele openstaande vragen die opvolging vereisen en wie verantwoordelijk is voor elke volgende stap. |
Supportteams
| Taak | Voorbeeldprompt voor de AI-agent |
| Bekijk de klantgeschiedenis zonder handmatig meerdere records te openen. | Haal de laatste 5 tickets van deze contactpersoon op, vat elke oplossing samen en markeer eventuele terugkerende probleem patronen. |
| Bekijk de recente ticketgeschiedenis en identificeer terugkerende klantproblemen voordat je een nieuwe case opent. | Voordat ik een nieuw ticket aanmaak voor [Contact], haal dan de laatste 10 tickets van deze klant op, vat elke oplossing samen en markeer eventuele problemen die vaker dan eens voorkomen. Vermeld het ticketonderwerp, de status en de datum van oplossing. |
| Geef prioriteit aan tickets waarbij de verwachte reactietijd is overschreden. | Zoek alle openstaande tickets waarop niet binnen de verwachte SLA-termijn is gereageerd. Sorteer ze op hoe lang ze al achterstallig zijn en vermeld de ticketverantwoordelijke, de naam van de contactpersoon en de datum van de laatste activiteit. |
| Analyseer factureringsgerelateerde tickets om de meest voorkomende redenen te identificeren waarom klanten contact opnemen met de ondersteuning. | Bekijk alle tickets van de afgelopen 90 dagen die zijn getagd met een factureringsgerelateerde categorie. Vat de vijf belangrijkste redenen samen waarom klanten contact hebben opgenomen met de ondersteuning, gerangschikt op aantal, en vermeld de gemiddelde tijd tot oplossing voor elk daarvan. |
| Stel antwoorden op tickets op met relevante informatie over de deal, het abonnement en de escalatiegeschiedenis. | Haal voor ticket [Ticket-ID] de bijbehorende dealgeschiedenis van de contactpersoon, de huidige abonnementsgegevens en eventuele eerdere escalatienotities op. Vat de context samen en stel een antwoord op dat het probleem van de klant aanpakt. |
Customer Success-teams
| Taak | Voorbeeldprompt voor de AI-agent |
| Stel accountbeoordelingen op aan de hand van informatie uit meerdere HubSpot-tools. | Vat voor mijn accountbeoordeling van deze week de openstaande deals, recente ondersteuningsactiviteiten en de laatste NPS-score samen voor elk account in mijn klantenbestand. |
| Identificeer klantaccounts met indicatoren die wijzen op een verhoogd risico op klantverloop. | Beoordeel de accounts in mijn klantenbestand en markeer alle accounts met twee of meer van de volgende signalen: afnemende inlogfrequentie op het product, open supporttickets die ouder zijn dan 14 dagen, een NPS-score lager dan 7 of geen CSM-activiteit in de afgelopen 30 dagen. Rangschik ze op risiconiveau. |
| Zoek contactpersonen voor verlengingen met een lage productbetrokkenheid voor proactieve benadering. | Zoek alle contactpersonen bij accounts die binnen de komende 60 dagen worden verlengd en die de afgelopen 21 dagen niet op het product hebben ingelogd. Stel een geprioriteerde contactlijst op met de naam van de contactpersoon, het account, de verlengingsdatum en de datum van de laatste login. |
| Bereid accountbeoordelingen voor door recente activiteiten op het gebied van verkoop, ondersteuning en klantfeedback samen te vatten. | Maak voor [Accountnaam] een overzicht van alle dealactiviteiten van de afgelopen 6 maanden, openstaande en recent afgesloten supporttickets, en eventuele NPS- of CSAT-reacties. Zet dit op als een pre-QBR-briefing die ik kan delen met het accountteam. |
| Identificeer uitbreidingsmogelijkheden door de groeitrends van accounts te vergelijken met de historische omvang van deals. | Bekijk accounts in mijn klantenbestand die het afgelopen jaar zijn gegroeid in personeelsaantal of omzet. Vergelijk hun huidige omvang van de deals met de groei van vergelijkbare accounts en markeer de top 10 als potentiële uitbreidingskansen. |
Houd de vaardighedenbibliotheek up-to-date
HubSpot Agent CLI Skills bieden vooraf gedefinieerde richtlijnen die AI-agenten helpen bij het werken met HubSpot-gegevens en veelvoorkomende HubSpot-processen. De vaardighedenbibliotheek bevat richtlijnen voor CRM-zoekopdrachten, bulkbewerkingen, taken op het gebied van gegevenskwaliteit, workflows, rapportage en andere operationele activiteiten.
Je kunt de vaardigheden bekijken die in de openbare GitHub-repository worden geïnstalleerd.
Om de vaardighedenbibliotheek in je AI-agent-werkruimte bij te werken, voer je de volgende opdracht uit:
npx skills update
Lees meer over het gebruik van vaardigheden in Claude en ChatGPT.
Toegang tot de HubSpot Agent CLI beheren
Superbeheerders kunnen bepalen wie verbinding mag maken met de HubSpot Agent CLI. Als een gebruiker geen toestemming heeft om verbinding te maken met de HubSpot Agent CLI, moet hij of zij eerst goedkeuring vragen aan een superbeheerder voordat verbinding kan worden gemaakt.
Lees meer over het beheren van welke apps in je HubSpot-account kunnen worden geïnstalleerd.
Gerelateerde documentatie
