Integracja HubSpot z custom API i webhookami: dane, których gotowy konektor nie przeniesie
Spinamy HubSpot z Twoim ERP, systemem fakturowym, panelem produktu czy własną bazą. Gdy jest gotowy konektor, używamy go. Gdy go nie ma, piszemy integrację na API i webhookach HubSpota.
Kiedy i co spinamy
Kiedy sięgamy po gotowy konektor, a kiedy po własny kod
Jest gotowy konektor
Jeżeli w marketplace HubSpota jest sprawdzony konektor do Twojego narzędzia, zaczynamy od niego. Konfigurujemy mapowanie pól i sprawdzamy, czy pokrywa realny zakres danych, zanim dopiszemy cokolwiek własnego.
Gotowca nie ma lub jest za wąski
Wtedy budujemy integrację na REST API HubSpota i webhookach. Kod w Node lub Pythonie, Make albo n8n tam, gdzie no-code wystarczy. Nie czekamy, aż producent narzędzia sam doda integrację.
Najpierw dane, potem połączenie
Integracja bez czystego modelu danych po stronie HubSpota to rzeźba, która się sypie po pierwszym imporcie. Jeżeli baza jest zaśmiecona, najpierw robimy porządek w CRM, a dopiero potem spinamy systemy.
Co się synchronizuje
Jakie dane i procesy przepływają między HubSpotem a resztą stacku
Rekordy CRM w obie strony
- - Kontakty, firmy i deale z HubSpota do zewnętrznej bazy
- - Nowy rekord w ERP tworzy kontakt w HubSpocie
- - Property sync jako lustrzane odbicie wybranych pól
- - Dedupe po record ID, nie po mailu na czuja
Webhooki na zmianę stanu
- - Zmiana stage'a deala odpala akcję w innym systemie
- - Nowy kontakt lub property update leci webhookiem
- - Subskrypcja zdarzeń crmObjects w private app
- - Webhook w workflow, gdy trigger ma być pod kontrolą sprzedaży
Deale spięte z fakturowaniem
- - Deal w stadium won tworzy zamówienie w ERP
- - Status płatności wraca na property deala
- - Line itemy zmapowane na pozycje z systemu sprzedaży
- - Bez przeklepywania kwot z arkusza do CRM
Dane z Twojego panelu
- - Aktywność użytkownika z aplikacji jako property lub custom event
- - Sygnały produktowe do scoringu leadów
- - Custom object na dane, których standardowy model nie trzyma
- - Timestampy zdarzeń jako osobne pola, nie w notatce
Leady z zewnętrznych źródeł
- - Formularz spoza HubSpota tworzy kontakt przez API
- - Walidacja przed zapisem, żeby nie zapychać bazy duplikatami
- - Routing leada do ownera od razu przy wejściu
- - Źródło leada trzymane jako property, nie zgadywane
Kto pcha dane i co przy błędzie
- - API, gdy pobieramy lub zapisujemy konkretne rekordy
- - Webhook, gdy reagujemy na zdarzenie w czasie rzeczywistym
- - Retry i bezpiecznik na rate limity API HubSpota
- - Log każdej operacji, żeby dało się zajrzeć pod maskę
Najczęstsze pytania
Integracja HubSpot z custom API: co pytają klienci
Kiedy webhook, a kiedy API HubSpota?+
Webhook bierzemy, gdy chcemy reagować na zdarzenie w HubSpocie w czasie rzeczywistym, na przykład nowy kontakt albo zmiana stage'a deala. API, gdy trzeba pobrać albo zapisać konkretne rekordy, na przykład zaciągnąć listę kontaktów lub zaktualizować property. Dokumentacja HubSpota opisuje ten podział wprost: webhook powiadamia o zdarzeniu, API pyta o dane lub wykonuje akcję.
Co jeśli dla mojego narzędzia nie ma gotowego konektora?+
Wtedy piszemy integrację na custom API i webhookach. HubSpot udostępnia szeroki zestaw REST API, więc spinamy się z każdym systemem, który ma własne API albo potrafi przyjąć webhook. Tu zaczynamy tam, gdzie kończą się gotowe integracje.
Jak wygląda budowa webhooków po stronie HubSpota?+
Webhooki definiujemy w private app przez developer projects, w pliku webhooks.json w folderze aplikacji. Subskrybujemy zdarzenia w formacie crmObjects dla większości typów obiektów, na przykład kontakt, firma czy deal. HubSpot dodał to podejście do private apps, więc zarządzanie subskrypcjami siedzi w konfiguracji aplikacji, a nie w osobnych protezach.
Czy da się odpalić webhook wprost z workflow?+
Tak. HubSpot pozwala użyć akcji webhook w workflow, więc trigger integracji zostaje pod kontrolą osoby, która buduje proces w CRM. Custom workflow actions wysyłają dane pod wskazany URL, w formacie, który ustalasz przy konfiguracji. Używamy tego, gdy integracja ma być częścią procesu sprzedaży, a nie ukrytą warstwą techniczną.
Co z limitami API HubSpota przy większym wolumenie?+
Integrator zatrzymujemy zanim uderzymy w rate limit, zwykle na poziomie kilkudziesięciu procent dostępnego okna, i zostawiamy zapas na retry. Do tego dochodzi log każdej operacji i bezpiecznik przy operacjach masowych. Przy dużych migracjach i synchronizacjach dzielimy ruch tak, żeby nie zderzyć się z pozostałymi integracjami na portalu.
Robicie też automatyzacje poza samym HubSpotem?+
Tak. Poza integracją CRM spinamy procesy na całym stacku: finanse, operacje, zamówienia i workflow wewnętrzne. Używamy Make albo n8n, gdy no-code wystarcza, i własnego kodu w Node lub Pythonie, gdy nie wystarcza. Zakres opisujemy na stronie automatyzacji biznesu.
Następny krok
Od czego zacząć integrację HubSpota
Automatyzacje HubSpota
Make.com, gdy no-code wystarcza, własny kod w Node lub Pythonie, gdy nie. Automatyzacje i integracje, które działają bez nadzoru.
Porządek w danych CRM
Sync, deduplikacja, model danych i governance, żeby HubSpot był jednym czystym źródłem prawdy. Fundament pod każdą integrację.
Discovery call
Przejdziemy przez Twój stack, systemy do spięcia i to, co realnie ma przepływać. Wracamy z kierunkową oceną zakresu.
30 min - szczera rozmowa
Masz system, którego HubSpot nie widzi natywnie?
Powiedz nam, co ma przepływać między HubSpotem a resztą stacku. Wracamy ze stałą wyceną integracji, zwykle w kilka dni roboczych.