> Ciągłe doskonalenie procesów > Od leada do płatności > HubSpot CRM > Szablon danych

Szablon danych dla procesu od leada do płatności

HubSpot CRM

← Wróć do przewodnika ulepszania procesów

Atrybuty procesu od leada do płatności(20) Działania w procesie od leada do płatności(14) Instrukcje eksportu danych(2)

Szablon danych dla procesu od leada do płatności

Ten szablon zawiera wskazówki dotyczące zbierania danych potrzebnych do analizy procesu od leada do płatności. Wskazuje najważniejsze atrybuty i działania, które należy wyeksportować z systemu źródłowego. Dzięki tym wskazówkom można przygotować dane do analizy process mining.

Zalecane atrybuty do zebrania
Najważniejsze działania do śledzenia
Wskazówki dotyczące eksportu danych z HubSpot CRM

Pierwszy raz spotykają się Państwo z dziennikiem zdarzeń? Dowiedz się jak utworzyć dziennik zdarzeń na potrzeby process mining.

Pobierz szablon

Atrybuty procesu od leada do płatności

Poniżej przedstawiono zalecane pola danych i najważniejsze atrybuty, które warto uwzględnić w dzienniku zdarzeń, aby dokładnie przeanalizować proces od leada do płatności.

5 Wymagane 7 Zalecane 8 Opcjonalne

	Nazwa	Opis
	Szansa sprzedaży SalesOpportunityId	Unikalny identyfikator szansy sprzedaży, który pełni funkcję identyfikatora case w procesie Lead to Cash.
Opis Identyfikator Sales Opportunity śledzi potencjalną transakcję od jej utworzenia do zakończenia, niezależnie od tego, czy została wygrana, czy przegrana. W process mining ten identyfikator łączy wszystkie powiązane działania, takie jak rozmowy, spotkania, oferty i płatności, w jedną instancję procesu od początku do końca. Analiza procesu według Sales Opportunity pozwala zrozumieć cały przebieg sprzedaży. Ułatwia wykrywanie typowych ścieżek, wąskich gardeł i odstępstw oraz pokazuje, jak obsługiwane są poszczególne szanse i co wpływa na pomyślny wynik. Dlaczego to ważne To podstawowy identyfikator łączący wszystkie zdarzenia w cyklu sprzedaży. Dzięki niemu można analizować cały proces Lead to Cash dla każdej transakcji. Skąd pobrać To właściwość `dealId` obiektu Deal w HubSpot CRM API. Przykłady 987654321087654321097654321098
	Czas zdarzenia EventTime	Timestamp wskazujący, kiedy wystąpiło działanie lub zdarzenie.
Opis Event Time określa dokładną datę i godzinę każdego działania w procesie, dzięki czemu można ustalić chronologiczną kolejność zdarzeń. Ten timestamp jest niezbędny do obliczania czasu cyklu, czasu trwania i przerw między poszczególnymi krokami. W analizie atrybut ten służy do oceny przebiegu procesu, wykrywania opóźnień i pomiaru przepustowości. Stanowi podstawę analizy czasu, pozwalając szczegółowo sprawdzić, jak jest on wykorzystywany w cyklu sprzedaży i płatności. Dlaczego to ważne Atrybut określa chronologiczną kolejność zdarzeń. Jest to niezbędne do obliczania wskaźników, takich jak czas cyklu, i wykrywania opóźnień w procesie. Skąd pobrać Timestampy pochodzą z różnych właściwości, zależnie od działania. Mogą to być na przykład `createdate` przy utworzeniu transakcji, `closedate` przy jej zamknięciu lub timestampy powiązanych zadań, rozmów i e-maili. Przykłady 2023-04-15T10:00:00Z2023-05-20T14:30:00Z2023-06-01T09:15:00Z
	Działanie ActivityName	Nazwa konkretnego zdarzenia lub zadania, które wystąpiło w procesie Lead to Cash.
Opis Activity Name opisuje krok procesu, na przykład „Opportunity Created”, „Quote Issued” lub „Payment Received”. Działania te są wyodrębniane z różnych zdarzeń i zmian statusu rejestrowanych w HubSpot. Ten atrybut jest podstawą tworzenia mapy procesu, która przedstawia kolejność działań. Analiza ich przepływu pomaga wykrywać różnice w przebiegu procesu, pętle i wąskie gardła, a następnie planować ukierunkowane usprawnienia. Dlaczego to ważne Atrybut określa kroki na mapie procesu, która stanowi podstawę analiz process mining. Bez odrębnych działań nie można zwizualizować ani analizować przepływu procesu. Skąd pobrać Atrybut jest wyznaczany na podstawie różnych danych w HubSpot, w tym zmian etapu Deal, na przykład „Opportunity Qualified”, typów zadań, wyników rozmów oraz powiązanych obiektów, takich jak Quotes i Invoices. Przykłady Utworzenie szansy sprzedażyWysłanie oferty cenowejPodpisanie umowyOtrzymanie płatności
	Ostatnia aktualizacja danych LastDataUpdate	Timestamp wskazujący, kiedy ostatnio odświeżono dane z systemu źródłowego.
Opis Atrybut zapisuje datę ostatniej aktualizacji zbioru danych. Informuje, jak aktualne są analizowane dane, dzięki czemu osoby korzystające z wyników wiedzą, na ile odzwierciedlają one bieżącą sytuację. Jest to szczególnie przydatne w dashboardach i bieżącym monitorowaniu. Użytkownik może sprawdzić aktualność wyników analizy procesu i odróżnić niedawne zmiany od informacji, które straciły aktualność. Dlaczego to ważne Atrybut wskazuje aktualność danych. Jest to niezbędne, aby analizy i dashboardy opierały się na bieżących informacjach. Skąd pobrać Wartość jest generowana i zapisywana w zbiorze danych przy każdym wyodrębnieniu lub odświeżeniu danych. Przykłady 2024-07-21T02:00:00Z
	System źródłowy SourceSystem	System, z którego wyodrębniono dane.
Opis Atrybut wskazuje źródło danych o procesie. W przypadku procesu Lead to Cash jest nim zwykle HubSpot CRM, ale mogą to być również zintegrowane systemy finansowe, z których pochodzą dane o fakturach i płatnościach. Określenie systemu źródłowego jest ważne, gdy dane pochodzą z wielu platform. Ułatwia zarządzanie danymi, rozwiązywanie problemów z ich jakością i zrozumienie środowiska technologicznego procesu. Dlaczego to ważne Atrybut dostarcza ważnych informacji o pochodzeniu danych. Jest to niezbędne przy zarządzaniu danymi i analizach obejmujących wiele zintegrowanych systemów. Skąd pobrać To stała wartość „HubSpot CRM”, którą należy dodać podczas przekształcania danych. Przykłady HubSpot CRM
	Data zamknięcia szansy sprzedaży OpportunityCloseDate	Data zamknięcia szansy sprzedaży, niezależnie od tego, czy została wygrana, czy przegrana.
Opis Opportunity Close Date oznacza zakończenie procesu sprzedaży dla danej transakcji. Datę ustawia się, gdy etap transakcji zmienia się na „Closed Won” lub „Closed Lost”. Ten timestamp jest niezbędny do obliczenia całkowitego czasu cyklu sprzedaży, od utworzenia do zamknięcia transakcji. Wyznacza koniec case i służy do obliczania wielu KPI, takich jak „Average Sales Cycle Time”, które mierzą sprawność procesu sprzedaży. Dlaczego to ważne Atrybut wyznacza koniec cyklu sprzedaży dla danej szansy. Jest niezbędny do obliczenia całkowitego czasu cyklu i pomiaru tempa sprzedaży. Skąd pobrać To właściwość `closedate` obiektu Deal w HubSpot CRM API. Przykłady 2023-07-10T17:00:00Z2023-08-15T11:20:00Z2023-09-05T16:45:00Z
	Etap sprzedaży SalesStage	Bieżący lub historyczny etap szansy sprzedaży w lejku.
