CRM i sprzedaż
Połączenie HubSpot z autonomicznym agentem AI
Agent Atako połączony z HubSpot może odczytywać i aktualizować kontakty, firmy, transakcje i zgłoszenia, ale tylko te obiekty i działania, które obejmuje jego grant.
Możliwe scenariusze
Wzbogacanie i kwalifikacja przychodzących leadów
Gdy tylko kontakt trafia do CRM, agent pobiera go przez get_contact, zestawia dostępne informacje, aktualizuje jego właściwości (update_contact), zapisuje notatkę kwalifikacyjną (create_note) i tworzy zadanie przypominające dla odpowiedniego handlowca (create_task). Handlowiec zachowuje kontrolę nad rozmową lub emailem, agent oszczędza mu jedynie wprowadzanie danych i wcześniejsze wyszukiwanie, które zwykle poprzedzają pierwszy owocny kontakt, często odkładany z braku czasu w ciągu dnia.
Przypominanie o transakcjach utkniętych w pipeline
Agent wyszukuje transakcje bez ruchu od określonej liczby dni (search_deals, list_pipelines, aby poznać etapy), tworzy zadanie przypominające dla właściciela transakcji zidentyfikowanego przez list_owners i może zaktualizować status, jeśli uzasadnia to jasna reguła (update_deal). Nic nie zostaje przesunięte bez śladu możliwego do sprawdzenia w CRM, co zapobiega rozdętym pipeline'om pełnym transakcji widmo, o które nikt naprawdę nie zabiega.
Tworzenie zgłoszeń wsparcia powiązanych z kontem
Na podstawie sygnału otrzymanego przez email lub Slack agent tworzy zgłoszenie (create_ticket), łączy je z właściwym kontaktem i firmą (create_association), a następnie śledzi jego postęp i aktualizuje w toku rozmowy (update_ticket). Zgłoszenie pozostaje widoczne i edytowalne przez zespół wsparcia jak każde inne, z pełną historią konta dołączoną już od momentu utworzenia.
Akcje konektora
get_contact (odczyt)
Pobiera kontakt CRM po identyfikatorze.
search_contacts (odczyt)
Wyszukuje kontakty po tekście lub filtrach właściwości.
get_deal (odczyt)
Pobiera transakcję CRM po identyfikatorze.
list_deals (odczyt)
Listuje transakcje CRM, stronicowane.
list_pipelines (odczyt)
Listuje pipeline'y i ich etapy (transakcje lub zgłoszenia).
list_owners (odczyt)
Listuje właścicieli CRM, z możliwością filtrowania po emailu.
create_contact (zapis)
Tworzy kontakt CRM.
update_contact (zapis)
Aktualizuje właściwości kontaktu.
create_deal (zapis)
Tworzy transakcję CRM.
update_deal (zapis)
Aktualizuje transakcję (etap, kwota).
create_ticket (zapis)
Tworzy zgłoszenie wsparcia.
create_task (zapis)
Tworzy zadanie CRM (przypomnienie, telefon).
create_note (zapis)
Zapisuje notatkę, do powiązania z rekordem.
create_association (zapis)
Łączy ze sobą dwa rekordy CRM.
Wymagania wstępne
- Konto HubSpot z uprawnieniami super admina, aby utworzyć private app.
- Utworzyć private app w Settings, następnie Integrations, następnie Private Apps.
- Wybrać niezbędne scope'y (contacts, companies, deals, tickets, owners w odczycie/zapisie).
- Skopiować token dostępu wyświetlony po utworzeniu (przedrostek pat-).
- W Atako uprawnienie administratora integracji, aby przyznać grant agentowi.
Jak połączyć
- 1
Utworzenie private app HubSpot
W Settings, następnie Integrations, następnie Private Apps, utworzyć aplikację, nadać jej nazwę, a następnie wybrać jej scope'y w dedykowanej zakładce.
- 2
Wygenerowanie i skopiowanie tokenu
Po utworzeniu aplikacji wyświetlić, a następnie skopiować token dostępu (pat-...), pokazywany tylko raz.
- 3
Połączenie HubSpot w Atako
W Ustawienia, następnie Integracje, wkleić token dostępu.
- 4
Przyznanie grantu agentowi
Ze strony agenta lub z poziomu połączenia wybrać dokładne dozwolone działania i ich zakres (tylko odczyt lub odczyt i zapis).
Dlaczego podłączyć autonomicznego agenta do HubSpot
HubSpot centralizuje kontakty, transakcje i zgłoszenia zespołu sprzedaży lub wsparcia. Powtarzalna praca, która z tym się wiąże, wzbogacanie karty, przypominanie o zwlekającej transakcji, tworzenie zadania kontrolnego, wykonywana jest zwykle na bieżąco, gdy ktoś o niej pomyśli. Agent Atako połączony z HubSpot przez tool calling wykonuje tę pracę nieprzerwanie, we własnym środowisku, bez czekania, aż handlowiec otworzy swoją listę zadań rano.
Różnica względem klasycznego scenariusza automatyzacji: agent działa nieprzerwanie i podejmuje decyzję, a nie tylko pojedyncze działanie. Może otrzymać sygnał przez email lub Slack, wyszukać odpowiedni kontakt lub transakcję w HubSpot, zdecydować, czy trzeba utworzyć zadanie, czy zaktualizować właściwość, a następnie to zrobić, dokładnie w ramach działań, które mu przyznano.
Konektor HubSpot obejmuje 37 działań według dokumentacji Atako (17 odczytu, 20 zapisu), od wyszukiwania kontaktów po tworzenie niestandardowych właściwości. Najbardziej bezpośredni przypadek użycia produktowego: agent automatyzacji RevOps, który monitoruje pipeline, wzbogaca leady i sygnalizuje anomalie danych bez stałej ingerencji człowieka.
Ograniczenia i dobre praktyki
API HubSpot narzuca limity przepustowości, które różnią się w zależności od subskrypcji HubSpot firmy (liczba żądań w przedziale dziesięciu sekund oraz dziennie), z jeszcze surowszymi progami dla endpointów wyszukiwania. Agent przetwarzający duży wolumen kontaktów musi więc rozkładać swoje wywołania w czasie zamiast wykonywać wszystko naraz.
Niektóre działania zapisu, jak delete_contact czy delete_deal, są nieodwracalne po stronie HubSpot po wykonaniu. Można ich użyć tylko wtedy, gdy grant agenta wyraźnie na nie zezwala, co w praktyce pozostaje rzadkością dla tego typu działań.
Jak w przypadku każdej integracji Atako, samo połączenie nie daje żadnego dostępu: potrzebny jest precyzyjny grant (agent, działanie, zakres). Zobacz model uprawnień i plany, aby określić ten zakres przed podłączeniem agenta do Twojego CRM.
Powiązane przypadki użycia
Powiązane integracje
Najczęstsze pytania
Czy agent może wysyłać emaile marketingowe z HubSpot?
Może utworzyć wersję roboczą emaila marketingowego (create_marketing_email), jeśli ten scope zostanie przyznany, ale nic nie zostaje wysłane bez akcji wysyłki zatwierdzonej przez Twój zespół: konektor nie zawiera żadnego działania bezpośredniej wysyłki emaila marketingowego.
Czy potrzebny jest płatny plan HubSpot, aby połączyć API?
API i private apps są dostępne już w darmowym planie HubSpot dla standardowych obiektów. Niektóre zaawansowane scope'y, jak tworzenie niestandardowych właściwości, mogą zależeć od wykupionego poziomu cenowego.
Jak odebrać agentowi dostęp do HubSpot?
Usuń lub dezaktywuj private app po stronie HubSpot, albo cofnij połączenie po stronie Atako. Dostęp zostaje odcięty natychmiast i ostatecznie dla wszystkich agentów, które z niego korzystały.
Czy agent może usuwać kontakty z CRM?
Tak, działanie delete_contact istnieje, ale tylko jeśli grant agenta wyraźnie na nie zezwala z zakresem zapisu. Domyślnie żadne działanie nie jest przyznane: to Ty decydujesz, czy usuwanie wchodzi w zakres agenta.
Co przeczytać dalej
Źródła
- HubSpot Developer Docs, Private apps · dostęp dnia 4 września 2026
- HubSpot Developer Docs, API usage guidelines and limits · dostęp dnia 4 września 2026
CTO w Atako
Ta treść została napisana przez agentów AI firmy Atako, a następnie sprawdzona, poprawiona i zatwierdzona przez Romaina Laodicinę, CTO Atako.