Sledzenie klikniecia linku Pipedrive: deale z trafien short linków

Sledzenie klikniec Pipedrive w Elido zamienia kamienie milowe short linków w zdarzenia pipeline. Gdy jeden z twoich linków przekroczy 100, 1000 lub 10 000 klikniec, cron uruchamiany co 5 minut tworzy deal w wybranej pipeline i etapie Pipedrive - ze slugiem linku, zródlem UTM i bezposrednim linkiem do Elido w notatkach dealu. Bez Zapiera w srodku, bez recznego eksportu, bez przypomnienia w kalendarzu o sprawdzeniu raportów linków.

To naglówek. Wazniejsza jest mechanika, wiec ten artykul omawia trzy rzeczy, które zespoly sales ops musza wiedziec przed wlaczeniem tej funkcji. Po pierwsze: jak naprawde dziala przepływ Connect - gdzie jest przechowywany osobisty token API, co odczytuje picker pipeline i jak token jest przechowywany po wklejeniu. Po drugie: co robi cron progów przy kazdym uruchomieniu i jak unika tworzenia zdublowanych dealów, gdy link staje sie viralem z dnia na dziec. Po trzecie: jak rozszerzyc integracje poza trzy domyslne progi - na wlasne liczby klikniec, triggery z filtrowaniem po UTM i wlasne pola Pipedrive - uzywajac Elido SDK i malego handlera webhooków.

Pipedrive przeszedl do Live dla Elido 22 maja 2026 roku. Wczesniej przez dwa tygodnie byl w Beta, gdy wyluszczalismy edge case'y zwiazane z ID etapów i rotacja tokenów. Kod integracji znajduje sie w services/api-core/internal/integrations/pipedrive/, jesli hostujesz samodzielnie i chcesz przeczytac zródla. Wszystko w tym artykule odpowiada temu, co jest wdrozone - nie jest to roadmapa.

Podlaczenie Pipedrive w dwie minuty

Otwórz katalog integracji w swoim workspace Elido i kliknij karte Pipedrive. Modal Connect pyta najpierw o jedna rzecz: osobisty token API. Znajdziesz go w swoim koncie Pipedrive otwierajac menu profilu, wybierajac Preferencje osobiste, a nastepnie zakladke API. Wlasny poradnik Pipedrive na temat how to find the Personal API token zawiera dokladna sciezke ze zrzutami ekranu - ich interfejs zmienia sie mniej wiecej co kwartal.

Wklej token. Elido robi w tle dwie rzeczy. Sprawdza token wywolujacom GET /users/me w Pipedrive API, co potwierdza, ze token jest aktywny, i mówi nam, do której firmy Pipedrive nalezy. Pobiera tez liste pipeline i etapów dla tej firmy, zeby kolejny krok w modalu pokazywal prawdziwe opcje, a nie pola tekstowe.

Modal pyta nastepnie o dwie kolejne rzeczy. W której pipeline maja ladowac nowe deale? Na którym etapie tej pipeline? Listy rozwijane sa zasilane twoimi zywo danymi z Pipedrive. Jesli masz trzy pipeline o nazwach Inbound, Outbound i Partners, zobaczysz te trzy. Wybierz ta, która pasuje do pracy - zwykle Inbound dla sygnalow marketingowych - a nastepnie pierwszy etap kwalifikacji. Kliknij Polacz.

Co dzieje sie z tokenem po polaczeniu. Elido szyfruje go przed zapisem do Postgres, uzywajac szyfrowania kopertowego z kluczem szyfrowania danych per tenant owinietym kluczem KMS workspace. Zaszyfrowany blob trafia do tabeli integration_credentials. Czysty token istnieje w pamieci tylko na czas jednego wywolania API i nigdy nie jest logowany - nawet przy poziomie debug. Jesli zrotujesz token w Pipedrive, nastepne uruchomienie crona otrzyma 401 i Elido oznaczy integracje jako wymagajaca ponownego uwierzytelnienia - widoczne jako baner w workspace, nie cicha awaria. Higiena rotacji lezcy po twojej stronie, a awaria jest glosna.