Opis Sales Stage określa postęp transakcji w ramach zdefiniowanego procesu sprzedaży, obejmującego etapy takie jak „Qualified”, „Proposal Presented” i „Contract Sent”. Zmiany tego etapu często służą do rejestrowania ważnych działań w dzienniku procesu. Atrybut jest niezbędny do analizy postępu szans sprzedaży i wykrywania wąskich gardeł. Pozwala mierzyć czas spędzony na każdym etapie oraz współczynniki konwersji między etapami. To ważne dane dla dashboardu „Opportunity Stage Progression Metrics”. Dlaczego to ważne Atrybut pokazuje, na jakim etapie lejka sprzedażowego znajduje się szansa. Umożliwia analizę tempa przechodzenia przez lejek i wykrywanie wąskich gardeł na poszczególnych etapach. Skąd pobrać To właściwość `dealstage` obiektu Deal. Zawiera identyfikator etapu, który należy powiązać z jego nazwą. Przykłady Zaplanowanie spotkaniaGotowość do zakupuZaplanowanie prezentacjiWysłanie umowy
	Opiekun szansy sprzedaży OpportunityOwner	Przedstawiciel handlowy przypisany do szansy sprzedaży i odpowiedzialny za jej obsługę.
Opis Opportunity Owner to główna osoba kontaktowa i osoba odpowiedzialna za prowadzenie transakcji przez lejek sprzedażowy. Zwykle jest to przedstawiciel handlowy, który utworzył szansę sprzedaży lub któremu ją przypisano. Analiza procesu według Opportunity Owner pomaga ocenić wyniki poszczególnych osób i zespołów. Może ujawnić różnice w strategiach sprzedaży, poziomie aktywności i współczynnikach konwersji przedstawicieli handlowych, dostarczając przydatnych informacji do coachingu i zarządzania zasobami. Dlaczego to ważne Atrybut jest niezbędny do analizy wyników. Pozwala porównywać czas cyklu sprzedaży, odsetek wygranych transakcji i zgodność z procesem wśród przedstawicieli handlowych. Skąd pobrać Odpowiada właściwości `hubspot_owner_id` obiektu Deal. Imię i nazwisko opiekuna należy pobrać z Owners API. Przykłady Jane DoeJohn SmithEmily Jones
	Region Region	Region geograficzny lub obszar przypisany do szansy sprzedaży.
Opis Region określa rynek geograficzny, na którym znajduje się szansa sprzedaży. Może wynikać z lokalizacji klienta lub obszaru przypisanego zespołowi sprzedaży. W HubSpot często jest to właściwość niestandardowa. Ten atrybut pozwala porównywać przebieg sprzedaży w różnych regionach. Analiza może ujawnić regionalne różnice w wynikach, zgodności procesu i zachowaniach klientów. Jest to przydatne przy tworzeniu dashboardu „Regionalne warianty procesu sprzedaży” oraz dostosowywaniu strategii sprzedaży do poszczególnych rynków. Dlaczego to ważne Umożliwia porównywanie wyników i wariantów procesu na różnych rynkach geograficznych, wspierając planowanie strategii regionalnej i standaryzację. Skąd pobrać Zazwyczaj jest to właściwość niestandardowa obiektu Company lub Deal. Dokładną nazwę pola należy sprawdzić w używanej instancji HubSpot. Przykłady Ameryka PółnocnaEuropa, Bliski Wschód i AfrykaAzja i PacyfikAmeryka Łacińska
	Wartość szansy sprzedaży OpportunityAmount	Potencjalna lub rzeczywista wartość pieniężna szansy sprzedaży.
Opis Atrybut określa wartość transakcji. Na wczesnych etapach może to być kwota szacunkowa, a po zamknięciu transakcji wartość końcowa umowy. Jest to podstawowy wskaźnik finansowego wpływu procesu sprzedaży. Analiza Opportunity Amount pozwala podzielić proces według wielkości transakcji i sprawdzić, czy większe transakcje przebiegają inaczej lub wymagają więcej czasu do zamknięcia. Atrybut jest też niezbędny do prognoz finansowych i ustalania priorytetów dla szans o wysokiej wartości. Dlaczego to ważne Atrybut umożliwia finansową analizę lejka sprzedażowego. Pomaga ustalać priorytety dla transakcji o wysokiej wartości i sprawdzać, jak wielkość transakcji wpływa na przebieg procesu. Skąd pobrać To właściwość `amount` obiektu Deal w HubSpot CRM API. Przykłady 50000.0012500.50250000.00
	Wynik szansy sprzedaży OpportunityOutcome	Końcowy wynik szansy sprzedaży, wskazujący, czy została wygrana, czy przegrana.
Opis Atrybut określa końcowy status transakcji. Zwykle wynika z ostatniego etapu sprzedaży, sklasyfikowanego jako „Closed Won” lub „Closed Lost”. Podział mapy procesu według wyniku to przydatna technika analityczna. Pozwala bezpośrednio porównać przebieg procesu dla wygranych i przegranych transakcji oraz wykryć wzorce, działania i opóźnienia powiązane z sukcesem lub niepowodzeniem. Te informacje pomagają usprawniać proces i prowadzić coaching zespołu sprzedaży. Dlaczego to ważne Atrybut pozwala porównywać pomyślne i niepomyślne instancje procesu oraz wykrywać, które sposoby działania wiążą się z wygrywaniem transakcji. Skąd pobrać Atrybut jest wyznaczany na podstawie właściwości `dealstage`. Etapy w HubSpot są określane jako „Open”, „Closed Won” lub „Closed Lost”. Wynik zależy od kategorii ostatniego etapu. Przykłady WygranaPrzegrana
	Źródło pozyskania leada LeadSource	Pierwotne źródło lub kanał, z którego pozyskano leada.
Opis Źródło pozyskania leada wskazuje, w jaki sposób potencjalny klient po raz pierwszy nawiązał kontakt z firmą, na przykład przez webinar, targi lub wyszukiwarkę. Informacja ta pomaga ocenić skuteczność poszczególnych kanałów marketingowych. Atrybut jest potrzebny do dashboardu „Współczynnik konwersji leadów w szanse sprzedaży”. Analiza konwersji i długości cyklu sprzedaży według źródła leada pomaga zespołom marketingu i sprzedaży ustalić, które kanały przynoszą najbardziej wartościowe szanse, a następnie odpowiednio rozdysponować budżet marketingowy. Dlaczego to ważne Pomaga ocenić skuteczność kanałów marketingowych przez analizę konwersji i jakości szans sprzedaży pochodzących z różnych źródeł. Skąd pobrać Informacje te są często zapisane w pierwotnym obiekcie Contact i mogą być kopiowane do niestandardowej właściwości obiektu Deal. Często używaną właściwością jest `hs_analytics_source`. Przykłady Wyszukiwanie organicznePłatne media społecznościowePolecenieTargi
	Czas cyklu płatności PaymentCycleTime	Czas od wysłania faktury do otrzymania płatności.
Opis Czas cyklu płatności mierzy sprawność procesu obsługi należności. Oblicza się go jako różnicę między znacznikiem czasu aktywności „Otrzymano płatność” a znacznikiem czasu aktywności „Wystawiono fakturę”. Ten wskaźnik jest potrzebny do pomiaru KPI „Średni czas odzyskiwania należności” i analizy przepływów pieniężnych. Pomaga wykrywać wąskie gardła w procesie odzyskiwania należności. Można go analizować według klientów lub warunków płatności, aby znaleźć możliwości usprawnień. Dlaczego to ważne Mierzy sprawność procesu odzyskiwania należności, która ma istotne znaczenie dla utrzymania płynności finansowej. Skąd pobrać Pole obliczane: znacznik czasu aktywności „Otrzymano płatność” minus znacznik czasu aktywności „Wystawiono fakturę”. Źródłem znaczników czasu jest zintegrowany system finansowy. Przykłady 28 dni45 dni10 dni
	Nazwa klienta CustomerName	Nazwa firmy lub organizacji powiązanej z szansą sprzedaży.
