Wersja betaSkorzystaj z interfejsu CLI HubSpot Agent

Interfejs CLI HubSpot Agent łączy agenty programistyczne oparte na sztucznej inteligencji, takie jak Claude Code, Claude Cowork i OpenAI Codex, z Twoim kontem HubSpot. Po połączeniu Agent CLI z HubSpot możesz poprosić agenta AI o wykonywanie powtarzalnych zadań CRM, analizowanie danych, generowanie podsumowań oraz pomoc w zarządzaniu procesami na całym koncie. Gdy zlecisz zadania agentom AI, mogą oni wykorzystać Agent CLI do automatyzacji rutynowych czynności w Twoim imieniu, pomagając Twojemu zespołowi poświęcić więcej czasu na inicjatywy strategiczne.

Na przykład zamiast ręcznie przeglądać rekordy co tydzień, możesz poprosić agenta AI o zidentyfikowanie niekompletnych rekordów, podsumowanie aktywności w lejku sprzedaży lub przygotowanie przeglądów kont na podstawie informacji z HubSpot.

Jeśli jesteś programistą i chcesz pisać własne skrypty lub ręcznie korzystać z interfejsu Agent CLI HubSpot w terminalu, zapoznaj się z naszą dokumentacją dla programistów.

Zanim zaczniesz

Zanim zaczniesz korzystać z interfejsu CLI agenta HubSpot, upewnij się, że masz dostęp do agenta AI do kodowania. Obsługiwani agenci to między innymi Claude Code, Claude Cowork, OpenAI Codex oraz wielu innych kompatybilnych agentów AI do kodowania.

Uwaga: jeśli korzystasz z Claude Cowork na koncie typu Team lub Enterprise, administrator Twojej organizacji może być zmuszony do dodania adresu api.hubapi.com do listy dozwolonych, zanim CLI będzie mogło zostać zainstalowane lub uruchomione. Dowiedz się więcej o dodawaniu adresów do listy dozwolonych w Claude Cowork.

Do czego agenci AI mają dostęp dzięki HubSpot Agent CLI

HubSpot Agent CLI może wykonywać działania, korzystając z uprawnień podłączonego użytkownika HubSpot. W zależności od uprawnień użytkownika może to obejmować tworzenie, aktualizowanie lub usuwanie rekordów na koncie.

Po podłączeniu interfejsu CLI HubSpot Agent agenci AI mogą korzystać z informacji w całym koncie HubSpot, w tym:

• kontakty, firmy, transakcje, zgłoszenia, obiekty niestandardowe i inne rekordy CRM.
• Przepływy pracy.
• Pipeline'ami i etapami pipeline'ów.
• Właściwości i właściwości niestandardowe.
• Powiązania między rekordami.
• Historia działań.

Uwaga: przed wprowadzeniem zmian w danych CRMnależy zawsze sprawdzić rekomendacje i proponowane działania wygenerowane przez sztuczną inteligencję.

Najlepsze praktyki

Podczas pracy z agentami AI połączonymi z HubSpot:

• Zacznij od zadań związanych z raportowaniem, podsumowaniami i analizą, zanim zastosujesz działania modyfikujące dane.
• Przed wprowadzeniem zmian sprawdź wygenerowane rekomendacje i aktualizacje na dużą skalę.
• Niektóre działania mogą spowodować usunięcie lub nadpisanie danych w HubSpot. Jeśli to możliwe, użyj opcji --dry-run, aby wyświetlić podgląd zmian przed ich wprowadzeniem.
• Używaj jasnych poleceń opisujących pożądany wynik.
• Postępuj zgodnie z zasadami zarządzania danymi i polityką bezpieczeństwa obowiązującą w Twojej organizacji.

Podłącz interfejs CLI HubSpot Agent

Wykonaj poniższe kroki, aby polecić agentowi zainstalowanie interfejsu CLI agenta HubSpot. Jeśli jesteś programistą, dowiedz się więcej o ręcznej instalacji interfejsu CLI agenta HubSpot.

1. Otwórz swojego agenta AI, takiego jak Cowork lub Codex.
2. Wklej poniższą komendę do obszaru roboczego agenta, aby zainstalować 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.

3. Po wyświetleniu monitu zaloguj się na swoje konto HubSpot.
4. Sprawdź wymagane uprawnienia.
5. Kliknij opcję „Połącz aplikację”.

Po zakończeniu uwierzytelniania agent AI uzyska dostęp do danych HubSpot zgodnie z Twoimi uprawnieniami.

Aby rozpocząć, skorzystaj z jednego z poniższych przykładowych poleceń.

Przykładowe zastosowania