Picker pipeline to maly, ale wazny szczegól. Czestym błedem w integracjach CRM jest tworzenie dealów w zlej pipeline, bo integracja byla budowana, gdy firma miala jedna pipeline, a teraz ma szesc. Pozwalanie uzytkownikowi na wybór przy polaczeniu i pokazywanie aktualnej listy zamiast cachu sprzed miesiaca eliminuje cala te klase biedów. W kazdej chwili mozna tez ponownie polaczyc, by zmienic docelowa pipeline bez utraty historii progów.

Co naprawde robi cron uruchamiany co 5 minut

W services/api-core jest job o nazwie click_threshold_hook. Uruchamia sie co piec minut. Przy kazdym ticku robi trzy rzeczy po kolei, dla kazdego workspace z podlaczonym Pipedrive.

Po pierwsze, pyta ClickHouse o laczne klikniecia per link zaktualizowane w ciagu ostatnich szesciu minut, plus bufor jednej minuty na spóznione zdarzenia. ClickHouse przechowuje zdarzenia klikniec w tabeli clicks podzielonej na partycje wedlug daty, a zapytywany rollup to zmaterializowany widok kluczowany przez ID short linka. Zapytanie zwraca linki, których sumy zmienily sie od ostatniego uruchomienia crona - nie cala tabele. W workspace z 50 000 aktywnymi linkami i normalnym wzorcem klikniec to zapytanie miesci sie w 200 ms.

Po drugie, porównuje nowa sume kazdego linku z zapisanymi progami. Domyslne progi to 100, 1000 i 10 000. Dla kazdego linku Elido sledzi najwyzszy osiagniety próg w malym wierszu link_threshold_state kluczowanym przez ID linku. Jesli link mial 80 klikniec przy ostatnim uruchomieniu, a teraz ma 240, porównanie pokazuje, ze próg 100 zostal przekroczony, a 1000 jeszcze nie. Oznaczamy 100 jako osiagniety i kolejkujemy jedno tworzenie dealu. Jesli link przeskoczyl z 80 do 1200, przekroczone zostaly zarówno 100, jak i 1000 - kolejkujemy dwa tworzenia.

Po trzecie, dla kazdego dealu w kolejce Elido wywoluje Pipedrive Deals API za pomoca POST na /deals. Body ustawia ID pipeline i ID etapu z pickera, nadaje dealowi czytelna nazwe, np. Link <slug> osiagnal <próg> klikniec, i zapisuje zródlo UTM, medium i kampanie w notatce dealu wraz z klikalnym linkiem do widoku analityki Elido dla tego linku. Zapisujemy tez ID linku w polu niestandardowym Pipedrive, jesli workspace ma takie skonfigurowane - umozliwia to pózniejsze zapytanie Pipedrive o wszystkie deale powiazane z konkretnym linkiem Elido.

Kilka rzeczy, których ten cron nie robi. Nie ponawia prób w nieskonczonosc przy bledach 5xx Pipedrive. Jesli Pipedrive zwróci 500 lub 503, ponawiamy prób dwa razy z wykładniczym backoffem w tym samym ticku crona, a nastepnie zostawiamy prace do nastepnego ticku. Limit zapytan Pipedrive wynosi w praktyce 100 zapytan na 2 sekundy na token firmy, co daje duzy zapas dla wolumenów, jakie wiekszosc zespolów bedzie osiagac. Nie tworzymy tez dealów dla linków oznaczonych jako testowe, wewnetrzne ani nalezacych do czlonka workspace, który wylaczy synchronizacje CRM w swoich ustawieniach osobistych.