Opis Nazwa klienta wskazuje obecnego lub potencjalnego klienta, którego dotyczy transakcja. Informacje te są zwykle zapisane w powiązanym obiekcie Company w HubSpot. Analiza procesu w podziale na klientów pozwala wykryć wzorce charakterystyczne dla poszczególnych firm, na przykład dłuższe cykle płatności lub odmienny przebieg sprzedaży. Jest szczególnie przydatna w zarządzaniu kluczowymi klientami i ocenie procesu w różnych segmentach klientów. Dlaczego to ważne Umożliwia analizę z perspektywy klienta i pomaga wykrywać wzorce lub problemy dotyczące konkretnych klientów albo branż. Skąd pobrać Dane pochodzą z obiektu Company powiązanego z Deal. Właściwość w obiekcie Company to zazwyczaj `name`. Przykłady Global Tech Inc.Innovate Solutions Ltd.Enterprise Corp
	Numer faktury InvoiceNumber	Unikalny identyfikator faktury wystawionej do zamówienia sprzedaży.
Opis Numer faktury służy do identyfikacji dokumentu wysłanego klientowi. Zazwyczaj jest nadawany po realizacji zamówienia i oznacza ważny etap procesu odzyskiwania należności. HubSpot nie jest przede wszystkim systemem do fakturowania, ale te dane są potrzebne do śledzenia końcowych etapów procesu od leada do płatności. Łączą szansę sprzedaży z transakcją finansową, umożliwiając analizę przekazania sprawy ze sprzedaży do finansów oraz pomiar KPI „Czas od wystawienia faktury do uzyskania przychodu”. Dlaczego to ważne Łączy proces sprzedaży z procesem odzyskiwania należności i pozwala ocenić sprawność przekazywania spraw między działami sprzedaży i finansów. Skąd pobrać Dane zwykle pochodzą ze zintegrowanego systemu księgowego lub ERP, takiego jak NetSuite czy QuickBooks, i są powiązane z obiektem Deal w HubSpot za pomocą obiektu lub właściwości niestandardowej. Przykłady INV-2023-00123INV-2023-00456INV-2023-00789
	Procent rabatu DiscountPercentage	Procent rabatu udzielonego w ramach szansy sprzedaży, jeśli został przyznany.
Opis Atrybut określa rabat udzielony klientowi jako procent całkowitej wartości transakcji. Zwykle jest zapisywany podczas przygotowywania oferty lub końcowych negocjacji. Analiza procentu rabatu jest potrzebna do dashboardu „Analiza skuteczności rabatów”. Pozwala ocenić wpływ rabatów na współczynnik wygranych transakcji i długość cyklu sprzedaży. Pomaga też ustalić, czy poszczególni przedstawiciele handlowi lub regiony nie udzielają zbyt wysokich rabatów, które mogą obniżać rentowność. Dlaczego to ważne Pomaga ocenić wpływ strategii cenowych na wyniki sprzedaży i rentowność oraz sprawdzić, czy rabaty są stosowane skutecznie. Skąd pobrać Zazwyczaj jest to właściwość niestandardowa obiektu Deal lub Quote, ponieważ HubSpot nie udostępnia standardowego pola rabatu w obiekcie Deal. Wartość może być też obliczana na podstawie pozycji zamówienia. Przykłady 0.050.100.150.20
	Rodzina produktów ProductFamily	Kategoria lub rodzina produktów uwzględnionych w szansie sprzedaży.
Opis Rodzina produktów klasyfikuje transakcję według rodzaju sprzedawanego produktu lub usługi. Zazwyczaj ustala się ją na podstawie pozycji powiązanych z transakcją. Atrybut pozwala analizować proces sprzedaży dla różnych kategorii produktów. Cykl sprzedaży niektórych produktów może być dłuższy lub bardziej złożony. Podział na kategorie ujawnia te różnice i pomaga dostosować proces sprzedaży oraz poprawić dokładność prognoz. Dlaczego to ważne Podział procesu według rodzin produktów może ujawnić różnice w długości cyklu sprzedaży i jego przebiegu dla poszczególnych produktów, co pomaga opracować odpowiednie strategie. Skąd pobrać Wartość należy wyznaczyć na podstawie pozycji powiązanych z obiektem Deal. Wymaga to reguł przypisujących produkty do rodzin. Przykłady Licencja na oprogramowanieUsługi profesjonalneSprzętSubskrypcja wsparcia
	Transakcja utknęła IsStalled	Flaga wskazująca, czy otwarta szansa sprzedaży zbyt długo pozostaje na obecnym etapie.
Opis Ten atrybut ma wartość logiczną. Przyjmuje wartość prawda, jeśli szansa sprzedaży nie przeszła do kolejnego etapu w określonym czasie. Definicja tego, co oznacza „utknięcie”, zależy od reguł biznesowych, na przykład ponad 30 dni na etapie „Oferta”. Flaga pomaga z wyprzedzeniem wykrywać zagrożone transakcje, które mogą wymagać interwencji. Jest podstawą KPI „Odsetek transakcji, które utknęły” i pomaga menedżerom sprzedaży skupić uwagę na szansach tracących dynamikę. Dlaczego to ważne Pozwala z wyprzedzeniem wykrywać zagrożone szanse sprzedaży, które nie posuwają się naprzód, i interweniować, zanim transakcja zostanie utracona. Skąd pobrać Pole obliczane na podstawie bieżącej daty, daty wejścia transakcji na obecny etap (`hs_lastmodifieddate`) oraz reguł biznesowych określających dopuszczalny czas na każdym etapie. Przykłady truefalse
	Warunki płatności PaymentTerms	Uzgodnione warunki płatności, na przykład 30 lub 60 dni.
Opis Warunki płatności określają, w jakim terminie klient powinien zapłacić za towary lub usługi. Zazwyczaj ustala się je na etapie zawierania umowy. Atrybut jest przydatny w analizie czasu cyklu płatności. Porównanie terminowości płatności z uzgodnionymi warunkami pomaga wykryć klientów, którzy regularnie płacą po terminie, oraz sprawdzić, czy określone warunki wiążą się z dłuższym okresem oczekiwania na należność. Dlaczego to ważne Dostarcza kontekstu do analizy cyklu płatności i pozwala odróżnić oczekiwany termin zapłaty od rzeczywistego opóźnienia. Skąd pobrać Zazwyczaj jest to właściwość niestandardowa obiektu Deal lub Quote albo dane pobrane ze zintegrowanego systemu księgowego. Przykłady 30 dni60 dniPłatność przy odbiorze
	Zespół sprzedaży SalesTeam	Zespół, do którego należy właściciel szansy sprzedaży.
Opis Zespół sprzedaży grupuje właścicieli poszczególnych szans, często według regionu, rodzaju produktu lub segmentu rynku. Umożliwia to analizę wyników na poziomie całego zespołu. Analiza na tym poziomie pomaga menedżerom oceniać skuteczność zespołów, porównywać strategie i przydzielać zasoby. Daje szerszy obraz niż analiza poszczególnych właścicieli i ułatwia wykrywanie ogólnych trendów w realizacji procesu. Dlaczego to ważne Umożliwia zbiorczą analizę wyników zespołów, dzięki czemu menedżerowie mogą porównywać przebieg procesu i jego rezultaty w różnych zespołach sprzedaży. Skąd pobrać `team_id` jest właściwością obiektu Owner. Nazwę zespołu należy pobrać przez połączenie z Teams API. Przykłady Sprzedaż korporacyjna, wschódSprzedaż dla małych i średnich firm, zachódSprzedaż dla średnich firm, centrum

