Korzystanie z interfejsu CLI HubSpot Agent

Interfejs CLI HubSpot Agent łączy agentów opartych na sztucznej inteligencji, takich jak te dostępne w aplikacjach ChatGPT, Claude i Claude Code, 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 zlecasz zadania agentom AI, mogą oni korzystać z Agent CLI do automatyzowania rutynowych czynności w Twoim imieniu, dzięki czemu Twój zespół może 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 przy użyciu informacji z HubSpot.

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

Zanim zaczniesz

Zanim zaczniesz korzystać z interfejsu CLI HubSpot Agent, upewnij się, że masz dostęp do agenta AI do kodowania. Obsługiwani agenci to m.in. ci z aplikacji ChatGPT, aplikacji Claude, Claude Code 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 interfejsowi CLI HubSpot Agent

HubSpot Agent CLI może wykonywać czynności, 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 Twoim 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ływami pracy.
• Pipeline’ów i etapów pipeline’ów.
• Właściwości i właściwości niestandardowe.
• Rekordy przychodów (tylko do odczytu): umowy, faktury, zamówienia, płatności, oferty, szablony ofert oraz subskrypcje (wersja beta).

Uwaga: jeśli jesteś superadministratorem, możesz włączyć swoje konto do programubeta„ ” dotyczącej danych o przychodach w HubSpot Agent CLI .

• Powiązania między rekordami.
• Historia aktywności.

Uwaga: zawsze sprawdzaj rekomendacje generowane przez AI oraz proponowane działania przed wprowadzeniem zmian w danych CRM.

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 poinstruować swojego agenta, jak zainstalować interfejs 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.
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, które wymagają 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 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 stylu 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 wymagających 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 znaczne spadki wskaźników otwarć wiadomości e-mail.

Zespoły ds. sprzedaży i operacji przychodowych

Zadanie: monitorowanie kondycji procesu 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 i nie wykazały żadnej aktywności w ciągu ostatnich 5 dni, a następnie 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 się opóźniły, 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 ostatnio nie odnotowano żadnej aktywności.

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 motywów wahania 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.
• Stworzenie pulpitu nawigacyjnego, 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 i 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, przekieruj 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 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 ręcznego otwierania wielu rekordów.

Przykładowe polecenie dla agenta AI: Pobierz 5 ostatnich 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ładowe polecenie dla 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, wsparcia technicznego oraz opinii klientów.
• Zidentyfikuj możliwości ekspansji poprzez porównanie trendów 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 ChatGPT.

Zarządzaj dostępem do HubSpot Agent CLI

Superadministratorzy mogą zarządzać tym, kto ma prawo podłączyć interfejs 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.