Poniższe przykłady pokazują, w jaki sposób różne zespoły mogą korzystać z agentów AI podłączonych za pośrednictwem interfejsu CLI HubSpot Agent. Agent jest szczególnie przydatny w przypadku powtarzających się zadań operacyjnych, które wymagają przeglądania dużych ilości danych CRM.

Zespoły marketingowe

Zadanie: zidentyfikuj kontakty wymagające dalszych działań lub uzupełnienia danych.

Przykładowa komenda dla agenta AI: W każdy poniedziałek o godz. 8:00 rano znajdź kontakty o wysokim stopniu dopasowania, które nie mają powiązanej transakcji, nie wykazują ostatnio aktywności sprzedażowej lub w których brakuje kluczowych pól uzupełniających, a następnie wyślij do działu RevOps listę priorytetowych działań porządkujących wraz z sugerowanymi kolejnymi krokami.

Dodatkowe przykłady obejmują:

• Przejrzyj kampanie e-mailowe pod kątem tematów wiadomości i wezwań do działania (CTA), które nie są zgodne z wytycznymi dotyczącymi tonu komunikacji marki.
• Zidentyfikuj wzorce komunikatów na najlepiej działających stronach docelowych, które korelują z wyższymi współczynnikami konwersji.
• Stwórz listę kontaktów do ponownego zaangażowania, którzy nie otworzyli e-maili w sekwencji pielęgnacyjnej.
• Śledź aktualny status potencjalnych transakcji pozyskanych w ramach kampanii webinarowej.
• Zidentyfikuj wzorce dotyczące branży, wielkości firmy i źródła leadów wśród klientów najlepiej dopasowanych do oferty.
• Monitoruj aktywne sekwencje i sygnalizuj znaczące spadki wskaźników otwarć wiadomości e-mail.

Zespoły ds. sprzedaży i operacji przychodowych

Zadanie: monitorowanie kondycji lejka sprzedaży i identyfikowanie transakcji wymagających uwagi.

Przykładowa instrukcja dla agenta AI: Codziennie rano o godz. 7:00 sprawdź w moim procesie sprzedaży transakcje, które mają zostać sfinalizowane w tym tygodniu, a które nie wykazały żadnej aktywności w ciągu ostatnich 5 dni, i prześlij mi podsumowanie.

Dodatkowe przykłady obejmują:

• Znajdź nieaktywne transakcje o wysokiej wartości, które wymagają dalszych działań i przeglądu.
• Przygotuj się do spotkania z klientem, podsumowując historię transakcji, wsparcia, wiadomości e-mail i notatek.
• Przeanalizuj transakcje, które nie doszły do skutku, aby zidentyfikować etapy procesu sprzedaży, na których szanse na sukces utknęły na najdłużej.
• Generuj codzienne podsumowanie transakcji, których termin zamknięcia zbliża się, ale w których brakuje ostatnich działań.

Kierownicy sprzedaży

Zadanie: przeanalizuj transkrypcje rozmów pod kątem tematów związanych z coachingiem i opiniami o produkcie.

Przykładowe polecenie dla agenta AI: Przeanalizuj najnowsze transkrypcje rozmów pod kątem czasu trwania rozmowy, wzmianek o konkurencji, opinii klientów oraz tematów związanych z wahaniem potencjalnych klientów, a następnie utwórz pulpit nawigacyjny dotyczący coachingu i opinii o produkcie, zawierający przykłady transkrypcji oraz linki do rozmów źródłowych.

Dodatkowe przykłady obejmują:

• Zidentyfikuj przedstawicieli handlowych lub zespoły o nietypowo długim lub krótkim czasie rozmowy.
• Znajdź powtarzające się wzmianki o konkurencji w ostatnich rozmowach sprzedażowych.
• Podsumuj motywy związane z wahaniem potencjalnych klientów według segmentu, etapu transakcji lub obszaru produktowego.
• Wybierz przykłady transkrypcji, które wspierają tematy związane ze szkoleniem lub opiniami o produkcie.
• Stwórz pulpit nawigacyjny, który łączy wnioski z rozmów z rekordami źródłowymi i transkrypcjami.

Administratorzy RevOps i CRM

Zadanie: uporządkuj właściwości CRM bez naruszania powiązanych zasobów.

Przykładowe polecenie dla agenta AI: Znajdź zduplikowane lub przestarzałe właściwości CRM, pokaż, gdzie są one używane w przepływach pracy, raportach i widokach. Następnie wyświetl podgląd planu porządkowania, aby zastąpić, usunąć lub zmienić kolejność pól przed zastosowaniem zmian.

Dodatkowe przykłady obejmują:

• Zidentyfikuj zduplikowane właściwości, które gromadzą te same informacje w różnych obiektach.
• Znajdź przestarzałe pola, które nadal pojawiają się w przepływach pracy, raportach, widokach lub układach rekordów.
• Zaprezentuj wpływ usunięcia lub zastąpienia właściwości CRM przed wprowadzeniem zmian.
• Zmień kolejność pól rekordów, aby administratorzy i przedstawiciele handlowi widzieli najważniejsze informacje jako pierwsze.
• Generowanie podsumowania porządkowania, które pokazuje, co uległo zmianie, a co nadal wymaga przeglądu.

Zespoły operacyjne

Zadanie: skonsoliduj powiązane zgłoszenia do pomocy technicznej i zachowaj historię porządkowania.

Przykładowa instrukcja dla agenta AI: Skonsoliduj zduplikowane zgłoszenia do pomocy technicznej, zachowaj szczegóły zgłoszenia źródłowego, skieruj każde zgłoszenie nadrzędne do odpowiedniego etapu potoku oraz wyślij zespołowi podsumowanie porządkowania wraz z rekordami, które nadal wymagają przeglądu.

Dodatkowe przykłady obejmują:

• Znajdź zduplikowane lub powiązane zgłoszenia do pomocy technicznej dotyczące tego samego klienta lub typu problemu.
• Scal kontekst zgłoszenia z rekordem nadrzędnym, zachowując szczegóły źródłowe.
• Przekieruj skonsolidowane zgłoszenia do odpowiedniego etapu procesu obsługi w oparciu o aktualny status.
• Oznacz zgłoszenia, które wymagają weryfikacji przez człowieka przed konsolidacją.
• Wysyłanie podsumowania porządkowania zawierającego połączone zgłoszenia, otwarte pytania oraz osoby odpowiedzialne za dalsze działania.

Zespoły wsparcia

Zadanie: przejrzenie historii klienta bez konieczności ręcznego otwierania wielu rekordów.

Przykładowa prośba skierowana do agenta AI: Pobierz ostatnie 5 zgłoszeń od tego kontaktu, podsumuj każde rozwiązanie i zaznacz wszelkie powtarzające się wzorce problemów.

Dodatkowe przykłady obejmują:

• Przejrzyj najnowszą historię zgłoszeń i zidentyfikuj powtarzające się problemy klientów przed otwarciem nowej sprawy.
• Nadaj priorytet zgłoszeniom, w których przekroczono oczekiwany czas odpowiedzi.
• Przeanalizuj zgłoszenia związane z rozliczeniami, aby zidentyfikować najczęstsze powody, dla których klienci kontaktują się z pomocą techniczną.
• Przygotuj odpowiedzi na zgłoszenia, uwzględniając historię transakcji, subskrypcji i eskalacji.

Zespoły ds. sukcesu klienta

Zadanie: przygotuj przeglądy kont, korzystając z informacji z wielu narzędzi HubSpot.

Przykładowa prośba skierowana do agenta AI: W ramach przeglądu moich kont w tym tygodniu podsumuj otwarte transakcje, ostatnią aktywność działu wsparcia oraz ostatni wynik NPS dla każdego konta w moim portfelu klientów.

Dodatkowe przykłady obejmują:

• Zidentyfikuj konta klientów wykazujące oznaki podwyższonego ryzyka rezygnacji.
• Znajdź osoby odpowiedzialne za przedłużenie umów, które wykazują niskie zaangażowanie w produkt, w celu proaktywnego kontaktu.
• Przygotuj przeglądy kont, podsumowując ostatnią aktywność w zakresie sprzedaży, obsługi klienta i opinii klientów.
• Zidentyfikuj możliwości ekspansji, porównując trendy wzrostu kont z historyczną wielkością transakcji.

Aktualizuj bibliotekę umiejętności

Umiejętności HubSpot Agent CLI zapewniają predefiniowane wytyczne, które pomagają agentom AI pracować z danymi HubSpot i typowymi procesami HubSpot. Biblioteka umiejętności zawiera wytyczne dotyczące wyszukiwania w CRM, operacji zbiorczych, zadań związanych z jakością danych, przepływów pracy, raportowania i innych działań operacyjnych.

Możesz przejrzeć umiejętności, które zostaną zainstalowane w publicznym repozytorium GitHub.

Aby zaktualizować bibliotekę umiejętności w swoim obszarze roboczym agenta AI, uruchom następujące polecenie:

npx skills update

Dowiedz się więcej o korzystaniu z umiejętności w Claude i OpenAI Codex.

Zarządzaj dostępem do HubSpot Agent CLI

Superadministratorzy mogą zarządzać tym, kto ma prawo łączyć się z interfejsem CLI HubSpot Agent, włączając opcję App Install Governance w wersji beta.

Jeśli użytkownik nie ma uprawnień do podłączenia interfejsu CLI HubSpot Agent, przed podłączeniem musi poprosić administratora o zgodę.

Dowiedz się więcej o zarządzaniu aplikacjami, które można zainstalować na koncie HubSpot.