BètaGebruik de HubSpot Agent CLI

De HubSpot Agent CLI koppelt AI-codeeragenten, zoals Claude Code, Claude Cowork en OpenAI Codex, aan je HubSpot-account. Nadat u de Agent CLI aan 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, kun je 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 onze documentatie voor ontwikkelaars.

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 Claude Code, Claude Cowork, OpenAI Codex 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.

Waar AI-agents 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.
• Koppelingen tussen records.
• Activiteitengeschiedenis.

Let op: controleer altijd de door AI gegenereerde aanbevelingen en voorgestelde acties voordat u wijzigingen in uw CRM-gegevens doorvoert.

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.
• Controleer gegenereerde aanbevelingen en grootschalige updates voordat u wijzigingen doorvoert.
• Sommige acties kunnen HubSpot-gegevens verwijderen of overschrijven. Gebruik, indien beschikbaar, de optie --dry-run om een voorbeeld van de wijzigingen te bekijken voordat u ze doorvoert.
• Gebruik duidelijke prompts die het gewenste resultaat beschrijven.
• Volg het beleid van je organisatie op het gebied van gegevensbeheer en beveiliging.

Sluit de HubSpot Agent CLI aan

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.

1. Open je AI-agent, zoals Cowork of Codex.
2. 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.

3. Meld je aan bij je HubSpot-account wanneer daarom wordt gevraagd.
4. Controleer de gevraagde machtigingen.
5. Klik op 'App verbinden'.

Zodra de authenticatie is voltooid, heeft de AI-agent toegang tot HubSpot-gegevens op basis van je machtigingen.

Gebruik een van de onderstaande voorbeeldprompts om aan de slag te gaan.

Voorbeelden van gebruikssituaties

De volgende voorbeelden laten zien hoe verschillende teams AI-agenten kunnen gebruiken die via de HubSpot Agent CLI zijn aangesloten. De agent is vooral handig voor terugkerende operationele taken waarbij grote hoeveelheden CRM-gegevens moeten worden doorgenomen.

Marketingteams

Taak: identificeer contacten die opvolging of gegevensopschoning nodig hebben.

Voorbeeldopdracht voor de AI-agent: zoek elke maandag om 8.00 uur contactpersonen die goed aansluiten, maar geen bijbehorende deal hebben, geen recente verkoopactiviteit vertonen of waarbij belangrijke aanvullende velden ontbreken, en stuur vervolgens een geprioriteerde opschoningslijst met voorgestelde vervolgacties naar RevOps.

Andere voorbeelden zijn:

• E-mailcampagnes beoordelen op onderwerpen en CTA’s die niet in overeenstemming zijn met de richtlijnen voor de merkstem.
• Identificeer berichtpatronen op goed presterende landingspagina's die correleren met hogere conversiepercentages.
• Stel een lijst op met contacten die opnieuw moeten worden benaderd omdat ze e-mails in een nurture-reeks niet hebben geopend.
• Volg de huidige pijplijnstatus van deals die afkomstig zijn uit een webinarcampagne.
• Identificeer patronen in branche, bedrijfsgrootte en leadbronnen onder de meest geschikte klanten.
• Houd actieve reeksen in de gaten en markeer significante dalingen in het percentage geopende e-mails.

Verkoop- en omzetteams

Taak: de gezondheid van de pijplijn monitoren en deals identificeren die aandacht nodig hebben.

Voorbeeldopdracht voor de AI-agent: 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 me een overzicht.

Andere voorbeelden zijn:

• Zoek inactieve deals met een hoge waarde die moeten worden opgevolgd en geëvalueerd.
• Bereid een klantgesprek voor door de geschiedenis van de deal, ondersteuning, e-mails en notities samen te vatten.
• Analyseer misgelopen deals om te bepalen in welke fasen van de pijplijn de kansen het langst zijn blijven steken.
• Maak een dagelijks overzicht van deals waarvan de afsluitdatum nadert, maar waar recent geen activiteit is geweest.

Verkoopmanagers

Taak: analyseer gespreksverslagen op thema’s voor coaching en productfeedback.

Voorbeeldopdracht voor de AI-agent: 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.

Andere voorbeelden zijn:

• Identificeer verkopers of teams met ongewoon hoge of lage gespreksduurpatronen.
• Zoek terugkerende vermeldingen van concurrenten in recente verkoopgesprekken.
• Vat thema's met betrekking tot aarzeling bij potentiële klanten samen per segment, dealfase of productgebied.
• Verzamel transcriptievoorbeelden die thema's voor coaching of productfeedback ondersteunen.
• Maak een dashboard dat inzichten uit gesprekken koppelt aan de bronrecords en transcripties.