Wymagane Zalecane Opcjonalne

Działania w procesie od leada do płatności

Poniżej przedstawiono etapy procesu i ważne punkty, które warto uwzględnić w dzienniku zdarzeń, aby dokładnie odkryć przebieg procesu od leada do płatności.

7 Zalecane 7 Opcjonalne

	Działanie	Opis
	Kwalifikacja szansy sprzedaży	Oznacza moment, w którym zespół sprzedaży zakwalifikował szansę i potwierdził, że spełnia ona określone kryteria, takie jak budżet, decyzyjność, potrzeba i termin. Zwykle wnioskuje się o tym na podstawie zmiany etapu transakcji na określony etap, na przykład „Qualified”.
Dlaczego to ważne To ważny punkt kontrolny przy ocenie jakości lejka sprzedażowego. Analiza czasu potrzebnego na kwalifikację pomaga wykryć możliwości usprawnienia początkowych etapów procesu sprzedaży. Skąd pobrać Zdarzenie ustala się na podstawie historii zmian właściwości „Deal Stage” obiektu Deal, a konkretnie timestampu przejścia do etapu takiego jak „Qualified to Buy”. Rejestrowanie Timestamp zmiany Deal Stage na wyznaczony etap „Qualified”. Typ zdarzenia inferred
	Otrzymanie płatności	To ostatni etap cyklu Lead to Cash. Oznacza otrzymanie i uzgodnienie płatności od klienta. Zwykle jest ona śledzona w zewnętrznym systemie księgowym, a następnie synchronizowana z HubSpot.
Dlaczego to ważne To końcowe zdarzenie procesu uzyskania przychodu. Jest niezbędne do obliczenia „Average Payment Collection Time” i „End-to-End Lead to Cash Cycle Time”. Skąd pobrać Zdarzenie ustala się na podstawie aktualizacji niestandardowej właściwości, takiej jak „Payment Date”, zsynchronizowanej z systemu finansowego, albo ręcznej zmiany etapu w dedykowanym lejku. Rejestrowanie Timestamp z niestandardowej właściwości „Payment Date”, aktualizowanej przez integrację. Typ zdarzenia inferred
	Podpisanie umowy	To działanie oznacza sfinalizowanie umowy handlowej przez podpisanie jej przez klienta. W HubSpot jest często rejestrowane, gdy po zaakceptowaniu oferty transakcja przechodzi do etapu „Contract Sent” lub „Closed Won”.
Dlaczego to ważne To ostatni punkt kontrolny dotyczący uzgodnień handlowych przed rozpoczęciem realizacji. Jest niezbędny do obliczenia KPI „Quote to Contract Cycle Time”. Skąd pobrać Zdarzenie można ustalić na podstawie timestampu zmiany właściwości Deal Stage na „Contract Signed” lub równoważny etap. Jeśli oferta jest podpisywana elektronicznie, zdarzenie może być równoznaczne z „Quote Accepted”. Rejestrowanie Timestamp zmiany Deal Stage na „Contract Signed” lub podobny etap. Typ zdarzenia inferred
	Przegrana szansa sprzedaży	To końcowe zdarzenie oznaczające niepowodzenie, gdy transakcja zostaje oficjalnie przegrana i zamknięta. Jest rejestrowane bezpośrednio, gdy użytkownik przenosi transakcję do etapu „Closed Lost”.
Dlaczego to ważne Analiza tego, kiedy i dlaczego transakcje są przegrywane, ma duże znaczenie dla usprawniania procesu. To zdarzenie wyznacza punkt końcowy do obliczenia czasu cyklu sprzedaży dla przegranych transakcji. Skąd pobrać Timestamp w standardowej właściwości „Close Date”, gdy właściwość „Deal Stage” zostaje ustawiona na dowolny etap z kategorii „Lost”. Kontekst zapewnia właściwość „Closed Lost Reason”. Rejestrowanie Właściwość „Close Date” obiektu Deal, gdy transakcja zakończyła się przegraną. Typ zdarzenia explicit
	Utworzenie szansy sprzedaży	To pierwsze zdarzenie w cyklu życia szansy sprzedaży. Oznacza utworzenie nowego rekordu transakcji w HubSpot. Zdarzenie jest rejestrowane bezpośrednio, gdy użytkownik ręcznie tworzy transakcję lub gdy powstaje ona automatycznie za pośrednictwem workflow albo integracji.
Dlaczego to ważne To działanie wyznacza oficjalny początek cyklu sprzedaży dla danej szansy. Zapisany timestamp służy do obliczania całkowitego czasu cyklu sprzedaży i tempa przekształcania leadów w szanse sprzedaży. Skąd pobrać Zdarzenie jest rejestrowane automatycznie. Timestamp znajduje się w standardowej właściwości „Create Date” obiektu Deal. Rejestrowanie Właściwość „Create Date” rekordu Deal. Typ zdarzenia explicit
	Wygrana szansa sprzedaży	To końcowe zdarzenie oznaczające sukces, gdy transakcja zostaje oficjalnie wygrana i zamknięta. Jest to standardowe zdarzenie HubSpot, rejestrowane bezpośrednio, gdy użytkownik przenosi transakcję do etapu „Closed Won”.
Dlaczego to ważne To działanie oznacza pomyślny wynik i wyznacza ważny punkt końcowy przy pomiarze czasu cyklu sprzedaży oraz odsetka wygranych transakcji. Często uruchamia dalsze procesy realizacji zamówienia i fakturowania. Skąd pobrać Timestamp zapisany w standardowej właściwości „Close Date”, gdy właściwość „Deal Stage” zostaje ustawiona na dowolny etap z kategorii „Won”. Rejestrowanie Właściwość „Close Date” obiektu Deal, gdy transakcja zakończyła się wygraną. Typ zdarzenia explicit
	Wysłanie oferty cenowej	To działanie oznacza przygotowanie i wysłanie klientowi formalnej oferty cenowej. HubSpot Sales Hub ma dedykowane narzędzie Quotes. Zdarzenie jest rejestrowane bezpośrednio po utworzeniu i opublikowaniu oferty dla transakcji.
Dlaczego to ważne To ważny punkt kontrolny, który wskazuje na zamiar zawarcia transakcji. Analiza czasu od kwalifikacji do wysłania oferty ma zasadnicze znaczenie dla analizy przepływu procesu od oferty do umowy („Quote to Contract Process Flow”). Skąd pobrać Timestamp utworzenia obiektu Quote powiązanego z Deal. Właściwość „hs_createdate” obiektu Quote. Rejestrowanie Data utworzenia powiązanego obiektu Quote. Typ zdarzenia explicit
	Akceptacja oferty cenowej	Zdarzenie występuje, gdy klient formalnie akceptuje ofertę, często składając podpis elektroniczny. Jest rejestrowane bezpośrednio, gdy klient podpisuje ofertę wysłaną za pomocą funkcji podpisu elektronicznego HubSpot.
Dlaczego to ważne Oznacza zgodę klienta na warunki i cenę, czyli ważny sygnał gotowości do zakupu. Czas między wysłaniem a akceptacją oferty jest istotny przy analizie długości negocjacji. Skąd pobrać Właściwość „hs_quote_accepted_date” obiektu Quote lub timestamp zakończenia z dziennika podpisu elektronicznego powiązanego z ofertą. Rejestrowanie Timestamp z właściwości „hs_quote_accepted_date” obiektu Quote. Typ zdarzenia explicit
	Pierwszy kontakt	Oznacza pierwszą zarejestrowaną interakcję z osobami powiązanymi z transakcją, na przykład rozmowę telefoniczną, e-mail lub spotkanie. Informacja ta jest zapisywana na osi czasu działań powiązanej z rekordem Deal w HubSpot.
