Jak połączyć HubSpot z Excelem - zapytanie o dane CRM za pomocą SQL

Połącz · HubSpot z Excelem

Pobierz dane z HubSpot do Excel

Pobierz wiersze na żywo z konta HubSpot do Excela i odświeżaj je w dowolnym momencie. Bez sterownika ODBC, eksportów i makr. Za pierwszym razem zajmie to około dziesięciu minut, a plan darmowy to obejmuje.

Około 10 minut Nie potrzeba kodowania Poświadczenia pozostają z Tobą Korzystaj z Excela w dowolnym miejscu, nawet w Internecie

Co z tego wyjdzie?

Arkusz kalkulacyjny pokazujący na żywo wyniki zapytania SQL na Twoim koncie HubSpot, z przyciskiem, który pobiera najnowsze wiersze po każdej zmianie danych. Na przykład:

Sprzedaż.xlsx — Excel

Strona głównaWstawDaneStrumienie zapytań

	A	B	C	D	E
1	customer_id	imię	nazwisko	kraj	całkowity
2	1042	Maria	Álvarez	USA	1,284.50
3	1043	Daniel	Okafor	USA	612.00
4	1047	Priya	Nair	USA	2,090.75
5	1051	Tomasz	Góra	USA	338.20
6	1056	Lucía	Ferreira	USA	1,455.00
7	1060	Kenji	Sato	USA	874.10
8

Arkusz1 Na żywo z HubSpot

HubSpot przechowuje Twoje dane za pośrednictwem swojego API. Przeniesienie ich do Excela zazwyczaj oznacza eksport pliku CSV z pulpitu HubSpot za każdym razem, gdy potrzebujesz nowych danych. Query Streams pomija ten problem: mały program pomocniczy o nazwie Agent uruchamia zapytanie w miejscu, w którym znajdują się Twoje dane, a dodatek do Excela pyta go o żądane wiersze. Tylko wyniki przesyłane są szyfrowanym łączem, a Excel może być dostępny w dowolnym miejscu: na Twoim laptopie w domu, komputerze współpracownika w innym kraju lub w przeglądarce.

Czego będziesz potrzebować

Konto Query Streams

Plan darmowy wystarczy do tego poradnika. Zarejestruj się na my.querystreams.com.

Agent na dowolnym komputerze stale włączonym

Mały program, który działa w tle i wywołuje HubSpot, gdy Excel o to poprosi. Wymaga jedynie dostępu do internetu.

Twoje logowanie do HubSpot

Zalogujesz się do HubSpot raz i zezwolisz na dostęp do odczytu. Do strumieni zapytań nie wpisuje się żadnych haseł.

Podłącz w pięciu krokach

1. Utwórz swoje konto

   Przejdź do my.querystreams.com i zarejestruj się. Wybierz Bezpłatny plan. To prawdziwy plan, a nie wersja próbna, obejmujący podłączenie konta HubSpot i uruchamianie zapytań z programu Excel.

2. Zainstaluj agenta na dowolnym komputerze stale włączonym

   Zaloguj się, otwórz Pobieraći zainstaluj Agenta na dowolnym komputerze lub serwerze z dostępem do internetu, który jest stale aktywny. Zajmie to minutę i od tego momentu uruchomi się automatycznie.

   Dlaczego mały program, a nie sterownik? Agent to pojedyncza instalacja dla systemów Windows, Mac lub Linux (około 85 MB w systemie Windows, nieco ponad 100 MB w systemach Mac i Linux), która działa cicho w tle. Nawiązuje jedno szyfrowane połączenie wychodzące do strumieni zapytań, tak jak robi to przeglądarka, więc nie otwierasz portu zapory sieciowej ani nie konfigurujesz sieci VPN. Twoje klucze pozostają na tym komputerze, a wiersze danych przesyłane są do Ciebie, gdziekolwiek jesteś, przez internet, jeśli zajdzie taka potrzeba. Jedyne, co musisz zrobić, to zainstalować dodatek.

   Strona pobierania pokazuje Twój klucz dostępuWklej to do agenta, gdy o to poprosi i poczekaj, aż odznaka zostanie odczytana Połączono ze strumieniami zapytańTo jest jedyna rzecz, którą robisz na samym Agencie.

   Pełne opisy przejść, jeśli ich potrzebujesz: Okna, Prochowiec, Linux.