RevOps- en CRM-beheerders

Taak: CRM-eigenschappen opschonen zonder dat dit gevolgen heeft voor downstream-assets.

Voorbeeldopdracht voor de AI-agent: 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.

Andere voorbeelden zijn:

• Identificeer dubbele eigenschappen die dezelfde informatie verzamelen voor verschillende objecten.
• Zoek verouderde velden die nog steeds voorkomen in workflows, rapporten, weergaven of recordlay-outs.
• Geef een voorbeeldweergave van de gevolgen van het verwijderen of vervangen van een CRM-eigenschap voordat wijzigingen worden doorgevoerd.
• Herschik recordvelden zodat beheerders en vertegenwoordigers de belangrijkste informatie als eerste zien.
• Genereer een overzicht van de opschoning waarin wordt weergegeven wat er is gewijzigd en wat nog moet worden gecontroleerd.

Operationele teams

Taak: gerelateerde supporttickets samenvoegen en de opschoonhistorie behouden.

Voorbeeldopdracht voor de AI-agent: 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.

Andere voorbeelden zijn:

• Zoek dubbele of gerelateerde supporttickets voor dezelfde klant of hetzelfde type probleem.
• Voeg de ticketcontext samen in een bovenliggend record met behoud van de brongegevens.
• Leid samengevoegde tickets naar de juiste pijplijnfase op basis van de huidige status.
• Markeer tickets die vóór het samenvoegen door een medewerker moeten worden gecontroleerd.
• Een overzicht van de opschoning versturen met samengevoegde records, openstaande vragen en verantwoordelijken voor de opvolging.

Supportteams

Taak: de klantgeschiedenis bekijken zonder handmatig meerdere records te openen.

Voorbeeldopdracht voor de AI-agent: Haal de laatste 5 tickets van deze contactpersoon op, vat elke oplossing samen en markeer eventuele terugkerende probleem patronen.

Andere voorbeelden zijn:

• Bekijk de recente ticketgeschiedenis en identificeer terugkerende klantproblemen voordat je een nieuwe case opent.
• Geef prioriteit aan tickets waarbij de verwachte reactietijd is overschreden.
• Analyseer factureringsgerelateerde tickets om de meest voorkomende redenen te identificeren waarom klanten contact opnemen met de ondersteuning.
• Stel reacties op tickets op met relevante informatie over de deal, het abonnement en de escalatiegeschiedenis.

Customer Success-teams

Taak: stel accountbeoordelingen op aan de hand van informatie uit verschillende HubSpot-tools.

Voorbeeldopdracht voor de AI-agent: Maak voor mijn accountbeoordeling van deze week een overzicht van openstaande deals, recente supportactiviteiten en de laatste NPS-score voor elk account in mijn klantenbestand.

Andere voorbeelden zijn:

• Identificeer klantaccounts met indicatoren die wijzen op een verhoogd risico op klantverloop.
• Zoek contactpersonen voor verlengingen met een lage productbetrokkenheid voor proactieve benadering.
• Stel accountbeoordelingen op door een overzicht te geven van recente activiteiten op het gebied van verkoop, ondersteuning en klantfeedback.
• Identificeer uitbreidingsmogelijkheden door de groeitrends van accounts te vergelijken met de historische omvang van deals.

Houd de vaardighedenbibliotheek up-to-date

HubSpot Agent CLI-vaardigheden bieden vooraf gedefinieerde richtlijnen die AI-agenten helpen bij het werken met HubSpot-gegevens en gangbare 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.

Voer de volgende prompt uit om de vaardighedenbibliotheek in je AI-agent-werkruimte bij te werken:

npx skills update

Lees meer over het gebruik van vaardigheden in Claude en in OpenAI Codex.

Beheer de toegang tot de HubSpot Agent CLI

Superbeheerders kunnen bepalen wie de HubSpot Agent CLI mag koppelen door zich aan te melden voor de bètaversie van App Install Governance.

Als een gebruiker geen toestemming heeft om de HubSpot Agent CLI te koppelen, moet hij of zij goedkeuring vragen aan een beheerder voordat de koppeling tot stand kan worden gebracht.

Lees meer over het beheren van welke apps in je HubSpot-account kunnen worden geïnstalleerd.