Dlaczego to ważne Pomiar czasu od utworzenia transakcji do pierwszego kontaktu pozwala ocenić szybkość reakcji zespołu sprzedaży. Analiza rodzaju pierwszego kontaktu może ujawnić wzorce występujące w zakończonych sukcesem transakcjach. Skąd pobrać Timestamp pierwszego zarejestrowanego działania, na przykład rozmowy telefonicznej, e-maila lub spotkania, powiązanego z obiektem Deal po dacie jego utworzenia. Rejestrowanie Timestamp pierwszego zarejestrowanego działania na osi czasu Deal. Typ zdarzenia explicit
	Przedstawienie rozwiązania	Oznacza moment przedstawienia klientowi formalnego rozwiązania lub demonstracji produktu. Zwykle wnioskuje się o nim na podstawie zmiany Deal Stage na etap taki jak „Presentation Scheduled” lub „Demo Completed”.
Dlaczego to ważne To ważny punkt kontrolny w środkowej części lejka sprzedażowego. Pomiar czasu do tego momentu pomaga ocenić sprawność etapu opracowywania rozwiązania. Skąd pobrać Zdarzenie ustala się na podstawie timestampu zmiany właściwości Deal Stage na odpowiedni etap, na przykład „Presentation Scheduled”, w historii właściwości transakcji. Rejestrowanie Timestamp zmiany Deal Stage na etap „Presentation” lub „Proposal”. Typ zdarzenia inferred
	Realizacja zamówienia	Oznacza zakończenie dostawy produktu lub świadczenia usługi na rzecz klienta. Zdarzenie zwykle występuje poza HubSpot i jest rejestrowane przez integrację albo ręczną zmianę Deal Stage na „Service Delivered” lub „Order Complete”.
Dlaczego to ważne Oznacza zakończenie etapu dostawy. Od tego momentu mierzy się KPI „Order Fulfillment to Invoice Time”. Skąd pobrać Wymaga integracji z systemem ERP lub systemem realizacji zamówień albo ręcznej aktualizacji. Zdarzenie można ustalić na podstawie timestampu przejścia transakcji do etapu takiego jak „Fulfilled”. Rejestrowanie Timestamp zmiany statusu w systemie zewnętrznym lub ręcznej zmiany etapu. Typ zdarzenia inferred
	Utworzenie zamówienia sprzedaży	Oznacza wewnętrzne przekazanie sprawy z zespołu sprzedaży do zespołu realizacji lub operacji. Zwykle nie jest to natywne zdarzenie HubSpot. Wnioskuje się o nim na podstawie przejścia transakcji do określonego etapu lejka, takiego jak „Order Processing” lub „Pending Fulfillment”.
Dlaczego to ważne To działanie ma duże znaczenie przy ocenie sprawności przekazania sprawy z zespołu sprzedaży do zespołu operacji. Opóźnienia mogą wpływać na zadowolenie klientów i terminy dostaw. Skąd pobrać Zdarzenie ustala się na podstawie historii zmian właściwości „Deal Stage”, zapisując timestamp przejścia do etapu po sprzedaży. Rejestrowanie Timestamp zmiany Deal Stage na etap „Order Processing”. Typ zdarzenia inferred
	Wystawienie faktury	Oznacza utworzenie faktury dla klienta w systemie księgowym. To działanie nie jest dostępne natywnie w HubSpot Sales Hub. Można je rejestrować za pomocą integracji, która aktualizuje niestandardową właściwość lub etap Deal.
Dlaczego to ważne To ważny etap cyklu konwersji gotówki. Czas od realizacji zamówienia do wystawienia faktury bezpośrednio wpływa na to, jak szybko firma może rozliczyć swoje usługi. Skąd pobrać Wymaga integracji z systemem księgowym, takim jak QuickBooks lub Xero. Zdarzenie można ustalić na podstawie timestampu niestandardowej właściwości lub zmiany etapu transakcji. Rejestrowanie Timestamp z niestandardowej właściwości daty, takiej jak „Invoice Generated Date”. Typ zdarzenia inferred
	Zebranie wymagań	To działanie oznacza, że odbyła się rozmowa lub spotkanie rozpoznawcze, a potrzeby klienta zostały udokumentowane. Zwykle wnioskuje się o nim na podstawie przejścia transakcji do określonego etapu lejka sprzedażowego, na przykład „Discovery” lub „Needs Analysis”.
Dlaczego to ważne Śledzenie tego punktu kontrolnego pomaga ocenić, jak szybko zespół sprzedaży przechodzi od kwalifikacji do poznania potrzeb klienta. Opóźnienia mogą wskazywać na problemy z planowaniem spotkań lub ograniczoną dostępność zasobów. Skąd pobrać Zdarzenie ustala się na podstawie historii zmian właściwości „Deal Stage”, zapisując timestamp przejścia transakcji do etapu takiego jak „Requirements Gathering”. Rejestrowanie Timestamp zmiany Deal Stage na etap odpowiadający analizie potrzeb. Typ zdarzenia inferred

Zalecane Opcjonalne

Instrukcje eksportu danych

Jak pobrać dane z HubSpot CRM

Kroki

Wymagania wstępne: utworzenie HubSpot Private App
- Zaloguj się do konta HubSpot z uprawnieniami superadministratora.
- Przejdź do Settings > Integrations > Private Apps i kliknij „Create a new private app”.
- Na karcie Basic Info nadaj aplikacji nazwę, na przykład „ProcessMind Extraction”.
- Przejdź do karty Scopes. Przyznaj uprawnienia do odczytu wymaganych obiektów CRM. Wybierz zakresy: crm.objects.deals.read, crm.objects.contacts.read, crm.objects.engagements.read, crm.objects.quotes.read, crm.objects.owners.read.
- Po utworzeniu aplikacji skopiuj wygenerowany token dostępu. Skrypt Python użyje go do uwierzytelnienia w API.
Konfiguracja środowiska Python
- Sprawdź, czy w systemie jest zainstalowany Python 3.6 lub nowszy.
- Utwórz katalog projektu i skonfiguruj środowisko wirtualne.
- Zainstaluj wymagane biblioteki Python, uruchamiając w terminalu polecenie: pip install requests pandas.
Konfiguracja skryptu Python
- Zapisz udostępniony skrypt Python w pliku, na przykład extract_hubspot_log.py.
- Otwórz skrypt i zastąp wartości zastępcze w sekcji konfiguracji u góry. Wprowadź token HubSpot ACCESS_TOKEN oraz daty START_DATE i END_DATE określające zakres eksportu.
Mapowanie etapów transakcji na działania
- Ważnym elementem konfiguracji jest przypisanie identyfikatorów etapów transakcji HubSpot do standardowych działań process mining. W skrypcie znajdź słownik PIPELINE_STAGE_MAPPING.
- Ustal wewnętrzne identyfikatory etapów w lejku sprzedaży. Można je pobrać, wysyłając żądanie API do punktu końcowego Pipelines (/crm/v3/pipelines/deals), lub sprawdzić w adresie URL podczas edycji etapu w interfejsie HubSpot.
- W słowniku wpisz identyfikatory etapów jako klucze, a odpowiadające im nazwy działań jako wartości. Jeśli na przykład etap „Zakwalifikowany” ma identyfikator „12345”, wpis powinien wyglądać tak: '12345': 'Zakwalifikowano szansę sprzedaży'.
Uruchomienie skryptu eksportującego dane
- Otwórz terminal lub wiersz polecenia i przejdź do katalogu, w którym zapisano skrypt.
- Uruchom skrypt poleceniem: python extract_hubspot_log.py.
- Skrypt rozpocznie pobieranie danych z HubSpot API. W konsoli będą wyświetlane informacje o postępie, w tym liczba przetworzonych transakcji.
- Przy dużych zbiorach danych eksport może potrwać dłużej ze względu na limity zapytań API.
Sprawdzenie pliku wynikowego
- Po zakończeniu działania skrypt utworzy w tym samym katalogu plik CSV o nazwie hubspot_event_log.csv.
- Plik zawiera wyeksportowany dziennik zdarzeń z określonymi działaniami i atrybutami.
Przygotowanie do przesłania
- Otwórz plik hubspot_event_log.csv w arkuszu kalkulacyjnym i sprawdź, czy dane są zgodne z oczekiwaniami.
- Plik zawiera wymagane kolumny (SalesOpportunityId, ActivityName, EventTime itd.) i można go bezpośrednio przesłać do ProcessMind.

