Śledzenie kliknięć w Pipedrive: transakcje z odsłon krótkich linków

Śledzenie kliknięć w Pipedrive w Elido zamienia kamienie milowe krótkich linków w zdarzenia w lejku sprzedażowym. Gdy jeden z Twoich linków przekroczy 100, 1 000 albo 10 000 kliknięć, cron działający co 5 minut tworzy transakcję w lejku i na etapie Pipedrive, które wybrałeś, wraz ze slugiem linku, źródłem UTM i głębokim linkiem z powrotem do Elido w notatkach transakcji. Bez Zapiera pośrodku, bez ręcznego eksportu, bez przypomnienia w kalendarzu, żeby sprawdzić raporty linków.

To nagłówek. Mechanika liczy się bardziej, więc ten wpis krok po kroku omawia trzy rzeczy, którym zespoły sales ops muszą zaufać, zanim to włączą. Po pierwsze, jak naprawdę działa proces łączenia: gdzie przechowywany jest osobisty token API, co odczytuje selektor lejka i jak token jest zapisywany po wklejeniu. Po drugie, co robi cron progowy przy każdym uruchomieniu i jak unika tworzenia zduplikowanych transakcji, gdy link staje się wiralowy z dnia na dzień. Po trzecie, jak rozszerzyć integrację poza trzy domyślne progi, na niestandardowe liczby kliknięć, wyzwalacze ograniczone do UTM i niestandardowe pola Pipedrive, wykorzystując SDK Elido i niewielki handler webhooków.

Pipedrive trafił do statusu Live dla Elido 22 maja 2026 roku. Wcześniej przez dwa tygodnie był w Becie, gdy dopracowywaliśmy przypadki brzegowe wokół identyfikatorów etapów i rotacji tokenu. Kod integracji znajdziesz w services/api-core/internal/integrations/pipedrive/, jeśli hostujesz Elido samodzielnie i chcesz zajrzeć w źródła. Wszystko w tym wpisie odpowiada temu, co jest wdrożone, a nie planom na przyszłość.

Łączenie Pipedrive w dwie minuty

Otwórz katalog integracji w swojej przestrzeni roboczej Elido i kliknij kartę Pipedrive. Modal łączenia pyta najpierw o jedną rzecz: osobisty token API. Uzyskasz go w swoim koncie Pipedrive, otwierając menu profilu, wybierając Personal preferences, a następnie zakładkę API. Własny przewodnik Pipedrive jak znaleźć osobisty token API pokazuje dokładną ścieżkę ze zrzutami ekranu, bo ich interfejs zmienia się mniej więcej co kwartał.

Wklej token. Elido w tle robi dwie rzeczy. Waliduje token, wywołując GET /users/me na API Pipedrive, co potwierdza, że token jest aktywny, i mówi nam, do jakiej firmy Pipedrive ten token należy. Pobiera też listę lejków i etapów tej firmy, więc kolejny krok w modalu pokazuje realne opcje, a nie pola tekstowe do wypełnienia z pamięci.

Modal zadaje potem jeszcze dwa pytania. Do którego lejka mają trafiać nowe transakcje? Na którym etapie tego lejka? Listy rozwijane są wypełniane na podstawie Twoich aktualnych danych z Pipedrive. Jeśli masz trzy lejki o nazwach Inbound, Outbound i Partners, zobaczysz właśnie te trzy. Wybierz ten, który pasuje do danej pracy, zwykle Inbound dla sygnałów napędzanych przez marketing, a potem pierwszy kwalifikujący się etap. Kliknij Connect.

Co dzieje się z tokenem po połączeniu. Elido szyfruje go, zanim dotrze do Postgresa, korzystając z envelope encryption z kluczem szyfrowania danych dla danego najemcy, opakowanym przez klucz KMS przestrzeni roboczej. Zaszyfrowany blob to właśnie to, co trafia do tabeli integration_credentials. Token w postaci jawnej istnieje w pamięci tylko przez czas trwania pojedynczego wywołania API i nigdy go nie logujemy, nawet przy poziomie szczegółowości debug. Jeśli zrotujesz token w Pipedrive, kolejne uruchomienie crona dostanie 401, a Elido oznaczy integrację jako wymagającą ponownej autoryzacji, co objawia się banerem w przestrzeni roboczej, a nie cichym niepowodzeniem. Higiena rotacji leży po Twojej stronie, ale awaria jest głośna.