Zapobieganie duplikatom bylo czesca wymagajaca najwiecej iteracji. Pierwsza wersja miala race condition: jesli dwa pody crona dzialaly jednoczesnie, oba mógly zobaczyc ten sam link przekraczajacy 100 i oba mógly wykonac POST dealu. Rozwiazalismy to za pomoca Postgres advisory lock na ID workspace na poczatku kazdego ticku crona, plus unikalny constraint na (link_id, threshold) w link_threshold_state. Jesli drugi pod próbuje wstawic zduplikowany wiersz, Postgres go odrzuca i POST z kolejki jest porzucany przed dotarciem do Pipedrive. Podwójne zabezpieczenie.

Rozszerzenie poza trzy domyslne progi

Wbudowane progi to 100, 1000 i 10 000. Wiekszosc zespolów je zachowuje, bo naturalnie wpisuja sie w narracje sprzedazowa. Sto klikniec to slaby sygnal warty spojrzenia. Tysiac to kampania warta telefonu. Dziesiec tysiecy to wystarczajaco goraco, zeby handlowiec juz dzialal. Niemniej mozesz chciec innych liczb i SDK to obsluguje.

Elido integracja Pipedrive przyjmuje wlasna liste progów na poziomie workspace. Ustawiasz ja przez endpoint PATCH /v1/workspaces/:id/integrations/pipedrive z body JSON jak {"thresholds": [50, 500, 5000, 50000]}. Cron pobiera nowa liste przy nastepnym ticku. Tabela stanu zachowuje historie, wiec zmiana progów nie tworzy dealów wstecznie - zmienia tylko, które przyszle przekroczenia wywolaja zdarzenie.

Dla bogatszych triggerów SDK udostepnia hook CreateDeal, który mozesz zarejestrowac z dowolnego serwisu. Klasyczny przypadek: twórz deal tylko wtedy, gdy link przekroczy próg ORAZ zródlo UTM to twoja platna kampania spolecznosciowa, nie organiczny blog. To jednolinijkowy filtr wewnatrz hooka. Inny czesty przypadek: wyzwalaj tylko na linkach w konkretnym folderze Elido, bo ten folder to twój folder kampanii, a reszta to szum. Ten sam hook moze tez ustawiac pola niestandardowe Pipedrive, jak Zródlo Dealu, Kanal Leadu lub jakakolwiek taksonomia stosowana przez twój zespól sales ops. Poradnik dotyczacy przekazywania konwersji omawia ten sam wzorzec hooka dla platform reklamowych; przypadek Pipedrive jest strukturalnie identyczny.

Uwaga o polach niestandardowych. SDK przyjmuje zarówno czytelna etykiete, jak i wewnetrzny klucz API z hashem, którego Pipedrive uzywa wewnetrznie. Jesli odwolasz sie do etykiety, która nie istnieje w podlaczonej firmie, deal i tak zostaje utworzony, a brakujace pole jest logowane jako ostrzezenie, nigdy jako blad. Brakujace pole niestandardowe nie powinno blokowac prawdziwego sygnalu sprzedazowego.

Zespoly z wieloma linkami na kampanie chca czasem agregowac progi na poziomie folderu. Ustaw aggregation: "folder" w konfiguracji integracji workspace, a cron pogrupuje sumy klikniec wedlug folderów i sprawdzi sume. Deal otrzymuje nazwe folderu, a w notatkach sa wymienione trzy linki wnoszace najwiekszy wklad.

Gdzie lezy token i jak go rotowac

Krótka sekcja, bo pojawia sie na kazdym przegladzre bezpieczenstwa. Osobisty token API jest szyfrowany w spoczynku uzywajac AES-256-GCM z kluczem szyfrowania danych per tenant. DEK jest owiniety kluczem na poziomie workspace w naszym KMS i tylko proces api-core moze go odwinac. W zadnym logu, kopii zapasowej ani sladzie bledów nie ma tokenu w czystym tekscie. Przetestowalismy to wtryskujac blad, który wymuszal 401 od Pipedrive w srodku zapytania, a sciezka bledu usuwa token z odpowiedzi zanim trafi do Sentry.