Konfiguracja

Token HubSpot Private App: Do uwierzytelnienia potrzebny jest prawidłowy token dostępu z HubSpot Private App. Aplikacja musi mieć uprawnienia do odczytu obiektów Deals, Contacts, Engagements, Quotes i Owners.
Zakres dat: Skrypt korzysta ze zmiennych START_DATE i END_DATE. Na początek warto ustawić krótszy zakres, na przykład 3–6 miesięcy, aby ograniczyć czas eksportu i liczbę zapytań API. Daty należy podać w formacie „YYYY-MM-DD”.
Mapowanie etapów lejka: Poprawność działań opartych na etapach, takich jak „Zakwalifikowano szansę sprzedaży” i „Zebrano wymagania”, zależy od słownika PIPELINE_STAGE_MAPPING. Konfiguracja musi odzwierciedlać etapy lejka sprzedaży używane w HubSpot w Państwa organizacji.
Limity zapytań API: HubSpot nakłada limity na API, na przykład 100 zapytań na 10 sekund w planach Professional. Skrypt zawiera podstawowy mechanizm time.sleep(), który pomaga przestrzegać tych limitów. Przy bardzo dużych zbiorach danych i niższych planach może być konieczne wydłużenie przerw między zapytaniami.
Właściwości niestandardowe: Jeśli w HubSpot używane są właściwości niestandardowe do śledzenia atrybutów, takich jak Region, lub działań, takich jak „Wygenerowano fakturę”, należy dodać ich nazwy do listy deal_properties w skrypcie, aby zostały pobrane.

Przykładowe zapytanie python

import requests
import pandas as pd
import datetime
import time
import os

class=class="hl-string">"hl-comment"># --- CONFIGURATION SECTION --- #
class=class="hl-string">"hl-comment"># 1. HubSpot Private App Access Token
ACCESS_TOKEN = class="hl-string">"YOUR_HUBSPOT_ACCESS_TOKEN" class=class="hl-string">"hl-comment"># Replace with your token

class=class="hl-string">"hl-comment"># 2. Date range for the extraction
START_DATE = class="hl-string">"2023-01-01" class=class="hl-string">"hl-comment"># Format: YYYY-MM-DD
END_DATE = class="hl-string">"2023-12-31" class=class="hl-string">"hl-comment"># Format: YYYY-MM-DD

class=class="hl-string">"hl-comment"># 3. Critical: Map your Deal Stage IDs to Process Mining Activities
class=class="hl-string">"hl-comment"># You must find your internal HubSpot stage IDs and map them here.
class=class="hl-string">"hl-comment"># Example: class="hl-string">'123456': class="hl-string">'Opportunity Qualified'
PIPELINE_STAGE_MAPPING = {
    class="hl-string">'[Your Qualified Stage ID]': class="hl-string">'Opportunity Qualified',
    class="hl-string">'[Your Discovery Stage ID]': class="hl-string">'Requirements Gathered',
    class="hl-string">'[Your Presentation Stage ID]': class="hl-string">'Solution Proposed',
    class="hl-string">'[Your Contract Sent Stage ID]': class="hl-string">'Contract Signed',
    class="hl-string">'[Your Order Processing Stage ID]': class="hl-string">'Sales Order Created',
    class="hl-string">'[Your Order Fulfilled Stage ID]': class="hl-string">'Order Fulfilled',
    class="hl-string">'[Your Invoice Sent Stage ID]': class="hl-string">'Invoice Generated',
    class="hl-string">'[Your Payment Received Stage ID]': class="hl-string">'Payment Received',
    class=class="hl-string">"hl-comment"># Standard closed won/lost stages are handled separately by their internal names
    class="hl-string">'closedwon': class="hl-string">'Opportunity Closed Won',
    class="hl-string">'closedlost': class="hl-string">'Opportunity Closed Lost'
}
class=class="hl-string">"hl-comment"># --- END CONFIGURATION SECTION --- #

API_BASE_URL = class="hl-string">"https://api.hubapi.com"
AUTH_HEADER = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {ACCESS_TOKEN}'}

def fetch_paginated_data(url, params=None, body=None):
    class="hl-string">"""Helper function to handle paginated API responses."""
    results = []
    after = None
    while True:
        if body:
            if after:
                body[class="hl-string">'after'] = after
            response = requests.post(url, headers=AUTH_HEADER, json=body)
        else:
            if after:
                params[class="hl-string">'after'] = after
            response = requests.get(url, headers=AUTH_HEADER, params=params)
        
        if response.status_code == 429:
            print(class="hl-string">"Rate limit hit, sleeping for 10 seconds...")
            time.sleep(10)
            continue
        
        response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
        data = response.json()
        results.extend(data.get(class="hl-string">'results', []))
        
        paging = data.get(class="hl-string">'paging')
        if paging and paging.get(class="hl-string">'next'):
            after = paging[class="hl-string">'next'][class="hl-string">'after']
        else:
            break
    return results

def format_timestamp(ts_string):
    class="hl-string">"""Converts HubSpot timestamps to ISO 8601 format."""
    if not ts_string:
        return None
    return pd.to_datetime(ts_string).isoformat()