Selektor lejka to drobny, ale ważny szczegół. Częstym trybem awarii w integracjach CRM jest tworzenie transakcji w niewłaściwym lejku, bo integrację zbudowano, gdy firma miała jeden lejek, a teraz ma sześć. Pozwolenie użytkownikowi na wybór podczas łączenia i pokazywanie aktualnej listy zamiast tej zapamiętanej sprzed miesiąca eliminuje całą tę klasę błędów. Możesz też połączyć się ponownie w dowolnym momencie, żeby zmienić cel selektora, nie tracąc historii progów.

Co naprawdę robi cron uruchamiany co 5 minut

Wewnątrz services/api-core działa zadanie o nazwie click_threshold_hook. Uruchamia się co pięć minut. Przy każdym takcie wykonuje po kolei trzy rzeczy, dla każdej przestrzeni roboczej, która ma podłączony Pipedrive.

Po pierwsze, pyta ClickHouse o sumy kliknięć dla poszczególnych linków, zaktualizowane w ciągu ostatnich sześciu minut, plus bufor jednej minuty na pokrycie spóźnionych zdarzeń. ClickHouse przechowuje zdarzenia kliknięć w tabeli clicks podzielonej na partycje według daty, a zapytanie, które wykonujemy, to zmaterializowany widok zagregowany kluczowany po ID krótkiego linku. Zapytanie zwraca linki, których sumy zmieniły się od ostatniego uruchomienia crona, a nie całą tabelę. W przestrzeni roboczej z 50 000 aktywnych linków i normalnym wzorcem kliknięć to zapytanie zamyka się poniżej 200 ms.

Po drugie, porównuje nową sumę każdego linku z zapisanymi progami. Domyślne progi to 100, 1 000 i 10 000. Dla każdego linku Elido śledzi najwyższy osiągnięty kiedykolwiek próg w niewielkim wierszu tabeli link_threshold_state kluczowanym po ID linku. Jeśli link miał 80 kliknięć przy ostatnim uruchomieniu, a teraz ma 240, porównanie pokazuje, że próg 100 został przekroczony, a próg 1 000 jeszcze nie został naruszony. Oznaczamy 100 jako osiągnięty i kolejkujemy jedno utworzenie transakcji. Jeśli link skoczył z 80 do 1 200, przekroczone zostały oba progi, 100 i 1 000, więc kolejkujemy dwa utworzenia.

Po trzecie, dla każdej zakolejkowanej transakcji Elido wywołuje API Deals Pipedrive przez żądanie POST do /deals. Treść żądania ustawia ID lejka i ID etapu z selektora użytego przy łączeniu, nadaje transakcji czytelną nazwę w rodzaju Link <slug> hit <threshold> clicks i zapisuje źródło, medium i kampanię UTM w notatce transakcji razem z klikalnym linkiem z powrotem do widoku analityki Elido dla tego linku. Zapisujemy też ID linku w niestandardowym polu Pipedrive, jeśli przestrzeń robocza ma je skonfigurowane, co pozwala później odpytać Pipedrive o wszystkie transakcje powiązane z konkretnym linkiem Elido.

Kilka rzeczy, których ten cron nie robi. Nie ponawia prób w nieskończoność przy błędach 5xx Pipedrive. Jeśli Pipedrive zwróci 500 albo 503, ponawiamy próbę dwa razy z rosnącym opóźnieniem w ramach tego samego taktu crona, a potem zostawiamy zadanie na kolejny takt. Limit szybkości Pipedrive to w praktyce 100 żądań na 2 sekundy na token firmy, co daje wystarczający zapas dla wolumenów, z jakimi spotka się większość zespołów. Nie tworzymy też transakcji dla linków oznaczonych jako testowe, wewnętrzne albo należących do członka przestrzeni roboczej, który zrezygnował z synchronizacji z CRM w swoich ustawieniach osobistych.

