WiseTools Hub← Strona główna

Konfiguracja integracji z HubSpot

Ostatnia aktualizacja: 20 lipca 2026 r.

Ten przewodnik prowadzi krok po kroku przez instalację i konfigurację aplikacji WiseTools Hub w HubSpocie — od połączenia konta, przez nadanie uprawnień, po włączenie i użycie poszczególnych narzędzi (weryfikacja kontrahentów w rejestrach, generowanie dokumentów, playbooki, numeracja transakcji, akcja w Workflows).

1. Wymagania wstępne

  • konto HubSpot z uprawnieniami super administratora (potrzebne do zainstalowania aplikacji i utworzenia właściwości);
  • hub z dostępem do obiektu Firmy (Companies) — na nim działa większość funkcji;
  • konto w WiseTools Hub (rejestracja na wisetoolshub.pl).

2. Instalacja i połączenie konta HubSpot

  1. Zaloguj się do wisetoolshub.pl i przejdź do panelu.
  2. W panelu wybierz Połącz HubSpot (lub zainstaluj aplikację z HubSpot Marketplace — nastąpi przekierowanie do ekranu autoryzacji OAuth).
  3. Na ekranie HubSpota zatwierdź zakres uprawnień (patrz sekcja 3) i wybierz właściwy portal (konto).
  4. Po autoryzacji wrócisz do panelu WiseTools Hub — połączenie jest aktywne i widoczne na liście integracji.

3. Zakres uprawnień (scopes)

Aplikacja prosi wyłącznie o uprawnienia niezbędne do działania włączonych narzędzi:

  • crm.objects.companies.read / write — odczyt NIP-u z firmy oraz zapis pobranych danych rejestrowych na rekord;
  • crm.schemas.companies.write — automatyczne tworzenie grupy właściwości WiseTools Registry i pola nip;
  • crm.objects.contacts.read oraz crm.objects.deals.read — dane do briefu sprzedażowego (PDF) i numeracji transakcji;
  • uprawnienia do plików — zapis wygenerowanych dokumentów PDF w HubSpot Files.

Dokładny zestaw scope’ów prezentowany jest na ekranie autoryzacji przed zatwierdzeniem — instalując aplikację, akceptujesz właśnie ten zakres.

4. Konfiguracja narzędzia WiseTools Registry

Registry to główne narzędzie — weryfikacja i wzbogacanie danych firm po numerze NIP lub KRS (GUS, biała lista VAT, VIES, KRS, CRBR).

4.1. Włączenie i automatyczne właściwości

  1. W panelu WiseTools Hub włącz narzędzie Registry.
  2. Przy włączeniu aplikacja automatycznie tworzy w HubSpocie grupę właściwości WiseTools Registry na obiekcie Firmy oraz pole wejściowe nip (w grupie Informacje o firmie).
  3. Gdyby któregoś pola zabrakło (np. zostało ręcznie usunięte), użyj przycisku „Napraw / dodaj brakujące pola w HubSpocie” w panelu — odtworzy brakujące właściwości (a zarchiwizowane — przywróci).

4.2. Uzupełnianie NIP-u

Lookup działa na podstawie NIP-u zapisanego na firmie. Aplikacja czyta go z właściwości nip, a gdy jej brak — z numer_nip lub tax_id. Jeśli masz już własne unikalne pole NIP, nazwij je wewnętrznie numer_nip, a zostanie rozpoznane automatycznie.

4.3. Karta na rekordzie firmy

  • Na karcie firmy pojawia się panel WiseTools Registry (zakładka rekordu). Domyślnie u góry widnieje NIP.
  • „Aktualizuj dane po NIP” — pobiera świeże dane z rejestrów i zapisuje je w polach grupy Registry.
  • „Szukaj po KRS” — gdy nie masz NIP-u: podaj numer KRS, a aplikacja wydobędzie NIP i zaciągnie dane.
  • „Sprawdź konto bankowe” — weryfikacja numeru rachunku na białej liście VAT dla tej firmy.
  • „Generuj brief (PDF)” — jednostronicowy dokument z danymi rejestrowymi, kontaktami i otwartymi transakcjami; zapisywany w HubSpot Files.

4.4. Rozszerzony rejestr (CRBR + KRS)

W ustawieniach narzędzia możesz włączyć rozszerzone dane rejestrowe — beneficjentów rzeczywistych (CRBR) oraz dane z KRS (zarząd, kapitał, wspólnicy, status). Włączenie dokłada odpowiednie właściwości; pola wypełniają się przy kolejnym lookupie.

5. Akcja w HubSpot Workflows

Po zainstalowaniu aplikacji w edytorze Workflows dostępna jest akcja „WiseTools Registry: Update company”. Wstaw ją w pipeline (np. po utworzeniu firmy z NIP-em) — workflow przekaże identyfikator firmy, a aplikacja wykona lookup i zaktualizuje właściwości. Pola wynikowe (status, źródła, wynik zapisu) są dostępne dla kolejnych kroków workflow.

6. Pozostałe narzędzia (opcjonalnie)

  • Dokumenty — generowanie dokumentów PDF z danych rekordu; tworzy niezbędne właściwości i zapisuje pliki w HubSpot Files.
  • Playbooki — playbooki w formie formularzy na karcie rekordu (bez dodatkowych właściwości na obiekcie).
  • Numeracja transakcji — automatyczny numer transakcji (właściwość wisetools_deal_number na obiekcie Transakcje).
  • Battle cards — karty argumentów sprzedażowych na rekordzie.

7. Rozwiązywanie problemów

  • „Firma nie ma uzupełnionego NIP-u” — uzupełnij pole nip (lub numer_nip / tax_id) na firmie albo użyj przycisku „Szukaj po KRS”.
  • Brak właściwości / grupy Registry — kliknij „Napraw / dodaj brakujące pola w HubSpocie” w panelu.
  • Auto-setup nie powiódł się — upewnij się, że masz uprawnienia super administratora i aktywny scope crm.schemas.companies.write, po czym uruchom ponownie.
  • Numer zagraniczny (np. GB) — obsługiwane są polski NIP oraz numery VAT UE walidowane w VIES; numery brytyjskie po Brexicie nie są w VIES.

8. Odłączenie aplikacji

Integrację możesz odłączyć w panelu WiseTools Hub lub odinstalować aplikację w ustawieniach HubSpota. Utworzone właściwości i zapisane dane pozostają na Twoim koncie HubSpot (nie usuwamy ich automatycznie).

9. Wsparcie

W razie pytań dotyczących konfiguracji napisz do nas: [E-MAIL KONTAKTOWY]. Zobacz też Politykę prywatności i Warunki korzystania.