- Kunnskapsdatabase
- Konto og oppsett
- Integrasjoner
- Bruk HubSpot Agent CLI
Bruk HubSpot Agent CLI
Sist oppdatert: 29 september 2026
Tilgjengelig med et av følgende abonnementer, unntatt der det er angitt:
HubSpot Agent CLI kobler AI-kodingsagenter, for eksempel de i ChatGPT-appen, Claude-appen og Claude Code, til HubSpot-kontoen din. Når du har koblet Agent CLI til HubSpot, kan du be en AI-agent om å utføre repetitive CRM-oppgaver, analysere data, generere sammendrag og hjelpe til med å administrere prosesser på tvers av kontoen din. Når du delegerer oppgaver til AI-agenter, kan de bruke Agent CLI til å automatisere rutinearbeid på dine vegne, slik at teamet ditt kan bruke mer tid på strategiske tiltak.
I stedet for å gjennomgå poster manuelt hver uke, kan du for eksempel be en AI-agent om å identifisere ufullstendige poster, oppsummere aktiviteten i salgspipeline eller forberede konto gjennomganger ved hjelp av informasjon fra HubSpot.
Hvis du er en utvikler som ønsker å skrive tilpassede skript eller bruke HubSpot Agent CLI manuelt i terminalen din, kan du se HubSpots utviklerdokumentasjon.
Før du begynner
Før du begynner å bruke HubSpot Agent CLI, må du sørge for at du har tilgang til en AI-kodingagent. Agenter som støttes inkluderer de i ChatGPT-appen, Claude-appen,Claude Code og mange andre kompatible AI-kodingagenter.
Merk: Hvis du bruker Claude Cowork i en Team- eller Enterprise-konto, må administratoren i organisasjonen din kanskje legge til api.hubapi.com på tillatelseslisten før CLI-en kan installeres eller kjøres. Les mer om å legge til på tillatelseslisten i Claude Cowork.
Når skal du bruke HubSpot Agent CLI
Agent CLI er nyttig for repeterende eller tilbakevendende driftsoppgaver som krever gjennomgang av store mengder CRM-data. Dette inkluderer oppgaver som å gjennomføre en ukentlig gjennomgang av salgsrørledningen, masseoppdatere poster eller sende planlagte sammendrag til teamet ditt etter et månedlig møte. Se flere eksempler på bruksscenarier.
Hvis du ønsker å stille engangsspørsmål eller utarbeide innhold ved hjelp av HubSpot-dataene dine, er HubSpot-koblingen for Claude eller HubSpot-koblingen for ChatGPT alternativer som ikke krever installasjon av CLI.
Hva AI-agenter har tilgang til med HubSpot Agent CLI
HubSpot Agent CLI kan utføre handlinger ved hjelp av tillatelsene til den tilkoblede HubSpot-brukeren. Avhengig av brukertillatelsene dine kan dette omfatte oppretting, oppdatering eller sletting av poster i kontoen din.
Etter at HubSpot Agent CLI er koblet til, kan AI-agenter arbeide med informasjon i hele HubSpot-kontoen din, inkludert:
- Kontakter, selskaper, avtaler, saker, tilpassede objekter og andre CRM-poster.
- Arbeidsflyter.
- Pipelines og pipeline-trinn.
- Egenskaper og tilpassede egenskaper.
- Inntektsposter (skrivebeskyttet): kontrakter, fakturaer, ordrer, betalinger, tilbud, tilbudsmaler og abonnementer (BETA).
- Koblinger mellom poster.
- Aktivitetslogg.
Merk: Gå alltid gjennom AI-genererte anbefalinger og foreslåtte handlinger før du gjennomfører endringer i CRM-dataene dine.
Anbefalte fremgangsmåter
Når du arbeider med AI-agenter som er koblet til HubSpot:
- Begynn med rapportering, sammendrag og analyseoppgaver før du bruker handlinger som endrer data.
- Når du setter opp planlagte eller gjentakende oppgaver, bør du starte med et enkelt, avgrenset bruksområde før du utvider til bredere automatisering.
- Gjennomgå genererte anbefalinger og omfattende oppdateringer før du implementerer endringene.
- Noen handlinger kan slette eller overskrive HubSpot-data. Bruk alternativet --dry-runder det er tilgjengelig for å forhåndsvise endringene før du implementerer dem.
- Bruk klare, spesifikke instruksjoner som beskriver det ønskede resultatet.
- Følg organisasjonens retningslinjer for datastyring og sikkerhet.
Koble til HubSpot Agent CLI
Følg trinnene nedenfor for å be agenten din om å installere HubSpot Agent CLI. Hvis du er utvikler, kan du lese mer om hvordan du installerer HubSpot Agent CLI manuelt.
- Åpne AI-agenten din.
- Lim inn følgende kommando i agentens arbeidsområde for å installere Agent CLI.
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.
- Når du blir bedt om det, logger du på HubSpot-kontoen din.
- Gå gjennom de forespurte tillatelsene.
- Klikk på «Koble til app».
Når autentiseringen er fullført, kan AI-agenten få tilgang til HubSpot-data basert på dine tillatelser.
Eksempler på bruksområder
Følgende eksempler viser hvordan ulike team kan bruke AI-agenter koblet til via HubSpot Agent CLI.
Markedsføringsteam
| Oppgave | Eksempel på oppgave til AI-agenten |
| Identifiser kontakter som trenger oppfølging eller datarensing. | Hver mandag kl. 08.00 skal du finne kontakter som passer godt, men som ikke har noen tilknyttet avtale, ingen nylig salgsaktivitet eller mangler viktige utfyllingsfelt, og deretter sende RevOps en prioritert ryddeliste med forslag til neste tiltak. |
| Gjennomgå e-postkampanjer for emnelinjer og CTA-er som ikke er i tråd med retningslinjene for merkevarestemmen. | Gjennomgå mine siste 10 e-postkampanjer og merk emnelinjer eller CTA-er som ikke følger retningslinjene for merkevarestemmen vår. Oppgi hvert problem med kampanjenavnet, den merkede teksten og et forslag til endring. |
| Identifiser meldingsmønstre på landingssider med høy ytelse som korrelerer med høyere konverteringsrater. | Analyser mine best ytende landingssider etter konverteringsrate. Identifiser vanlige mønstre i budskapene, for eksempel overskriftsstruktur, formulering av CTA-er eller tilbudstype, og oppsummer hva de har til felles. |
| Lag en liste over kontakter som ikke har åpnet e-poster i en oppfølgingssekvens, med sikte på å gjenoppta kontakten. | Finn alle kontakter som for øyeblikket er registrert i en oppfølgingssekvens, men som ikke har åpnet noen e-poster de siste 30 dagene. Opprett et segment med navn, selskap, livssyklusstadie og dato for siste aktivitet. |
| Spor den nåværende pipelinestatusen for avtaler som stammer fra en webinar-kampanje. | Finn alle avtaler med webinar som leadkilde, og vis deres nåværende pipeline-fase, eier, beløp og dato for siste aktivitet. Oppsummer hvor mange som er aktive, på vent eller avsluttet. |
| Identifiser mønstre når det gjelder bransje, bedriftsstørrelse og leadkilde blant de mest passende kundene. | Se på mine avsluttede og vunne avtaler fra de siste 12 månedene og oppsummer de vanligste kombinasjonene av bransje, bedriftsstørrelse og leadkilde. Fremhev eventuelle mønstre som kan bidra til å finjustere vår ideelle kundeprofil. |
| Overvåk aktive sekvenser og merk av betydelige nedganger i åpningsratene for e-post. | Sjekk alle aktive sekvenser og sammenlign åpningsratene fra de siste to ukene med de to foregående ukene. Marker eventuelle sekvenser der åpningsratene har falt med mer enn 20 %, og oppgi sekvensnavnet, gjeldende rate og forrige rate. |
Salgs- og inntektsdriftsteam
| Oppgave | Eksempel på instruksjon til AI-agenten |
| Overvåk tilstanden i salgspipelineen og identifiser avtaler som trenger oppmerksomhet. | Hver morgen kl. 07.00 skal du sjekke pipelinen min for avtaler som skal avsluttes denne uken, men som ikke har hatt aktivitet de siste 5 dagene, og sende meg en oppsummering. |
| Finn inaktive avtaler med høy verdi som krever oppfølging og gjennomgang. | Finn alle åpne avtaler over $[beløp] uten aktivitet de siste 14 dagene. Sorter etter avtalens verdi og inkluder avtalens navn, eier, avslutningsdato og siste aktivitet. |
| Forbered et kundemøte ved å oppsummere historikken for avtalen, support, e-post og notater. | Jeg har et møte med [Selskap] i morgen. Oppsummer deres åpne og nylig avsluttede avtaler, de siste 5 supportbillettene, nylig e-postaktivitet og eventuelle notater som er loggført de siste 60 dagene. |
| Analyser avtaler som har gått glipp for å identifisere de fasene i salgspipelineen der mulighetene sto stille lengst. | Se på avtaler som gikk over avslutningsdatoen i forrige kvartal. Vis for hver av dem hvilket trinn i salgspipeline de brukte mest tid på, og identifiser de to eller tre trinnene der avtalene oftest går i stå. |
| Lag en daglig oversikt over avtaler som nærmer seg avslutningsdato, men som mangler nylig aktivitet. | Hver dag kl. 08.00 skal du finne avtaler som skal avsluttes innen de neste 7 dagene, men som ikke har hatt aktivitet de siste 3 dagene. Send meg en oversikt med avtalens navn, ansvarlig, beløp, avslutningsdato og type siste aktivitet. |
Salgsledere
| Oppgave | Eksempel på instruksjon til AI-agenten |
| Analyser samtaletranskripsjoner for temaer knyttet til coaching og produktfeedback. | Analyser nylige samtaletranskripsjoner for samtaletid, omtale av konkurrenter, tilbakemeldinger fra kunder og temaer knyttet til potensielle kunders nøling, og lag deretter et dashbord for coaching og produktfeedback med eksempler på transkripsjoner og lenker til kildesamtalene. |
| Identifiser selgere eller team med uvanlig høye eller lave samtaletidsmønstre. | Analyser samtaletranskripsjoner fra de siste 30 dagene og beregne gjennomsnittlig samtaletidsandel per selger. Merk alle med en andel over 70 % eller under 30 %, og inkluder et utdrag fra en transkripsjon for hver enkelt. |
| Finn gjentatte omtaler av konkurrenter i nylige salgssamtaler. | Gå gjennom samtaletranskripsjoner fra de siste 60 dagene og identifiser de konkurrentene som nevnes oftest. For hver av dem skal du vise hvor mange samtaler som inneholdt en omtale, i hvilke faser av avtalen de dukket opp, samt et sitat som eksempel. |
| Oppsummer temaer knyttet til potensielle kunders nøling etter segment, salgsfase eller produktområde. | Gå gjennom nylige samtaletranskripsjoner for å finne språk som indikerer nøling eller innvendinger hos potensielle kunder. Grupper temaene etter forhandlingsfase og kundesegment, og oppsummer de fem vanligste nølingsmønstrene med eksempler på sitater. |
| Plukk ut eksempler fra transkripsjonene som støtter temaer knyttet til coaching eller produktfeedback. | Fra samtaletranskripsjoner fra de siste 30 dagene skal du finne tre til fem eksempler på gode utforskende spørsmål og tre til fem eksempler på tapte muligheter for å håndtere innvendinger. Ta med navnet på selgeren, datoen for samtalen og et direkte sitat fra hver av dem. |
| Lag et dashbord som knytter innsikter fra samtalene tilbake til kildeoppføringene og transkripsjonene. | Lag et coaching-dashboard som oppsummerer samtaletidsforhold, omtaler av konkurrenter og innvendingstemaer fra samtaler de siste 30 dagene. For hver innsikt skal du inkludere en lenke til kildesamtalen og den tilhørende avtaleposten. |
RevOps- og CRM-administratorer
| Oppgave | Eksempel på instruksjon til AI-agenten |
| Rydd opp i CRM-egenskaper uten å ødelegge nedstrømsressurser. | Finn dupliserte eller utdaterte CRM-egenskaper, og vis hvor de brukes i arbeidsflyter, rapporter og visninger. Forhåndsvis deretter en ryddeplan for å erstatte, fjerne eller omorganisere felt før endringene tas i bruk. |
| Identifiser dupliserte egenskaper som samler inn den samme informasjonen på tvers av ulike objekter. | Gjennomgå alle egenskaper for kontakter, selskaper og avtaler, og merk de som ser ut til å samle inn samme informasjon under forskjellige navn. Oppgi egenskapsnavnene, objektene de tilhører og en foreslått handling for hvert duplikatpar. |
| Finn utdaterte felt som fremdeles vises i arbeidsflyter, rapporter, visninger eller oppsett for poster. | Finn alle CRM-egenskaper som ikke har blitt oppdatert de siste 12 månedene, men som fremdeles vises i aktive arbeidsflyter, lagrede rapporter, listevisninger eller oppsett for postkort. Vis hvor hver enkelt brukes før endringer gjøres. |
| Få en forhåndsvisning av konsekvensene av å fjerne eller erstatte en CRM-egenskap før du foretar endringer. | Jeg vil fjerne egenskapen [Egenskapsnavn]. Før endringer gjøres, vis meg alle arbeidsflyter, rapporter, lister og oppsett for poster som bruker den, og gi meg en forhåndsvisning av hva som vil slutte å fungere eller må oppdateres. |
| Omorganiser feltene i postene slik at administratorer og selgere ser den viktigste informasjonen først. | For kontaktpostoppsettet skal disse feltene flyttes til toppen av egenskapssidefeltet: [Felt 1], [Felt 2], [Felt 3]. Forhåndsvis før endringene tas i bruk. |
| Generer en oppryddingsoversikt som viser hva som er endret og hva som fortsatt må gjennomgås. | Når du har fullført oppryddingen av CRM-egenskapene, generer en oversikt over alle egenskaper som ble fjernet, erstattet eller omdøpt, hvilke ressurser som ble oppdatert, samt en liste over eventuelle felt som fortsatt må gjennomgås manuelt. |
Driftsteam
| Oppgave | Eksempel på instruksjon til AI-agenten |
| Konsolider relaterte supportbilletter og bevar ryddehistorikken. | Konsolider dupliserte supportbilletter, bevar detaljene fra kildebilletten, videresend hver overordnet billett til riktig trinn i behandlingsprosessen, og send teamet en oppryddingsoversikt med eventuelle poster som fortsatt må gjennomgås. |
| Finn dupliserte eller relaterte supportbilletter knyttet til samme kunde eller problemtype. | Finn alle åpne supportbilletter fra samme selskap som ble opprettet innen 30 dager av hverandre. Grupper dem etter selskap og problemtype, og merk de som ser ut til å være duplikater. |
| Slå sammen saksinformasjonen i en overordnet post, samtidig som du bevarer opplysningene fra kilden. | For de dupliserte sakene som er identifisert ovenfor, slå sammen beskrivelsen, kontakthistorikken og notatene fra hver kildesak inn i notatene til den overordnede saken før du lukker duplikatene. |
| Videresend de konsoliderte sakene til riktig trinn i behandlingsprosessen basert på gjeldende status. | For hver konsolidert overordnet sak må du sjekke den gjeldende statusen og flytte den til riktig trinn i behandlingsprosessen: åpne saker til «Pågår», saker som venter på svar til «Venter på kunde» og løste saker til «Lukket». |
| Merk saker som må gjennomgås manuelt før sammenslåing. | Før du konsoliderer noen saker, må du merke oppføringer som har en åpen betalingskonflikt, en aktiv SLA-tidsklokke eller en merknad merket som eskalering. Ikke slå disse sammen. Oppgi dem i stedet for manuell gjennomgang. |
| Send en oppsummering av oppryddingen med sammenslåtte saker, åpne spørsmål og ansvarlige for oppfølging. | Når sammenslåingen av saker er fullført, send lederen for supportteamet en oversikt som viser alle opprettede overordnede saker, hvilke kildesaker som ble slått sammen med dem, eventuelle åpne spørsmål som krever oppfølging, og hvem som har ansvaret for hvert neste trinn. |
Supportteam
| Oppgave | Eksempel på instruksjon til AI-agenten |
| Gjennomgå kundehistorikken uten å åpne flere poster manuelt. | Hent de siste 5 sakene fra denne kontakten, oppsummer hver løsning og merk eventuelle mønstre av gjentakende problemer. |
| Gjennomgå den siste ticket-historikken og identifiser gjentakende kundeproblemer før du oppretter en ny sak. | Før jeg oppretter en ny sak for [Kontakt], hent de 10 siste sakene deres, oppsummer hver løsning og merk eventuelle problemer som dukker opp mer enn én gang. Inkluder sakens emne, status og løsningsdato. |
| Prioriter saker som har overskredet forventet responstid. | Finn alle åpne saker som ikke har mottatt svar innenfor det forventede SLA-vinduet. Sorter dem etter hvor lenge de har vært forfalte, og inkluder sakseier, kontaktnavn og dato for siste aktivitet. |
| Analyser saker knyttet til fakturering for å identifisere de vanligste årsakene til at kunder kontakter kundestøtte. | Gå gjennom alle saker merket med en faktureringsrelatert kategori fra de siste 90 dagene. Oppsummer de fem viktigste årsakene til at kundene kontaktet kundestøtte, rangert etter antall, og inkluder gjennomsnittlig tid til løsning for hver av dem. |
| Forbered svar på henvendelsene med relevant avtale-, abonnements- og eskaleringshistorikk. | For saken [Sak-ID] skal du hente frem kontaktens tilknyttede avtalehistorikk, gjeldende abonnementsdetaljer og eventuelle tidligere eskaleringsnotater. Oppsummer konteksten og utarbeid et svar som løser kundens problem. |
Kundesuksess-team
| Oppgave | Eksempel på instruksjon til AI-agenten |
| Utarbeid kontogjennomganger ved hjelp av informasjon fra flere HubSpot-verktøy. | For min kontogjennomgang denne uken, oppsummer åpne avtaler, nylig supportaktivitet og siste NPS-score for hver konto i porteføljen min. |
| Identifiser kundekontoer med indikatorer på økt risiko for kundefrafall. | Gjennomgå kundene i porteføljen min og merk de som har to eller flere av følgende signaler: synkende innloggingsfrekvens for produktet, åpne supportbilletter som er eldre enn 14 dager, en NPS-score under 7 eller ingen CSM-aktivitet de siste 30 dagene. Rangér dem etter risikonivå. |
| Finn fornyelseskontakter med lavt produktengasjement for proaktiv oppfølging. | Finn alle kontakter hos kunder som skal fornye avtalen i løpet av de neste 60 dagene, og som ikke har logget seg inn på produktet de siste 21 dagene. Lag en prioritert kontaktliste med kontaktnavn, kunde, fornyelsesdato og siste innloggingsdato. |
| Forbered kundegjennomganger ved å oppsummere nylig aktivitet innen salg, support og tilbakemeldinger fra kunder. | For [Kundekonto], oppsummer all avtaleaktivitet fra de siste 6 månedene, åpne og nylig lukkede supportbilletter, samt eventuelle NPS- eller CSAT-svar. Formater dette som en forhåndsrapport til kvartalsgjennomgangen (QBR) som jeg kan dele med kundeteamet. |
| Identifiser utvidelsesmuligheter ved å sammenligne veksttrender for kontoen med historisk avtalestørrelse. | Se på kundene i porteføljen min som har økt antall ansatte eller omsetningen det siste året. Sammenlign deres nåværende avtalestørrelse med hva lignende kunder har vokst til, og merk de 10 beste som potensielle utvidelsesmuligheter. |
Hold ferdighetsbiblioteket oppdatert
HubSpot Agent CLI Skills gir forhåndsdefinerte veiledninger som hjelper AI-agenter med å arbeide med HubSpot-data og vanlige HubSpot-prosesser. Ferdighetsbiblioteket inneholder veiledninger for CRM-søk, masseoperasjoner, datakvalitetsoppgaver, arbeidsflyter, rapportering og andre driftsaktiviteter.
Du kan se gjennom ferdighetene som skal installeres i det offentlige GitHub-arkivet.
For å oppdatere ferdighetsbiblioteket i arbeidsområdet for AI-agenten din, kjør følgende kommando:
npx skills update
Les mer om hvordan du bruker ferdigheter i Claude og ChatGPT.
Administrer tilgang til HubSpot Agent CLI
Superadministratorer kan administrere hvem som har lov til å koble til HubSpot Agent CLI. Hvis en bruker ikke har tillatelse til å koble til HubSpot Agent CLI, må vedkommende be om godkjenning fra en superadministrator før tilkoblingen.
Les mer om hvordan du administrerer hvilke apper som kan installeres i HubSpot-kontoen din.