Zapobieganie duplikatom to część, która wymagała najwięcej iteracji. Pierwsza wersja miała wyścig: jeśli dwa pody crona uruchamiały się z zakładką czasową, oba mogły zobaczyć, że ten sam link przekroczył 100, i oba mogły wysłać POST tworzący transakcję. Rozwiązaliśmy to blokadą doradczą Postgresa na ID przestrzeni roboczej na początku każdego taktu crona, plus unikalnym ograniczeniem na (link_id, threshold) w link_threshold_state. Jeśli drugi pod próbuje wstawić zduplikowany wiersz, Postgres go odrzuca, a zakolejkowany POST jest porzucany, zanim dotrze do Pipedrive. Pas i szelki naraz.

Rozszerzanie poza trzy domyślne progi

Wdrożone progi to 100, 1 000 i 10 000. Większość zespołów zostaje przy nich, bo naturalnie odwzorowują narrację sprzedażową. Sto kliknięć to słaby sygnał wart rzucenia okiem. Tysiąc to kampania warta telefonu. Dziesięć tysięcy jest na tyle gorące, że handlowiec powinien już działać. Mimo to możesz chcieć innych liczb, a SDK to wspiera.

Integracja Pipedrive w Elido akceptuje niestandardową listę progów na poziomie przestrzeni roboczej. Ustawiasz ją przez endpoint PATCH /v1/workspaces/:id/integrations/pipedrive z treścią JSON w rodzaju {"thresholds": [50, 500, 5000, 50000]}. Cron podejmuje nową listę przy kolejnym takcie. Tabela stanu zachowuje historię, więc zmiana progów nie tworzy retroaktywnie transakcji wstecz, zmienia jedynie to, które przyszłe przekroczenia się uruchomią.

Dla bogatszych wyzwalaczy SDK udostępnia hook CreateDeal, który możesz zarejestrować z dowolnej usługi. Klasyczny przypadek: utworzyć transakcję tylko wtedy, gdy link przekroczy próg ORAZ źródło UTM to Twoja płatna kampania w mediach społecznościowych, a nie organiczny blog. To jednolinijkowy filtr wewnątrz hooka. Inny częsty przypadek: uruchamiać się tylko dla linków wewnątrz konkretnego folderu Elido, bo ten folder to Twój folder kampanii, a wszystko inne jest szumem. Ten sam hook może też ustawiać niestandardowe pola Pipedrive, takie jak Deal Source, Lead Channel albo dowolną taksonomię, jakiej używa Twój zespół sales ops. Przewodnik po przekazywaniu konwersji omawia ten sam wzorzec hooka dla platform reklamowych, przypadek Pipedrive jest strukturalnie identyczny.

Uwaga na temat pól niestandardowych. SDK akceptuje albo etykietę czytelną dla człowieka, albo zahaszowany klucz API, którego Pipedrive używa wewnętrznie. Jeśli odwołasz się do etykiety, która nie istnieje w podłączonej firmie, transakcja i tak zostanie utworzona, a brakujące pole zostanie zalogowane jako ostrzeżenie, nigdy jako błąd. Brakujące pole niestandardowe nie powinno blokować prawdziwego sygnału sprzedażowego.

Zespoły z wieloma linkami na kampanię czasem chcą agregować progi w obrębie folderu. Ustaw aggregation: "folder" w konfiguracji integracji przestrzeni roboczej, a cron pogrupuje sumy kliknięć według folderu, a następnie sprawdzi sumę. Nazwa transakcji zawiera nazwę folderu, a notatki wymieniają trzy linki wnoszące największy wkład.

Gdzie mieszka token i jak go rotować

Krótka sekcja, bo pytanie o to pojawia się w każdym przeglądzie bezpieczeństwa. Osobisty token API jest szyfrowany w spoczynku metodą AES-256-GCM z kluczem szyfrowania danych dla danego najemcy. Sam DEK jest opakowany kluczem na poziomie przestrzeni roboczej w naszym KMS, a rozpakować go potrafi wyłącznie proces api-core. Nie ma jawnego tokenu w żadnym logu, żadnej kopii zapasowej ani żadnym śladzie błędu. Testowaliśmy to wstrzyknięciem awarii, które wymusiło błąd 401 Pipedrive w trakcie żądania, a ścieżka błędu wymazuje token z odpowiedzi, zanim ta dotrze do Sentry.