def main():
    print(class="hl-string">"Starting HubSpot data extraction...")
    event_log = []
    last_data_update = datetime.datetime.now(datetime.timezone.utc).isoformat()

    class=class="hl-string">"hl-comment"># 1. Fetch all deals within the date range
    print(class="hl-string">"Fetching deals...")
    deal_properties = [
        class="hl-string">'dealname', class="hl-string">'createdate', class="hl-string">'dealstage', class="hl-string">'amount', 
        class="hl-string">'closedate', class="hl-string">'dealownerid', class="hl-string">'hs_lead_source', class="hl-string">'region', class="hl-string">'pipeline'
    ]
    search_body = {
        class="hl-string">'filterGroups': [{
            class="hl-string">'filters': [{
                class="hl-string">'propertyName': class="hl-string">'createdate',
                class="hl-string">'operator': class="hl-string">'BETWEEN',
                class="hl-string">'highValue': int(datetime.datetime.strptime(END_DATE, class="hl-string">'%Y-%m-%d').timestamp() * 1000),
                class="hl-string">'value': int(datetime.datetime.strptime(START_DATE, class="hl-string">'%Y-%m-%d').timestamp() * 1000)
            }]
        }],
        class="hl-string">'properties': deal_properties,
        class="hl-string">'limit': 100
    }
    all_deals = fetch_paginated_data(fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/search", body=search_body)
    print(fclass="hl-string">"Found {len(all_deals)} deals.")

    class=class="hl-string">"hl-comment"># Fetch owners for mapping
    owners_map = {owner[class="hl-string">'id']: fclass="hl-string">"{owner['firstName']} {owner['lastName']}" for owner in fetch_paginated_data(fclass="hl-string">"{API_BASE_URL}/crm/v3/owners/")}

    class=class="hl-string">"hl-comment"># 2. Process each deal to create events
    for i, deal in enumerate(all_deals):
        print(fclass="hl-string">"Processing deal {i+1}/{len(all_deals)}: {deal['id']}")
        deal_id = deal[class="hl-string">'id']
        props = deal.get(class="hl-string">'properties', {})
        
        base_event = {
            class="hl-string">'SalesOpportunityId': deal_id,
            class="hl-string">'SourceSystem': class="hl-string">'HubSpot CRM',
            class="hl-string">'LastDataUpdate': last_data_update,
            class="hl-string">'OpportunityAmount': props.get(class="hl-string">'amount'),
            class="hl-string">'OpportunityCloseDate': format_timestamp(props.get(class="hl-string">'closedate')),
            class="hl-string">'LeadSource': props.get(class="hl-string">'hs_lead_source'),
            class="hl-string">'Region': props.get(class="hl-string">'region'),
            class="hl-string">'OpportunityOwner': owners_map.get(props.get(class="hl-string">'dealownerid'))
        }

        class=class="hl-string">"hl-comment"># Activity: Opportunity Created
        event_log.append({
            **base_event,
            class="hl-string">'ActivityName': class="hl-string">'Opportunity Created',
            class="hl-string">'EventTime': format_timestamp(props.get(class="hl-string">'createdate')),
            class="hl-string">'SalesStage': class="hl-string">'Created',
            class="hl-string">'OpportunityOutcome': None
        })

        class=class="hl-string">"hl-comment"># Activities from Stage History
        try:
            stage_history_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/{deal_id}?properties=dealstage&archived=false"
            history_response = requests.get(stage_history_url, headers=AUTH_HEADER)
            history_response.raise_for_status()
            history_data = history_response.json()
            for version in history_data.get(class="hl-string">'propertiesWithHistory', {}).get(class="hl-string">'dealstage', []):
                stage_id = version[class="hl-string">'value']
                if stage_id in PIPELINE_STAGE_MAPPING:
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': PIPELINE_STAGE_MAPPING[stage_id],
                        class="hl-string">'EventTime': format_timestamp(version[class="hl-string">'timestamp']),
                        class="hl-string">'SalesStage': stage_id,
                        class="hl-string">'OpportunityOutcome': None
                    })
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch stage history for deal {deal_id}: {e}")
        
        class=class="hl-string">"hl-comment"># Activities: Closed Won / Closed Lost
        final_stage = props.get(class="hl-string">'dealstage')
        if final_stage in [class="hl-string">'closedwon', class="hl-string">'closedlost']:
             event_log.append({
                **base_event,
                class="hl-string">'ActivityName': PIPELINE_STAGE_MAPPING[final_stage],
                class="hl-string">'EventTime': format_timestamp(props.get(class="hl-string">'closedate')),
                class="hl-string">'SalesStage': class="hl-string">'Closed',
                class="hl-string">'OpportunityOutcome': class="hl-string">'Won' if final_stage == class="hl-string">'closedwon' else class="hl-string">'Lost'
            })

        class=class="hl-string">"hl-comment"># Activities from Associated Objects (Engagements, Quotes)
        try:
            class=class="hl-string">"hl-comment"># Engagements for class="hl-string">'Initial Contact Made'
            assoc_engagements_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/{deal_id}/associations/engagements"
            engagements = fetch_paginated_data(assoc_engagements_url)
            if engagements:
                first_engagement_time = None
                for engagement_assoc in engagements:
                    eng_id = engagement_assoc[class="hl-string">'id']
                    eng_details_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/engagements/{eng_id}?properties=hs_timestamp"
                    eng_res = requests.get(eng_details_url, headers=AUTH_HEADER)
                    if eng_res.ok:
                        eng_ts = eng_res.json()[class="hl-string">'properties'][class="hl-string">'hs_timestamp']
                        if not first_engagement_time or eng_ts < first_engagement_time:
                            first_engagement_time = eng_ts
                if first_engagement_time:
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': class="hl-string">'Initial Contact Made',
                        class="hl-string">'EventTime': format_timestamp(first_engagement_time),
                        class="hl-string">'SalesStage': props.get(class="hl-string">'dealstage'),
                        class="hl-string">'OpportunityOutcome': None
                    })

            class=class="hl-string">"hl-comment"># Quotes for class="hl-string">'Quote Issued' and class="hl-string">'Quote Accepted'
            assoc_quotes_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/{deal_id}/associations/quotes"
            quotes = fetch_paginated_data(assoc_quotes_url)
            for quote_assoc in quotes:
                quote_id = quote_assoc[class="hl-string">'id']
                quote_details_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/quotes/{quote_id}?properties=hs_createdate,hs_quote_status,hs_acceptance_date"
                quote_res = requests.get(quote_details_url, headers=AUTH_HEADER)
                if quote_res.ok:
                    quote_props = quote_res.json()[class="hl-string">'properties']
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': class="hl-string">'Quote Issued',
                        class="hl-string">'EventTime': format_timestamp(quote_props[class="hl-string">'hs_createdate']),
                        class="hl-string">'SalesStage': props.get(class="hl-string">'dealstage'),
                        class="hl-string">'OpportunityOutcome': None
                    })
                    if quote_props.get(class="hl-string">'hs_quote_status') == class="hl-string">'SIGNED' and quote_props.get(class="hl-string">'hs_acceptance_date'):
                        event_log.append({
                            **base_event,
                            class="hl-string">'ActivityName': class="hl-string">'Quote Accepted',
                            class="hl-string">'EventTime': format_timestamp(quote_props[class="hl-string">'hs_acceptance_date']),
                            class="hl-string">'SalesStage': props.get(class="hl-string">'dealstage'),
                            class="hl-string">'OpportunityOutcome': None
                        })
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch associations for deal {deal_id}: {e}")

    class=class="hl-string">"hl-comment"># 3. Create DataFrame and export to CSV
    print(class="hl-string">"Finalizing event log...")
    df = pd.DataFrame(event_log)
    df = df.dropna(subset=[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'SalesOpportunityId', class="hl-string">'EventTime'], ascending=[True, True])
    
    class=class="hl-string">"hl-comment"># Reorder and select final columns
    final_columns = [
        class="hl-string">'SalesOpportunityId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'OpportunityOwner', class="hl-string">'SalesStage', class="hl-string">'OpportunityAmount', class="hl-string">'OpportunityCloseDate',
        class="hl-string">'OpportunityOutcome', class="hl-string">'Region', class="hl-string">'LeadSource'
    ]
    df = df[final_columns]

    output_filename = class="hl-string">'hubspot_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

if __name__ == class="hl-string">"__main__":
    main()

Kroki