3. Skieruj go na swoje konto HubSpot

   Wróć do przeglądarki i otwórz Agenci danych (pod Dane (w górnym menu). Twój agent jest tam wymieniony. Kliknij Dodaj złącze i wybierz HubSpotPotrzebujesz najpierw danych logowania do HubSpot? Otwórz przewodnik i wypełnij:

   Utwórz swoje dane uwierzytelniające HubSpot (około 5 minut)

   Następnie otwórz HubSpot w innej karcie. Strumienie zapytań przechowują to, co tutaj utworzysz, aby Twój agent mógł z tego korzystać, i odczytują tylko dane z HubSpot.

   Kto może to zrobić?

   Superadministrator lub użytkownik z uprawnieniami dostępu do narzędzi programistycznych (klucze serwisowe). Starsze aplikacje prywatne wymagają superadministratora.

   Zalecony

   Klucz usługi z zakresami tylko do odczytu (Rozwój → Klucze → Klucze usługi). HubSpot zaleca klucze usługi do planowej synchronizacji danych z narzędziami BI i magazynami danych oraz usuwa opcję tworzenia nowych, starszych aplikacji prywatnych.

   Zanim zaczniesz

   • Login HubSpot z uprawnieniami Superadministratora lub uprawnieniami dostępu do narzędzi programistycznych. Kluczowi usługi można nadać tylko zakresy, które posiada już Twój użytkownik HubSpot.
   • Określ, które konto HubSpot chcesz przeszukać. Klucz odczytuje tylko konto, na którym został utworzony, więc utwórz go na tym koncie, a nie na koncie testowym lub sandbox.
   • Zdecyduj, które tabele HubSpot chcesz mieć. Kontakty, Firmy, Transakcje, Właściciele, Potoki, Etapy Potoku i Właściwości są domyślnie włączone; każda dodatkowa tabela wymaga własnego zakresu odczytu (patrz Uprawnienia).
   • Agent Query Streams zainstalowany i działający w trybie online na komputerze stale włączonym, a portal Query Streams otwiera się w osobnej karcie: Agenci danych → Dodaj łącznik → HubSpot.

   Kroki

   1. Zaloguj się do HubSpot

      Otwórz HubSpot w nowej karcie i zaloguj się jako superadministrator lub jako użytkownik z uprawnieniami dostępu do narzędzi programistycznych.

      Jeśli posiadasz więcej niż jedno konto HubSpot, przed kontynuowaniem przełącz się na to, którego dane potrzebujesz. Klucz działa tylko na koncie, na którym został utworzony.

   2. Otwarty rozwój

      W lewym panelu nawigacyjnym, u dołu, kliknij „Rozwój” (ikona </>). Strona „Rozwój” otworzy się z własnym paskiem bocznym: Przegląd, Projekty, Starsze aplikacje, Monitorowanie, Klucze i inne.

      Brak elementu „Development”? Twój użytkownik HubSpot nie jest superadministratorem i nie ma dostępu do narzędzi programistycznych. Poproś superadministratora o utworzenie klucza lub przyznanie Ci takiego uprawnienia.

   3. Otwórz klucze serwisowe

      Na pasku bocznym „Rozwój” kliknij „Klucze”, aby je rozwinąć, a następnie kliknij „Klucze usług” (oznaczone etykietą „Beta”). Otworzy się strona „Klucze usług”; jeśli jeszcze ich nie masz, pojawi się komunikat „Nie utworzono kluczy usług”.

      Nie używaj klucza dostępu osobistego ani klucza API dla programistów, które znajdują się tuż nad kluczami usług w tym samym menu. Są to klucze narzędzi dla programistów i nie umożliwiają połączenia. Niektóre konta mają również dostęp do tej strony z Ustawienia (ikona koła zębatego) → Integracje → Klucze usług.

   4. Kliknij Utwórz klucz usługi

      W prawym górnym rogu strony Klucze usług kliknij Utwórz klucz usługi. Otworzy się strona Utwórz klucz usługi z polem Nazwa i sekcją Zakresy.

   5. Podaj nazwę klucza

      W polu Nazwa wpisz nazwę, którą później rozpoznasz, na przykład „Strumienie zapytań – tylko do odczytu”. HubSpot wyświetla tę nazwę w swoich logach.

      Nazwa musi być unikatowa na Twoim koncie HubSpot.

   6. Otwórz selektor zakresu

      Obok opcji „Wybrane zakresy” kliknij „+ Dodaj nowy zakres”. Po prawej stronie otworzy się panel z polem wyszukiwania „Znajdź zakres” i polem wyboru dla każdego zakresu.

   7. Zaznacz cztery wymagane zakresy

      Wpisz każdą nazwę w polu „Znajdź zakres” i zaznacz odpowiednie pole wyboru: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. Te cztery pola obejmują wszystkie tabele, które domyślnie synchronizuje Query Streams.

      Zaznacz tylko zakresy kończące się na .read. Strumienie zapytań odczytują tylko dane z HubSpot i nigdy nie potrzebują zakresu .write.

   8. Zaznacz zakresy dla wszelkich dodatkowych tabel

      Dla każdej dodatkowej tabeli, którą chcesz dodać, zaznacz jej zakres na poniższej liście uprawnień. Na przykład: crm.objects.tickets.read dla biletów; crm.objects.line_items.read dla pozycji zamówienia, podatków, rabatów i opłat; crm.lists.read dla list. Pomiń ten krok, jeśli domyślne tabele są wystarczające.

      Zakresy można dodać później, bez konieczności tworzenia nowego klucza (otwórz klucz, a następnie wybierz opcję Edytuj).

   9. Kliknij Aktualizuj

      Kliknij „Aktualizuj” w prawym panelu. Panel zostanie zamknięty, a Twoje zakresy zostaną wyświetlone w sekcji „Wybrane zakresy”.

   10. Sprawdź listę zakresów

       Przeczytaj wybrane zakresy. Jeśli cokolwiek kończy się na .write, kliknij Usuń obok. Rozwiń Podsumowanie wybranych zakresów, jeśli chcesz wyświetlić listę w prostym języku, co klucz widzi.

   11. Utwórz klucz

       Kliknij Utwórz w prawym górnym rogu, a następnie potwierdź w otwartym oknie dialogowym.

   12. Otwórz swój nowy klucz

       Przejdź do sekcji Rozwój → Klucze → Klucze usług i kliknij nazwę utworzonego klucza. Otworzy się strona ze szczegółami klucza z polem Klucz usług.

   13. Pokaż i skopiuj klucz

       W polu Klucz usługi wartość jest częściowo ukryta i zaczyna się od pat- (na przykład pat-na1-…). Kliknij „Pokaż” pod nią, a następnie „Kopiuj”.

       Użyj funkcji Kopiuj zamiast zaznaczać tekst ręcznie: brakujący znak, spacja na końcu lub ukryte kropki spowodują niepowodzenie testu. HubSpot nie wyświetla klucza tylko raz; możesz wrócić i kliknąć Pokaż ponownie. Potraktuj to jak hasło.

   14. Wklej do strumieni zapytań i przetestuj

       W portalu Query Streams otwórz Data Agents, kliknij Add connector i wybierz HubSpot. Wklej klucz do App Access Token, wpisz nazwę połączenia, a następnie kliknij Test connection. Wynik to Connected (Połączono).

       Usługa Query Streams przechowuje klucz dla Twojego agenta i odczytuje wyłącznie dane z HubSpot.

   15. Dopasuj tabele do swoich zakresów

       W kolejnym kroku synchronizacji pozostaw tylko te tabele HubSpot, których zakresy zaznaczyłeś w krokach 7 i 8, a następnie zakończ działanie kreatora.

       Tabela włączona bez zakresu nie synchronizuje się z błędem Forbidden. Dodaj zakres do klucza (krok 8) lub wyłącz tabelę.

   Alternatywy

   Użyj starszego prywatnego tokena aplikacji

   Na Twoim koncie znajduje się już starsza prywatna aplikacja, którą chcesz ponownie wykorzystać. HubSpot usuwa możliwość tworzenia nowych: konta utworzone 28 września 2026 r. lub później nie mają już takiej możliwości, a starsze konta utracą ją 26 października 2026 r. Istniejące prywatne aplikacje i ich tokeny nadal działają.

   Kto może to zrobić: Superadministrator

   1. Otwórz starsze aplikacje

      W HubSpot kliknij Rozwój w lewym pasku nawigacji głównej, a następnie Aplikacje starszej generacji w pasku bocznym Rozwój.

      Starsza nawigacja HubSpot nazywała się Ustawienia → Integracje → Aplikacje prywatne.

   2. Otwórz swoją prywatną aplikację lub rozpocznij nową

      Jeśli aplikacja jest na liście, kliknij jej nazwę i przejdź do kroku 6 (lub kroku 5, aby dodać zakresy). Jeśli nie, a przycisk nadal jest widoczny, kliknij „Utwórz starszą aplikację” w prawym górnym rogu i wybierz „Prywatna” w oknie dialogowym.

      Brak przycisku „Utwórz starszą aplikację” oznacza, że tworzenie aplikacji jest już wyłączone dla Twojego konta. Zamiast tego użyj klucza usługi (główne kroki).

   3. Nadaj nazwę nowej aplikacji

      Na karcie Informacje podstawowe wpisz nazwę, np. Strumienie zapytań – tylko do odczytu. Logo i opis są opcjonalne.

   4. Dodaj zakresy odczytu

      Kliknij kartę Zakresy, kliknij Dodaj nowy zakres, zaznacz te same zakresy, co w krokach głównych 7 i 8, a następnie kliknij Aktualizuj. Następnie kliknij Utwórz aplikację w prawym górnym rogu, przeczytaj komunikat o tokenie dostępu w oknie dialogowym i kliknij Kontynuuj tworzenie.

   5. Dodaj zakresy do istniejącej aplikacji (tylko jeśli to konieczne)

      Na stronie aplikacji kliknij „Edytuj aplikację” w prawym górnym rogu, otwórz kartę „Zakresy”, dodaj brakujące zakresy odczytu i zapisz. Ciąg tokenów nie zmienia się po zmianie zakresów.

   6. Pokaż i skopiuj token

      Na stronie aplikacji kliknij kartę „Autoryzacja”. W sekcji „Token dostępu” kliknij „Pokaż token”, a następnie „Kopiuj”. Token zaczyna się od „pat-”. Wklej go do pola „Token dostępu aplikacji” tak jak w kroku głównym 14.

      Jeśli użytkownik HubSpot, który utworzył aplikację, zostanie usunięty z HubSpot, niektóre wywołania zakończą się niepowodzeniem z błędem USER_DOES_NOT_HAVE_PERMISSIONS. Obróć token (Obróć obok niego) i wklej nowy lub przenieś go do klucza usługi.

   Użyj statycznego tokena uwierzytelniającego aplikacji platformy deweloperskiej

   Twój zespół stworzył już aplikację HubSpot na nowej platformie programistycznej z interfejsem wiersza poleceń HubSpot CLI, skonfigurowanym ze statycznym uwierzytelnianiem i dystrybucją prywatną. Do jej utworzenia potrzebny jest interfejs wiersza poleceń; jeśli go nie masz, użyj klucza usługi.

   Kto może to zrobić: Aby wyświetlić token, superadministrator lub użytkownik z uprawnieniami programisty; superadministrator lub użytkownik z uprawnieniami dostępu do HubSpot Marketplace, aby zainstalować aplikację

   1. Otwórz projekt

      W HubSpot kliknij Rozwój, następnie Projekty na pasku bocznym, a następnie nazwę projektu, w którym znajduje się Twoja aplikacja.

   2. Otwórz aplikację

      Na karcie Przegląd projektu, w obszarze Składniki projektu kliknij nazwę aplikacji.

   3. Otwórz kartę Dystrybucja

      Kliknij kartę Dystrybucja.

   4. Zainstaluj aplikację, jeśli jeszcze jej nie masz

      W sekcji „Zarządzaj dystrybucją” znajduje się Twoje aktualne konto HubSpot. Kliknij „Zainstaluj teraz”, sprawdź, czy żądany dostęp odpowiada skonfigurowanym zakresom odczytu, a następnie kliknij „Połącz aplikację”.

      Aplikację statycznego tokena można zainstalować tylko na jednym standardowym koncie HubSpot na raz.

   5. Pokaż i skopiuj token

      Po zainstalowaniu, na karcie Dystrybucja pojawi się token dostępu. Kliknij „Pokaż”, aby go wyświetlić, skopiuj go i wklej do pola Token dostępu do aplikacji, jak w kroku głównym 14.

      Jeśli później zmienisz zakresy aplikacji, zainstaluj ją ponownie, korzystając z adresu URL ponownej instalacji na karcie Dystrybucja. W przeciwnym razie nowe zakresy nie zostaną zastosowane.

   Uprawnienia do udzielenia

   Ratunek	Dostęp	Używany do
   crm.obiekty.kontakty.odczyt	Czytać	Wymagane. hubspot.contacts, a także tabele aktywności hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks i hubspot.communications (interfejsy API aktywności HubSpot korzystają z tego zakresu) oraz pola kontaktów w hubspot.properties i hubspot.associations.
   crm.obiekty.firmy.odczyt	Czytać	Wymagane. hubspot.companies oraz pola firmy w hubspot.properties i hubspot.associations.
   crm.obiekty.transakcje.odczyt	Czytać	Wymagane. hubspot.deals, potoki transakcji w hubspot.pipelines i hubspot.pipeline_stages oraz pola transakcji w hubspot.properties i hubspot.associations.
   crm.obiekty.właściciele.odczyt	Czytać	Wymagane. hubspot.owners, użytkownicy HubSpot, którzy są właścicielami rekordów, dzięki czemu transakcje i kontakty mogą być dołączane do nazwiska przedstawiciela.
   crm.objects.bilety.odczyt	Czytać	Tylko jeśli zsynchronizujesz bilety: hubspot.tickets i potoki biletów w hubspot.pipelines i hubspot.pipeline_stages. Starsze aplikacje mogą zamiast tego wyświetlać zakres starszych biletów, co również pozwala na wprowadzanie zmian.
   crm.objects.products.read	Czytać	Tylko jeśli synchronizujesz Produkty: hubspot.products. Wyszukaj produkty w selektorze; API produktów HubSpot akceptuje ten zakres, chociaż strona referencyjna zakresu HubSpot jeszcze go nie zawiera.
   crm.objects.elementy_linii.odczyt	Czytać	Tylko w przypadku synchronizacji pozycji zamówienia, podatków, rabatów lub opłat: hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees.
   crm.objects.cytaty.odczyt	Czytać	Tylko jeśli synchronizujesz Cytaty: hubspot.quotes.
   crm.objects.faktury.odczyt	Czytać	Tylko w przypadku synchronizacji faktur: hubspot.invoices.
   crm.objects.subskrypcje.odczyt	Czytać	Tylko w przypadku synchronizacji Subskrypcji: hubspot.subscriptions (subskrypcje handlowe HubSpot).
   crm.objects.commercepayments.read	Czytać	Tylko w przypadku synchronizacji Płatności: hubspot.payments (płatności handlowe HubSpot).
   crm.objects.marketing_events.read	Czytać	Tylko w przypadku synchronizacji zdarzeń marketingowych: hubspot.marketing_events.
   formularze	Odczyt i zapis (HubSpot nie ma zakresu formularzy tylko do odczytu)	Tylko w przypadku synchronizacji formularzy lub przesłań formularzy: hubspot.forms i hubspot.form_submissions. Strumienie zapytań tylko je odczytują.
   crm.objects.feedback_submissions.read	Czytać	Tylko jeśli synchronizujesz Feedback: hubspot.feedback_submissions. Tylko Service Hub Professional lub Enterprise. Zakres odniesienia HubSpot to crm.objects.feedback_submission.read, więc wyszukaj feedback w selektorze.
   crm.lists.read	Czytać	Tylko w przypadku synchronizacji list: hubspot.lists.
   automatyzacja	Odczyt i zapis (HubSpot nie ma zakresu przepływów pracy przeznaczonych wyłącznie do odczytu)	Tylko w przypadku synchronizacji przepływów pracy: hubspot.workflows. Dotyczy tylko kont Professional i Enterprise. Strumienie zapytań odczytują tylko definicje przepływów pracy.
   crm.schemas.custom.read	Czytać	Tylko w przypadku synchronizacji schematów niestandardowych: hubspot.schemas (definicje obiektów niestandardowych). Dotyczy tylko kont korporacyjnych.

   Wklej do strumieni zapytań

   Token dostępu do aplikacji

   Klucz usługi skopiowany w kroku 13 (zaczyna się od pat-), starszy prywatny token aplikacji lub statyczny token uwierzytelniania aplikacji platformy programistycznej

   Typowe problemy

   Test połączenia kończy się niepowodzeniem z powodu nieprawidłowego lub wygasłego tokena dostępu, zaraz po wklejeniu nowego klucza.

   Dlaczego: Wartość ta nie jest kluczem aplikacji ani usługi. Częstym błędem jest klucz dostępu osobistego lub klucz API dla programistów, które znajdują się obok kluczy usług w obszarze Programowanie → Klucze i są przeznaczone dla narzędzi programistycznych HubSpot.

   Naprawić: Przejdź do sekcji Rozwój → Klucze → Klucze usług, otwórz swój klucz, kliknij Pokaż, następnie Kopiuj i wklej go do tokenu dostępu do aplikacji. Przetestuj połączenie ponownie; wyświetla się komunikat Połączono.

   Jeszcze przed rozpoczęciem testów kreator wyświetla komunikat „Token aplikacji HubSpot nie jest prawidłowy”.

   Dlaczego: Wklejono tylko część klucza: tekst nie zaczyna się od pat-, jest bardzo krótki lub zawiera spację.

   Naprawić: Wróć do HubSpot i kliknij Pokaż, a następnie użyj opcji Kopiuj łącze (nie zaznaczaj tekstu ręcznie) i wklej ponownie.

   Nie widać sekcji Development w nawigacji po lewej stronie HubSpot lub brakuje opcji Service Keys w sekcji Keys.

   Dlaczego: Twój użytkownik HubSpot nie jest superadministratorem i nie ma uprawnień dostępu do narzędzi programistycznych.

   Naprawić: Poproś superadministratora w swojej firmie o utworzenie klucza (kroki od 2 do 13) i wklejenie go do kreatora lub o udzielenie Ci dostępu do narzędzi programistycznych.

   Połączenie testowe wskazuje, że jest połączone, ale jedna z tabel nie synchronizuje się z powodu błędu Forbidden lub pozostaje pusta.

   Dlaczego: Kluczem jest brak zakresu odczytu dla tej tabeli lub Twój plan HubSpot nie obejmuje tej funkcji (Workflows wymaga wersji Professional lub Enterprise; Custom Schemas wymaga wersji Enterprise; Feedback wymaga wersji Professional lub Enterprise dla Service Hub).

   Naprawić: Otwórz klucz (Rozwój → Klucze → Klucze usług → nazwa klucza), kliknij Edytuj, dodaj zakres z listy Uprawnienia i zapisz, a następnie ponownie zsynchronizuj. Jeśli Twój plan nie obejmuje tej funkcji, wyłącz tę tabelę w ustawieniach synchronizacji połączenia.

   Synchronizacje, które wcześniej działały, zaczynają kończyć się niepowodzeniem z powodu nieprawidłowego lub wygasłego tokena dostępu.

   Dlaczego: Ktoś dokonał rotacji lub usunął klucz. Rotacja i wygaśnięcie teraz natychmiast zatrzymuje stary klucz; Rotacja i wygaśnięcie później zatrzymuje go po 7 dniach.

   Naprawić: Skopiuj aktualny klucz z sekcji Rozwój → Klucze → Klucze usług → nazwa klucza → Pokaż → Kopiuj. W Agentach danych edytuj połączenie HubSpot, wklej je do Tokenu dostępu do aplikacji i uruchom połączenie testowe.

   W przypadku starszego prywatnego tokena aplikacji niektóre tabele kończą się błędem USER_DOES_NOT_HAVE_PERMISSIONS.

   Dlaczego: Użytkownik HubSpot, który utworzył prywatną aplikację, został usunięty z konta.

   Naprawić: Obróć token aplikacji (Rozwój → Starsze aplikacje → aplikacja → Obróć) i wklej nowy token do połączenia lub utwórz klucz usługi.

   Nie można znaleźć opcji Utwórz starszą aplikację ani nazwać prywatnych aplikacji starszymi.

   Dlaczego: HubSpot wycofuje tworzenie nowych, starszych aplikacji prywatnych (funkcja ta jest już wyłączona dla kont utworzonych 28 września 2026 r. lub później; dla starszych kont będzie wyłączona od 26 października 2026 r.). Istniejące aplikacje prywatne nadal działają.

   Naprawić: Utwórz klucz usługi (główne kroki). Istniejące prywatne tokeny aplikacji mogą pozostać bez zmian.

   Dane w strumieniach zapytań nie odpowiadają tym, które widzisz w HubSpot.

   Dlaczego: Klucz został utworzony na innym koncie HubSpot (na przykład na koncie testowym lub sandbox).

   Naprawić: Przejdź do właściwego konta HubSpot, utwórz tam klucz i wklej go do połączenia.

   Granice, które należy znać

   • Limity HubSpot dla kluczy usług i aplikacji prywatnych: 100 żądań na 10 sekund na klucz w wersji Free i Starter, 190 w wersji Professional i Enterprise, 250 z dodatkiem API Limit Increase. Agent dostosowuje się do najniższego z tych limitów, więc pierwsza pełna synchronizacja dużego systemu CRM może zająć trochę czasu.
   • Dzienny limit na konto HubSpot: 250 000 zapytań w wersji Free i Starter, 625 000 w wersji Professional, 1 000 000 w wersji Enterprise. Jest on współdzielony przez wszystkie prywatne aplikacje i klucze usług na koncie, więc inne integracje korzystają z tego samego budżetu.
   • Wyszukiwarka CRM HubSpot, z której korzysta agent w celu pobierania wyłącznie zmienionych rekordów, pozwala na 5 żądań na sekundę na konto i maksymalnie 10 000 wyników na zapytanie.
   • Niektóre tabele zależą od Twojego planu HubSpot: Przepływy pracy (Professional lub Enterprise), Schematy niestandardowe (Enterprise), Opinie (Service Hub Professional lub Enterprise).
   • Klucze serwisowe są w fazie publicznej wersji beta (od 10 lutego 2026 r.), więc HubSpot może zmieniać szczegóły. HubSpot zaleca rotację kluczy co sześć miesięcy.
   • Nowych starszych aplikacji prywatnych nie można tworzyć na kontach utworzonych 28 września 2026 r. lub później, ani na kontach utworzonych od 26 października 2026 r. Istniejące aplikacje i tokeny nadal działają.

   Kroki zweryfikowano 8 października 2026 r. Źródła: developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/changelog/service-keys, developers.hubspot.com/blog/hubspot-service-keys-the-righ…, developers.hubspot.com/changelog/legacy-private-app-creat…, developers.hubspot.com/docs/apps/legacy-apps/private-apps…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/getting-started/developer-ove…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/developer-tooling/platform/us…, developers.hubspot.com/docs/api-reference/latest/crm/sear…, knowledge.hubspot.com/user-management/hubspot-user-permis…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/pipe…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/automati…, developers.hubspot.com/docs/api-reference/legacy/marketin…, developers.hubspot.com/docs/api-reference/legacy/account/…, docs.n8n.io/integrations/builtin/credentials/hubspot.

   Nazwa połączenia

   Jakąkolwiek nazwę, którą później rozpoznasz, np. Baza danych sprzedaży.

   Token dostępu do aplikacji

   Token prywatnej aplikacji HubSpot (nazwa zaczyna się od pat-), który znajdziesz w Ustawieniach, Integracje, Aplikacje prywatne, Twojej aplikacji, karcie Autoryzacja.

   Kliknij Połączenie testowe. Kiedy to czyta Połączony, kliknij ZapiszPołączenie zostanie nawiązane z Twoim agentem w ciągu kilku sekund.

   Otwarte Agenci Danych

   Test nieudany? Zwykle brak uprawnień lub dane uwierzytelniające z niewłaściwego konta HubSpot. Powyższy opis przedstawia typowe problemy i ich rozwiązania.

4. See your data in Query Builder Fakultatywny

   You can look at your HubSpot account before Excel is involved at all. Open Kreator zapytań in the portal and pick the connection you just made. The Schemat tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Bieg and the rows appear under Wyniki. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Dodawanie strumieni zapytań do programu Excel

   W programie Excel przejdź do Wstaw → Pobierz dodatki, wyszukaj Strumienie zapytańi kliknij Dodaj. Lub otwórz go bezpośrednio z Strumienie zapytań w Microsoft AppSourceNa wstążce pojawi się przycisk „Strumienie zapytań”. Zaloguj się na to samo konto.

   Działa w programie Excel dla usługi Microsoft 365 w systemach Windows i Mac oraz w programie Excel w sieci Web.

6. Przyciągnij swój pierwszy stolik

   Kliknij przycisk Zapytaj strumienie, wybierz Przesyłanie strumieniowe zapytaniai wybierz połączenie, które właśnie utworzyłeś.

   Wpisz zapytanie, które chcesz uruchomić. To zapytanie pobiera kilka kolumn z hubspot.oferty tabela:

   Przykład · SQL

   WYBIERZ nazwę transakcji, etap transakcji, kwotę, datę zamknięcia Z hubspot.deals ZAMÓW WEDŁUG daty zamknięcia OPIS LIMIT 100;

   Pod Arkusz docelowy wybierać Utwórz nowy arkusz, a następnie naciśnij przycisk odtwarzania (strzałka ▶). Wiersze trafią do Excela w ciągu sekundy lub dwóch. Naciśnij go ponownie za każdym razem, gdy dane ulegną zmianie, a arkusz zostanie zaktualizowany.

   Nie znasz SQL? Build it in Kreator zapytań first and paste it here, or pick it from Saved Queries if you saved it.

Dobre następne ruchy

• Zapisz zapytanie w portalu, dzięki czemu możesz go ponownie uruchomić jednym kliknięciem z poziomu programu Excel lub Arkuszy Google.
• Dodaj filtr np. zakres dat, dzięki czemu na to samo zapytanie można odpowiedzieć „w tym miesiącu” bez konieczności edycji.
• Udostępnij wyniki z kolegą. Widzą wiersze, a nie twoje dane uwierzytelniające.

Pytania, które zadają ludzie

Powiązane przewodniki

• HubSpot do Arkuszy Google
• Stripe do Microsoft Excel
• Shopify do Microsoft Excel
• Google Analytics 4 do Microsoft Excel
• Uruchamianie SQL w programie Excel
• Wszystkie przewodniki