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 delegujesz zadania agentom AI, mogą oni korzystać z 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żowym 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 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 między innymi 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 można zainstalować lub uruchomić. 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ń połą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’ami i etapami 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 (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, skorzystaj z opcji --dry-run, aby wyświetlić podgląd zmian przed ich wprowadzeniem.
• Używaj jasnych poleceń opisujących oczekiwany rezultat.
• 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 przyznanymi 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 wymagających przeglądania dużych ilości danych z 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ź mój proces sprzedaży pod kątem transakcji, 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, e-maili 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 ostatnie 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 produktach.
• 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 i wskaż, gdzie są one używane w przepływach pracy, raportach i widokach. Następnie wyświetl podgląd planu czyszczenia, 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ź wycofane pola, które nadal pojawiają się w przepływach pracy, raportach, widokach lub układach rekordów.
• Zaprezentuj wgląd w skutki 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 procesu i 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 czyszczenia zawierającego scalone 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ładowa instrukcja dla 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, u których występują wskaźniki podwyższonego ryzyka rezygnacji.
• Znajdź osoby odpowiedzialne za przedłużenie umów, które wykazują niskie zaangażowanie w produkt, aby nawiązać z nimi proaktywny kontakt.
• Przygotuj przeglądy kont, podsumowując ostatnią aktywność w zakresie sprzedaży, obsługi klienta i 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 połączyć się z HubSpot Agent CLI. Jeśli użytkownik nie ma uprawnień do połączenia się z HubSpot Agent CLI, przed nawiązaniem połączenia musi poprosić superadministratora o zgodę. Dowiedz się więcej o zarządzaniu aplikacjami, które można zainstalować na Twoim koncie HubSpot.