Wymagania wstępne: utworzenie HubSpot Private App
- W portalu HubSpot przejdź do Settings > Integrations > Private Apps.
- Utwórz nową aplikację prywatną. Nadaj jej opisową nazwę, na przykład ProcessMind_Extraction.
- Na karcie „Scopes” przyznaj następujące uprawnienia do odczytu: crm.objects.deals.read, crm.objects.quotes.read, crm.objects.owners.read.
- Wygeneruj token dostępu i skopiuj go w bezpieczne miejsce. Będzie używany do uwierzytelniania w API.
Konfiguracja klienta API
- Do komunikacji z HubSpot GraphQL API użyj klienta API, takiego jak Postman lub Insomnia, albo języka skryptowego, na przykład Python z biblioteką requests.
- Punkt końcowy GraphQL API to https://api.hubapi.com/graphql/v1.
Konfiguracja żądania API
- Utwórz nowe żądanie POST do punktu końcowego API.
- W nagłówkach żądania dodaj nagłówek Authorization o wartości Bearer YOUR_PRIVATE_APP_TOKEN, zastępując YOUR_PRIVATE_APP_TOKEN wygenerowanym tokenem.
- Ustaw nagłówek Content-Type na application/json.
Przygotowanie zapytania GraphQL
- W treści żądania POST umieść ładunek JSON zawierający zapytanie GraphQL.
- Udostępnione zapytanie pobiera transakcje wraz z historią etapów, powiązanymi ofertami i działaniami komunikacyjnymi.
- Ustaw wartości zmiennych zapytania, w szczególności startTimestamp i endTimestamp, aby określić zakres dat eksportu, na przykład 2023-01-01T00:00:00Z.
Wykonanie zapytania i obsługa stronicowania
- Wyślij żądanie. API zwróci partię zawierającą maksymalnie 100 transakcji.
- Odpowiedź zawiera kursor paging.next.after. Jeśli jest obecny, ponownie wykonaj zapytanie, przekazując tę wartość after jako zmienną, aby pobrać kolejną stronę wyników.
- Powtarzaj te czynności, aż kursor paging.next.after będzie miał wartość null. Oznacza to, że pobrano wszystkie transakcje z wybranego zakresu dat.
Przekształcenie odpowiedzi JSON w dziennik zdarzeń
- API zwraca zagnieżdżoną strukturę JSON. Należy napisać skrypt, który ją odczyta i przekształci w płaski dziennik zdarzeń w formie tabeli. Dla każdego zwróconego obiektu transakcji:
- Zdarzenie 1: Utworzono szansę sprzedaży: Utwórz jeden wiersz. Wpisz „Utworzono szansę sprzedaży” w ActivityName, a wartość createdate transakcji w EventTime.
- Zdarzenie 2: Nawiązano pierwszy kontakt: Znajdź najwcześniejszą wartość hs_created_date spośród powiązanych połączeń, wiadomości e-mail i spotkań. Utwórz jeden wiersz z tym znacznikiem czasu. Jeśli nie ma żadnych działań, nie twórz tego zdarzenia.
- Zdarzenia 3–12: Działania oparte na etapach: Przejdź przez tablicę properties_with_history dla dealstage. Dla każdego wpisu utwórz wiersz, w którym ActivityName odpowiada nazwie etapu, na przykład „Zakwalifikowano szansę sprzedaży” lub „Przedstawiono rozwiązanie”, a EventTime zawiera znacznik czasu updated_at. Mapowanie należy zdefiniować zgodnie z etapami lejka sprzedaży.
- Zdarzenia 13 i 14: Działania dotyczące ofert: Przejdź przez powiązaną kolekcję quote_collection. Utwórz wiersz „Wystawiono ofertę” z datą createdate oferty. Jeśli istnieje hs_quote_accepted_date, utwórz wiersz „Zaakceptowano ofertę” z tym znacznikiem czasu.
- Zdarzenia 15 i 16: Status zamknięcia: Ostatni wpis w historii dealstage odpowiada zdarzeniu „Wygrana szansa sprzedaży” lub „Przegrana szansa sprzedaży”. Użyj znacznika czasu updated_at z tego wpisu jako wartości EventTime. Można również użyć właściwości closedate transakcji.
Mapowanie atrybutów
- Uzupełnij wymagane i zalecane atrybuty w każdym wierszu utworzonym w poprzednim kroku:
  - SalesOpportunityId: hs_object_id
  - SalesStage: wartość value z odpowiedniego wpisu historii dealstage.
  - OpportunityOwner: dealowner.email
  - OpportunityAmount: amount
  - OpportunityCloseDate: closedate
  - Pozostałe atrybuty można pobrać z głównych właściwości transakcji.
Dodanie kolumn statycznych i końcowych
- Dodaj kolumnę SourceSystem ze stałą wartością „HubSpot CRM”.
- Dodaj kolumnę LastDataUpdate i wpisz w niej znacznik czasu uruchomienia skryptu eksportującego.
Eksport do CSV
- Zapisz przekształcone dane tabelaryczne jako plik CSV. Zadbaj o spójny format znaczników czasu, na przykład ISO 8601. Plik jest gotowy do przesłania do ProcessMind.

Konfiguracja

Zakresy uprawnień Private App: aplikacja HubSpot Private App musi mieć co najmniej uprawnienia do odczytu w następujących zakresach: crm.objects.deals.read, crm.objects.quotes.read i crm.objects.owners.read.
Zmienne zapytania GraphQL: zapytanie wymaga zmiennych do filtrowania. Należy podać startTimestamp i endTimestamp, aby określić zakres danych pobieranych na podstawie daty utworzenia transakcji. Zalecamy rozpocząć od danych z ostatnich 6–12 miesięcy.
Wartości zastępcze dla właściwości niestandardowych: zapytanie zawiera wartości zastępcze, takie jak [your_lead_source_property] i [your_region_property]. Należy zastąpić je rzeczywistymi nazwami wewnętrznymi niestandardowych właściwości transakcji w instancji HubSpot.
Mapowanie etapów sprzedaży: wyodrębnianie działań, takich jak „Zakwalifikowano szansę sprzedaży” lub „Przedstawiono rozwiązanie”, zależy od logicznego mapowania etapów transakcji w HubSpot. Tę logikę biznesową należy skonfigurować w skrypcie transformacji.
Paginacja: parametr API limit pozwala pobrać maksymalnie 100 rekordów w jednym żądaniu. Skrypt pobierający dane musi obsługiwać paginację za pomocą kursora after, aby pobrać wszystkie rekordy.
Limity szybkości API: należy uwzględnić limity szybkości API HubSpot, zwłaszcza przy pobieraniu dużych ilości danych. Solidny skrypt powinien obsługiwać błędy oraz, w razie potrzeby, ponawiać żądania po odczekaniu.

Przykładowe zapytanie graphql

query getLeadToCashData($after: String, $startTimestamp: DateTime!, $endTimestamp: DateTime!) {
  CRM {
    deal_collection(
      limit: 100
      after: $after
      filter: {
        createdate: { gte: $startTimestamp, lte: $endTimestamp }
      }
    ) {
      items {
        hs_object_id
        createdate
        closedate
        amount
        dealstage
        hs_is_closed_won
        properties_with_history(properties: ["dealstage"]) {
          ... on PropertyValuesWithHistoryDealDealstage {
            values {
              value
              source
              source_id
              updated_at
            }
          }
        }
        associations {
          quote_collection__deal_to_quote(limit: 100) {
            items {
              hs_object_id
              createdate
              hs_quote_accepted_date
              hs_status
            }
          }
          call_collection__deal_to_call(limit: 100, sort: [{ propertyName: "hs_created_date", direction: ASC }]) {
            items {
              hs_created_date
            }
          }
          email_collection__deal_to_email(limit: 100, sort: [{ propertyName: "hs_created_date", direction: ASC }]) {
            items {
              hs_created_date
            }
          }
          meeting_collection__deal_to_meeting(limit: 100, sort: [{ propertyName: "hs_created_date", direction: ASC }]) {
            items {
              hs_created_date
            }
          }
        }
        dealowner {
          email
        }
        properties {
          your_lead_source_property: [your_lead_source_property]
          your_region_property: [your_region_property]
        }
      }
      paging {
        next {
          after
        }
      }
    }
  }
}

Gotowi do rozpoczęcia?

Skorzystaj z tego szablonu, aby przygotować dane i lepiej wykorzystać możliwości analizy procesu od leada do płatności. Zacznij usprawniać proces i zwiększać przychody.

Wróć do przewodnika ulepszania procesów

Pobierz szablon

Zwiększ liczbę wygranych transakcji o 20%: usprawnij proces od leada do płatności

Skróć długie cykle sprzedaży i zwiększ odsetek wygranych transakcji o 20% dzięki naszej platformie.

Rozpocznij bezpłatny okres próbny

Nie trzeba podawać danych karty płatniczej. Konfiguracja zajmuje 5 minut.

Szablon danych dla procesu od leada do płatności

Szablon danych dla procesu od leada do płatności

Atrybuty procesu od leada do płatności

Działania w procesie od leada do płatności

Instrukcje eksportu danych

Niestandardowy skrypt Python korzystający z HubSpot REST API

Kroki

Konfiguracja

Przykładowe zapytanie python

Ukierunkowany eksport danych przez HubSpot GraphQL API

Kroki

Konfiguracja

Przykładowe zapytanie graphql

Gotowi do rozpoczęcia?

Zwiększ liczbę wygranych transakcji o 20%: usprawnij proces od leada do płatności