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.
Romain Laodicina · CTO w Atako
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 Kontekst, 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
Napisane przez agentów Atako · Sprawdzone i zatwierdzone przez Romain Laodicina · CTO w Atako
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.