BetaDas Agent-CLI von HubSpot verwenden

Das HubSpot Agent-CLI verbindet KI-Coding-Agents wie Claude Code, Claude Cowork und OpenAI Codex mit Ihrem HubSpot-Account. Nachdem Sie das Agent-CLI mit HubSpot verknüpft haben, können Sie einen KI-Agent bitten, sich wiederholende CRM-System-Aufgaben zu erledigen, Daten zu analysieren, Zusammenfassungen zu generieren und bei der Verwaltung von Prozessen in Ihrem Account zu helfen. Wenn Sie Aufgaben an KI-Agents delegieren, können diese über das Agent-CLI Routinearbeiten für Sie automatisieren und Ihrem Team so helfen, mehr Zeit für strategische Initiativen zu haben.

Anstatt die Datensätze jede Woche manuell zu überprüfen, können Sie beispielsweise einen KI-Agent bitten, unvollständige Datensätze zu identifizieren, Pipeline Aktivität zusammenzufassen oder Account-Reviews mit Informationen aus HubSpot vorzubereiten.

Wenn Sie als Entwickler benutzerdefinierte Skripts schreiben möchten oder das HubSpot Agent CLI manuell in Ihrem Terminal verwenden, lesen Sie unsere Entwicklerdokumentation.

Bevor Sie loslegen

Bevor Sie mit der Verwendung des HubSpot Agent CLI beginnen, stellen Sie sicher, dass Sie Zugriff auf einen KI-Coding-Agent haben. Zu den unterstützten Agents gehören Claude Code, Claude Cowork, OpenAI Codex und viele andere kompatible KI-Codierungs-Agents.

Bitte beachten: Wenn Sie Claude Cowork in einem Team- oder Enterprise-Account verwenden, muss der Administrator Ihres Unternehmens api.hubapi.com möglicherweise auf die Zulassungsliste setzen, bevor das CLI installiert oder ausgeführt werden kann. Erfahren Sie mehr über das Hinzufügen von Listen in Claude Cowork.

Auf welche KI-Agents kann das HubSpot Agent-CLI zugreifen?

Das HubSpot Agent CLI kann Aktionen mit den Berechtigungen des verknüpften HubSpot-Benutzers ausführen. Abhängig von Ihren Benutzerberechtigungen kann dies das Erstellen, Aktualisieren oder Löschen von Datensätzen in Ihrem Account umfassen.

Nach dem Verknüpfen des HubSpot Agent-CLI können KI-Agents mit Informationen aus Ihrem HubSpot-Account arbeiten, einschließlich:

• Kontakte, Unternehmen, Deals, Tickets, benutzerdefinierte Objekte und andere Datensätze im CRM-System.
• Workflows.
• Pipelines und Pipeline-Phasen.
• Eigenschaften und benutzerdefinierte Eigenschaften.
• Zuordnungen zwischen Datensätzen.
• Verlauf der Aktivitäten.

Bitte beachten: Überprüfen Sie immer KI-generierte Empfehlungen und vorgeschlagene Maßnahmen, bevor Sie Änderungen an Ihren CRM-System-Daten vornehmen.

Best Practices

Bei der Arbeit mit KI-KI-Agents, die mit HubSpot verbunden sind:

• Beginnen Sie mit Berichts-, Zusammenfassungs- und Analyseaufgaben, bevor Sie zu Aktionen zur Änderung von Daten greifen.
• Überprüfen Sie die generierten Empfehlungen und groß angelegten Updates, bevor Sie Änderungen übernehmen.
• Einige Aktionen können HubSpot-Daten löschen oder überschreiben. Verwenden Sie, sofern verfügbar, die Option --dryrun, um eine Vorschau der Änderungen anzuzeigen, bevor Sie sie anwenden.
• Verwenden Sie klare Prompts, die das gewünschte Ergebnis beschreiben.
• Befolgen Sie die Datenkontroll- und Sicherheitsrichtlinien Ihres Unternehmens.

Das HubSpot Agent CLI verknüpfen

Führen Sie die folgenden Schritte aus, um Ihren Agent anzuweisen, das HubSpot Agent CLI zu installieren. Wenn Sie ein Entwickler sind, erfahren Sie hier mehr über die manuelle Installation des HubSpot Agent CLI.

1. Öffnen Sie Ihren KI-Agent, z. B. Cowork oder Codex.
2. Fügen Sie die folgenden Prompt in Ihren Agent-Workspace ein, um das Agent-CLI zu installieren.

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. Melden Sie sich bei Ihrem HubSpot-Account an, wenn Sie dazu aufgefordert werden.
4. Überprüfen Sie die angeforderten Berechtigungen.
5. Klicken Sie auf „App verknüpfen“.

Nach Abschluss der Authentifizierung kann der KI-Agent auf der Grundlage Ihrer Berechtigungen auf HubSpot-Daten zugreifen.

Verwenden Sie einen der folgenden Beispiel-Prompts, um loszulegen.

Beispiele für Anwendungsfälle