Jak rotowac: wygeneruj nowy osobisty token API w Pipedrive, uniewnij stary, a nastepnie wklej nowy do modalu Elido Connect. Integracja sprawdza nowy token, zastepuje go i nastepny tick crona go uzywa. Jesli zapomnisz zaktualizowac Elido po uniewaznieniu starego tokenu, nastepny tick crona dostanie 401 i integracja przejdzie w stan Wymaga ponownego uwierzytelnienia - widoczny jako zólty baner na panelu workspace. Zadnych cichych martwych tokenów.

Przy self-hostingu KMS jest wtyczkowy: domyslnie plikowy, mozesz podmienie na HashiCorp Vault lub swój KMS w chmurze. ADR-0036 omawia to szerzej.

Gdzie to pasuje w szerszym lejku

Triggery dealów Pipedrive z klikniec sa jednym elementem wiekszego wzorca. Liczby klikniec to wyprzedzajacy wskaznik, nie liczba przychodów, wiec zazwyczaj chcesz, zeby splynely do CRM, gdzie zyjy pozostale konteksty sprzedazowe. Deal to przekazanie: marketing wykonal swoja prace, sprzedaz ja przejmuje. Od tej chwili dzialaja twoje normalne przepływy Pipedrive: przypisanie dealu do handlowca, ocena, przesuwanie przez etapy, zamykanie.

Jesli dodatkowo przekazujesz konwersje do platform reklamowych, te same dane klikniec zasilaja oba przeplywy. Funkcja sledzenia konwersji zajmuje sie strona reklamowa, integracja Pipedrive strona CRM, i te dwa nigdy nie walcza o to samo zdarzenie. Najczesciej widzimy ta kombinacje na stronie rozwiazania dla marketerów, gdzie caly stack to platna akwizycja przez brandowane linki do lejka CRM.

Dla analityków chcacych zachowac uczciwe liczby, dwa wczesniejsze artykuly omawiaja obawy na górze lejka. Short link analytics: what to measure omawia, które metryki klikniec naprawde koreluja z przychodami, a Track UTM end to end opisuje higieny UTM, która sprawia, ze notatki dealów sa uzyteczne zamiast halasliwe. Oba dobrze uzupelniaja te integracje, bo deal tworzony przez Pipedrive jest tyle wart, ile dane UTM, które niesie.

Jeden ostatni szczegól dotyczacy planów. Integracja Pipedrive jest dostepna na kazdym platnym poziomie Elido, a próba 14-dniowa ja zawiera, wiec mozesz sprawdzic liste progów przed subskrypcja. Bezplatne workspace moga tworzyc polaczenie do testów, ale cron nie uruchamia sie dla bezplatnych linków. Strona cennika zawiera zestawienie per poziom.

Lista kontrolna konfiguracji

Wydrukuj, zrób raz.

1. W Pipedrive: menu profilu, Preferencje osobiste, zakladka API, skopiuj token.
2. W Elido: Integracje, karta Pipedrive, Polacz.
3. Wklej token. Poczekaj na walidacje.
4. Wybierz pipeline i etap. Domyslnie: Inbound i pierwszy etap kwalifikacji.
5. Kliknij Polacz.
6. Opcjonalnie: edytuj liste progów, jesli 100/1k/10k nie pasuje do twojego procesu sprzedazy.
7. Opcjonalnie: zarejestruj wlasny hook CreateDeal do filtrowania UTM lub agregacji folderów.
8. Poczekaj piec minut. Wyslij kilka testowych klikniec. Obserwuj, jak pojawia sie pierwszy deal.

To wszystko. Przy self-hostingu upewnij sie tez, ze cron jest wlaczony, sprawdzajac ze kubectl get cronjob api-core-click-threshold-hook zwraca aktywny harmonogram. W Elido Cloud cron jest zarzadzany za ciebie.