Żeby zrotować: wygeneruj nowy osobisty token API w Pipedrive, odwołaj stary, a potem wklej nowy ponownie w modalu łączenia Elido. Integracja waliduje nowy token, podmienia go na miejscu, a kolejny takt crona już go używa. Jeśli zapomnisz zaktualizować Elido po odwołaniu starego tokenu, kolejny takt crona dostanie 401, a integracja przejdzie w stan wymagający ponownej autoryzacji, widoczny jako żółty baner na pulpicie przestrzeni roboczej. Żadnych cicho martwych tokenów.

Przy samodzielnym hostowaniu KMS jest wymienny: domyślnie oparty na plikach, można podłączyć HashiCorp Vault albo własny KMS chmurowy. ADR-0036 opisuje to szczegółowo.

Gdzie to pasuje w szerszym lejku

Wyzwalacze transakcji w Pipedrive z kliknięć to jeden element większego wzorca. Liczba kliknięć to wskaźnik wyprzedzający, a nie liczba przychodowa, więc zwykle chcesz, żeby zasilała CRM, gdzie mieszka reszta kontekstu sprzedażowego. Transakcja to przekazanie: marketing zrobił swoją robotę, sprzedaż ją przejmuje. Od tego momentu przejmują Twoje zwykłe przepływy pracy w Pipedrive: przypisanie transakcji do handlowca, ocena, przesuwanie przez etapy, zamknięcie.

Jeśli równolegle przekazujesz konwersje do platform reklamowych, te same dane o kliknięciach zasilają oba przepływy. Funkcja śledzenia konwersji obsługuje stronę reklamową, integracja z Pipedrive obsługuje stronę CRM, a te dwa nigdy nie rywalizują o to samo zdarzenie. Najczęściej widzimy to połączenie na stronie rozwiązań dla marketerów, gdzie cały stos to płatne pozyskiwanie prowadzące do markowych linków prowadzących do lejka CRM.

Dla analityków, którym zależy na uczciwych liczbach, dwa wcześniejsze wpisy omawiają zagadnienia leżące wyżej w łańcuchu. Analityka krótkich linków - co mierzyć, a co ignorować omawia, które metryki kliknięć faktycznie korelują z przychodem, a Jak śledzić kampanie UTM od końca do końca bez CDP omawia higienę UTM, dzięki której notatki transakcji są użyteczne, a nie zaszumione. Oba wpisy dobrze łączą się z tą integracją, bo transakcja tworzona przez Pipedrive jest tak użyteczna, jak dane UTM, które ze sobą niesie.

Ostatni szczegół dotyczący planów. Integracja z Pipedrive jest dostępna na każdym płatnym planie Elido, a 14-dniowy okres próbny ją obejmuje, więc możesz sprawdzić swoją listę progów, zanim się zarejestrujesz. Darmowe przestrzenie robocze mogą utworzyć połączenie do testów, ale cron nie uruchamia się dla darmowych linków. Strona z cennikiem zawiera podział na poszczególne plany.

Lista kontrolna konfiguracji

Wydrukuj to, zrób raz.

1. W Pipedrive: menu profilu, Personal preferences, zakładka API, skopiuj token.
2. W Elido: Integracje, karta Pipedrive, Connect.
3. Wklej token. Poczekaj na walidację.
4. Wybierz lejek i etap. Domyślnie Inbound i pierwszy kwalifikujący się etap.
5. Kliknij Connect.
6. Opcjonalnie: edytuj listę progów, jeśli 100/1 tys./10 tys. nie pasuje do Twojego procesu sprzedaży.
7. Opcjonalnie: zarejestruj niestandardowy hook CreateDeal do filtrów UTM albo agregacji folderów.
8. Poczekaj pięć minut. Wyślij kilka testowych kliknięć. Obserwuj, jak ląduje pierwsza transakcja.

To wszystko. Jeśli hostujesz samodzielnie, warto też sprawdzić, czy cron jest włączony, wywołując kubectl get cronjob api-core-click-threshold-hook, co powinno zwrócić poprawny harmonogram. W Elido Cloud cron jest zarządzany za Ciebie.