Die folgenden Beispiele zeigen, wie verschiedene Teams KI-Agents nutzen können, wenn sie über das Agent-CLI von HubSpot verknüpft sind. Der Agent ist besonders nützlich bei wiederkehrenden operativen Arbeiten, bei denen große Mengen an CRM-System-Daten überprüft werden müssen.

Marketing-Teams

Aufgabe: Kontakte identifizieren, die ein Follow-up oder eine Datenbereinigung benötigen.

Beispiel-Prompt für den KI-Agent: Suchen Sie jeden Montag um 8 Uhr morgens nach besonders passenden Kontakten ohne zugeordneten Deal, ohne aktuelle Vertriebs Aktivität oder ohne wichtige Anreicherungsfelder, und senden Sie RevOps dann eine priorisierte Bereinigungsliste mit Vorschlägen für die nächsten Aktionen.

Weitere Beispiele sind:

• E-Mail-Kampagnen auf Betreffzeilen und CTAs überprüfen, die nicht mit den Richtlinien der Markensprache übereinstimmen
• Identifizieren Messaging Muster auf leistungsstarken Landingpages, die mit höheren Conversion Raten korrelieren.
• Erstellen Sie eine Liste mit Kontakten, die keine E-Mails in einer Nurturing-Sequenz geöffnet haben, für erneute Interaktionen.
• Verfolgen Sie den aktuellen Pipeline-Status von Deals nach, die aus einer Webinar-Kampagne stammen.
• Identifizieren Sie Branche, Unternehmensgröße und Leadquellenmuster bei den am besten geeigneten Kundinnen und Kunden.
• Überwachen Sie aktive Sequenzen und erkennen Sie einen signifikanten Rückgang der E-Mail-Öffnungsraten.

Vertriebs- und Revenue-Operations-Teams

Aufgabe: Überwachen Sie den Zustand der Pipeline und identifizieren Sie Deals, die Aufmerksamkeit erfordern.

Beispiel-Prompt für den KI-Agent: Überprüfe jeden Morgen um 7 Uhr meine Pipeline auf Deals, die diese Woche abgeschlossen wurden und in denen es in den letzten 5 Tagen keine Aktivität gab, und sende mir eine Zusammenfassung.

Weitere Beispiele sind:

• Finden Sie inaktive, hochwertige Deals, die ein Follow-up und eine Überprüfung erfordern.
• Bereiten Sie sich auf ein Kundenmeeting vor, indem Sie den Verlauf von Deals, Supportseiten, E-Mails und Notizen zusammenfassen.
• Analysieren Sie fehlerhafte Deals, um die Pipeline-Phasen zu identifizieren, in denen Opportunitys am längsten ins Stocken geraten sind.
• Erstellen Sie eine tägliche Zusammenfassung von Deals, die sich dem Abschlussdatum nähern, jedoch keine kürzlichen Aktivitäten aufweisen.

Führungskräfte im Vertrieb

Aufgabe: Analysieren Sie Anruftranskripte auf Coaching- und Produktfeedbackthemen.

Beispiel-Prompt für den KI-Agent: Analysieren Sie die letzten Anruftranskripte auf Gesprächszeiten, Erwähnungen von Wettbewerbern, Kundenfeedback und Themen zum Zögern von Interessenten und erstellen Sie dann ein Dashboard für Coaching und Produktfeedback mit Transkriptbeispielen und Links zu den Anrufquellen.

Weitere Beispiele sind:

• Identifizieren Sie Vertriebsmitarbeiter oder Teams mit ungewöhnlich hohen oder niedrigen Sprechzeitmustern.
• Finden Sie wiederkehrende Erwähnungen von Wettbewerbern in letzten Verkaufsgesprächen.
• Fassen Sie Themen bei Bedenken von potenziellen Kunden nach Segment, Dealphase oder Produkt Fläche zusammen.
• Ziehen Sie Transkriptionsbeispiele, die Coaching- oder Produktfeedback-Themen unterstützen.
• Erstellen Sie ein Dashboard, das Erkenntnisse aus Anrufen mit den Quelldatensätzen und Transkripten verknüpft.

RevOps- und CRM-System-Admins

Aufgabe: Bereinigen Sie CRM-System-Eigenschaften, ohne nachgelagerte Ressourcen zu beschädigen.

Beispiel-Prompt für den KI-Agent: Suchen Sie nach doppelten oder veralteten CRM-System-Eigenschaften und zeigen Sie an, wo sie in Workflows, Berichten und Ansichten verwendet werden. Zeigen Sie dann eine Vorschau eines BereinigungsAbonnement an, um Felder zu ersetzen, zu entfernen oder neu anzuordnen, bevor Sie Änderungen übernehmen.

Weitere Beispiele sind:

• Identifizieren Sie doppelte Eigenschaften, die dieselben Informationen über verschiedene Objekte hinweg sammeln.
• Suchen Sie veraltete Felder, die weiterhin in Workflows, Berichten, Ansichten oder Datensatzlayouts angezeigt werden.
• Zeigen Sie eine Vorschau der Auswirkungen des Entfernens oder Ersetzens eines CRM-System Eigenschaft an, bevor Sie Änderungen vornehmen.
• Ordnen Sie Datensatzfelder neu an, damit Administratoren und Vertriebsmitarbeiter die wichtigsten Informationen zuerst sehen.
• Generieren Sie eine Zusammenfassung der Bereinigung, die zeigt, was sich geändert hat und was noch überprüft werden muss.

Operations-Teams

Aufgabe: Konsolidieren Sie zugehörige Supporttickets und bewahren Sie den Bereinigungsverlauf auf.

Beispiel-Prompt für den KI-Agent: Konsolidieren Sie doppelte Supporttickets, behalten Sie die Quell-Ticket-Details bei, leiten Sie jedes übergeordnete Ticket an die richtige Pipeline-Phase weiter und senden Sie dem Team eine Zusammenfassung der Bereinigung mit allen Datensätzen, die noch überprüft werden müssen.

Weitere Beispiele sind:

• Suchen Sie nach doppelten oder verwandten Supporttickets für denselben Kunden oder Problemtyp.
• Zusammenführen des Ticket-Kontexts in einen übergeordneten Datensatz unter Beibehaltung der Quellendetails.
• Leiten Sie konsolidierte Tickets basierend auf dem aktuellen Status an die richtige Pipeline-Phase weiter.
• Markieren Sie Tickets, die vor der Zusammenführung von einem Mitarbeiter überprüft werden müssen.
• Senden Sie eine Zusammenfassung der Bereinigung mit zusammengeführten Datensätzen, offenen Fragen und Follow-up-Mitarbeitern.

Support-Teams

Aufgabe: Überprüfen Sie den Kundenverlauf, ohne mehrere Datensätze manuell öffnen zu müssen.

Beispiel-Prompt für den KI-Agent: Rufen Sie die letzten 5 Tickets von diesem Kontakt ab, fassen Sie jede Lösung zusammen und kennzeichnen Sie alle wiederkehrenden Problemmuster.

Weitere Beispiele sind:

• Überprüfen Sie den Verlauf der letzten Tickets und identifizieren Sie wiederkehrende Kundenprobleme, bevor Sie einen neuen Kundenvorgang eröffnen.
• Priorisieren Sie Tickets, die die Erwartungen an die Antwortzeit übertroffen haben.
• Analysieren Sie abrechnungsbezogene Tickets, um die häufigsten Gründe zu identifizieren, warum Kunden den Support kontaktieren.
• Bereiten Sie Ticket-Antworten mit relevantem Deal-, Abonnement- und Eskalationsverlauf vor.

Customer Success-Teams

Aufgabe: Bereiten Sie Account-Überprüfungen anhand von Informationen aus mehreren HubSpot-Tools vor.

Beispiel-Prompt für den KI-Agent: Für meine Account-Überprüfung diese Woche fasse ich die offenen Deals, die letzten Support-Aktivitäten und den letzten NPS-Score für jeden Account in meinem Kundenbuch zusammen.

Weitere Beispiele sind:

• Identifizieren Sie Kundenaccounts, die Indikatoren für ein erhöhtes Abwanderungsrisiko aufweisen.
• Suchen Sie nach Kontakten für Verlängerungen mit geringer Produkt-Interaktion für proaktive Kontaktaufnahme.
• Bereiten Sie Account-Reviews vor, indem Sie die jüngsten Vertriebs-, Support- und Kundenfeedback-Aktivitäten zusammenfassen.
• Identifizieren Sie Expansionsmöglichkeiten, indem Sie Trends beim Accountwachstum mit dem historischen Dealvolumen vergleichen.

Halten Sie die Kompetenzbibliothek auf dem neuesten Stand

Die HubSpot Agent CLI Skills bieten vordefinierte Anleitungen, die KI-Agents dabei unterstützen, mit HubSpot-Daten und gängigen HubSpot-Prozessen zu arbeiten. Die Kompetenzbibliothek enthält Anleitungen für CRM-Suchen, Massenvorgänge, Aufgaben zur Datenqualität, Workflows, Berichterstellung und andere operative Aktivitäten.

Sie können die Skills, die installiert werden, im öffentlichen GitHub-Repository überprüfen.

Um die Kompetenzbibliothek in Ihrem KI-Agent-Workspace zu aktualisieren, führen Sie die folgenden Prompt aus:

npx skills update

Erfahren Sie mehr über die Verwendung von Kompetenzen in Claude und in OpenAI Codex.

Zugriff auf das HubSpot Agent CLI verwalten

Super-Admins können verwalten, wer das HubSpot Agent CLI verknüpfen darf, indem sie sich für die Beta der App Install Governance anmelden.

Wenn ein Benutzer nicht über die Berechtigung zum Verknüpfen des HubSpot Agent CLI verfügt, muss er vor dem Verknüpfen die Genehmigung eines Administrators einholen.

Erfahren Sie mehr über das Verwalten, welche Apps in Ihrem HubSpot-Account installiert werden können.