Śledzenie kliknięć linków w Pipedrive: deale z trafień w krótkich linkach

Śledzenie kliknięć linków w Pipedrive w Elido zamienia kamienie milowe krótkich linków w zdarzenia pipeline'u. Gdy jeden z Twoich linków przekroczy 100, 1000 albo 10 000 kliknięć, cron co 5 minut tworzy deala w wybranym przez Ciebie pipeline'ie Pipedrive, zatytułowanego slugiem linku i kamieniem milowym. Notatki deala niosące źródło UTM i głęboki link z powrotem do Elido są planowane. Żadnego Zapiera pośrodku, żadnego ręcznego eksportu, żadnego przypomnienia w kalendarzu, żeby sprawdzić raporty linków.

To jest nagłówek. Mechanika liczy się bardziej, więc ten wpis przechodzi przez trzy rzeczy, którym zespoły sales ops muszą zaufać, zanim to włączą. Po pierwsze, jak faktycznie działa przepływ Connect: gdzie żyje Personal API token, co czyta selektor pipeline'u i jak token jest przechowywany po wklejeniu. Po drugie, co robi cron progowy przy każdym uruchomieniu i jak unika tworzenia zduplikowanych deali, gdy link wystrzeli wirusowo z dnia na noc. Po trzecie, co możesz, a czego nie możesz zmienić poza trzema domyślnymi progami i co jest planowane dalej.

Pipedrive przeszedł do Live dla Elido 22 maja 2026 roku. Wcześniej siedział w Beta przez dwa tygodnie, gdy wytrząsaliśmy przypadki brzegowe wokół identyfikatorów etapów i rotacji tokenów. Kod integracji żyje w services/api-core/internal/integrations/pipedrive/, jeśli hostujesz samodzielnie i chcesz przeczytać źródło. Tam, gdzie coś poniżej jest planowane, a nie wdrożone, wpis to mówi wprost.

Łączenie Pipedrive w dwie minuty

Otwórz katalog integracji w swoim workspace'ie Elido i kliknij kartę Pipedrive. Modal Connect prosi najpierw o jedną rzecz: Personal API token. Dostajesz go ze swojego konta Pipedrive, otwierając menu profilu, wybierając Personal preferences, a potem zakładkę API. Własny przewodnik Pipedrive jak znaleźć Personal API token ma dokładną ścieżkę ze zrzutami ekranu, bo ich interfejs zmienia się mniej więcej co kwartał.

Wklej token. Elido robi dwie rzeczy w tle. Waliduje token, wywołując GET /users/me względem API Pipedrive, co potwierdza, że token jest aktywny i mówi nam, do jakiej firmy Pipedrive należy token. Pobiera też listę aktywnych pipeline'ów dla tej firmy, więc następny krok w modalu pokazuje prawdziwe opcje, nie pola tekstowe do wypełnienia.

Modal zadaje potem jeszcze jedno pytanie: w którym pipeline'ie powinny lądować nowe deale? Lista rozwijana jest wypełniona Twoimi żywymi danymi Pipedrive. Jeśli masz trzy pipeline'y o nazwach Inbound, Outbound i Partners, widzisz te trzy. Wybierz ten, który pasuje do pracy, zwykle Inbound dla sygnałów napędzanych marketingiem, i kliknij Connect. Deale lądują na pierwszym etapie tego pipeline'u; wybór innego etapu docelowego jest planowany.

Co dzieje się z tokenem po Connect. Elido szyfruje go, zanim dotknie Postgresa, używając szyfrowania kopertowego z kluczem szyfrowania danych per najemca, owiniętym kluczem KMS workspace'u. Owinięty blob to jest to, co siedzi w 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 szczegółowości debug. Jeśli zrotujesz token w Pipedrive, następne uruchomienie crona dostanie 401, a Elido oznaczy integrację jako wymagającą ponownej autoryzacji, co objawia się banerem w workspace'ie, a nie cichą awarią. Higiena rotacji leży po Twojej stronie, awaria jest głośna.

Selektor pipeline'u to mały, ale ważny szczegół. Częstym trybem awarii w integracjach CRM jest tworzenie deali w niewłaściwym pipeline'ie, bo integracja została zbudowana, gdy firma miała jeden pipeline, a teraz ma sześć. Pozwolenie użytkownikowi na wybór przy Connect i pokazanie bieżącej listy zamiast cachowanej sprzed miesiąca usuwa całą tę klasę błędów. Możesz też połączyć się ponownie w dowolnym momencie, żeby zmienić cel selektora, bez utraty historii progów.

Co faktycznie robi cron co 5 minut

Wewnątrz services/api-core jest zadanie o nazwie click_threshold_hook. Działa co pięć minut. Przy każdym tyknięciu robi trzy rzeczy po kolei, per workspace, który ma połączony Pipedrive.

Po pierwsze, listuje aktywne linki workspace'u i czyta bieżący licznik kliknięć każdego, ten sam licznik, który serwis przekierowania inkrementuje przy każdym kliknięciu. Usunięte i nieaktywne linki są pomijane.

Po drugie, porównuje nową sumę każdego linku z zapisanymi progami. Domyślne progi to 100, 1000 i 10 000. Dla każdego linku Elido zapisuje każdy próg, który już wyprodukował deala, w wierszu integration_pipedrive_deals kluczowanym przez workspace, link i próg. Jeśli link był przy 80 kliknięciach przy ostatnim uruchomieniu, a teraz jest przy 240, różnica pokazuje, że próg 100 został przekroczony, a 1000 jeszcze nie zostało dotknięte. Oznaczamy 100 jako osiągnięty i kolejkujemy jedno utworzenie deala. Jeśli link skoczył z 80 do 1200, przekroczono zarówno 100, jak i 1000, więc kolejkujemy dwa utworzenia.

Po trzecie, dla każdego zakolejkowanego deala Elido wywołuje Deals API Pipedrive przez POST do /deals. Treść ustawia identyfikator pipeline'u z selektora Connect, nazywa deala Engagement: <slug> (<threshold> clicks) i zostawia wartość na zerze. Zapisywanie źródła, medium i kampanii UTM w notatce deala z linkiem z powrotem do widoku analityki Elido jest planowane, tak samo jak zapisywanie identyfikatora linku w polu niestandardowym Pipedrive.

Kilka rzeczy, których ten cron nie robi. Nie ponawia w ramach jednego tyknięcia. Jeśli Pipedrive zwróci błąd, nic nie jest zapisywane dla tego progu, więc następne tyknięcie po prostu próbuje ponownie. Limit szybkości Pipedrive w praktyce to 100 żądań na 2 sekundy per token firmy, co daje mnóstwo zapasu dla wolumenów, jakie napotka większość zespołów. Patrzy też tylko na aktywne linki, więc usunięte albo nieaktywne linki nigdy nie tworzą deali.

Zapobieganie duplikatom opiera się na tej tabeli. Przed każdym utworzeniem cron sprawdza istniejący wiersz (workspace_id, link_id, threshold_bucket), a późniejszy insert jest chroniony ograniczeniem unikalności na tych samych trzech kolumnach, więc awaria i ponowne uruchomienie nie tworzą drugiego deala dla tego samego kamienia milowego.

Rozszerzanie poza trzy domyślne

Wdrożone progi to 100, 1000 i 10 000. Większość zespołów zostaje przy nich, bo naturalnie mapują się na narrację sprzedażową. Sto kliknięć to łagodny sygnał wart spojrzenia. Tysiąc to kampania warta telefonu. Dziesięć tysięcy jest wystarczająco gorące, że przedstawiciel powinien już działać. Mimo to możesz chcieć innych liczb, a dziś nie możesz ich ustawić.

Integracja Pipedrive Elido używa tych samych trzech koszy dla każdego workspace'u, i nie ma jeszcze endpointu ani ustawienia dla niestandardowej listy progów.

Bogatsze wyzwalacze są na mapie drogowej, a nie wdrożone. Plan integracji obejmuje wyzwalacz progu ograniczony do kampanii z UTM kandydata na deala oraz wyzwalacz konwersji, który tworzy deala niosącego przechwyconą wartość zamówienia. Konfigurowalne przez użytkownika etapy docelowe i pola niestandardowe Pipedrive, takie jak Deal Source czy Lead Channel, są planowane też na następną wersję. Do czasu ich wdrożenia, jeśli potrzebujesz filtra UTM albo zbiorczego widoku folderu, odpytuj API analityki Elido z własnego zadania i twórz deala przez API Pipedrive samodzielnie.

Gdzie żyje token i jak go zrotować

Krótka sekcja, bo pojawia się w każdym przeglądzie bezpieczeństwa. Personal API token jest szyfrowany w spoczynku przy użyciu AES-256-GCM z kluczem szyfrowania danych per najemca. Sam DEK jest owinięty kluczem na poziomie workspace'u w naszym KMS, i tylko proces api-core może go odwinąć. Nie ma tokena w czystym tekście w żadnym logu, żadnym backupie, żadnym śladzie błędu. Przetestowaliśmy to wstrzyknięciem błędu, które wymusiło 401 od Pipedrive w środku żądania, a ścieżka błędu czyści token z odpowiedzi, zanim dotrze do Sentry.

Żeby zrotować: wygeneruj nowy Personal API token w Pipedrive, odwołaj stary, a potem wklej nowy z powrotem do modalu Connect Elido. Integracja waliduje nowy token, podmienia go na miejscu, a następne tyknięcie crona go używa. Jeśli zapomnisz zaktualizować Elido po odwołaniu starego tokena, następne tyknięcie crona dostaje 401, a integracja wchodzi w stan Needs Reauth, widoczny jako żółty baner na dashboardzie workspace'u. Żadnych cichych martwych tokenów.

Na self-host KMS jest podłączalny: domyślnie oparty na plikach, podłącz HashiCorp Vault albo swój KMS chmurowy. ADR-0036 omawia to w pełnej formie.

Gdzie to pasuje do szerszego lejka

Wyzwalacze deali Pipedrive z kliknięć to jeden element większego wzorca. Liczby kliknięć to wskaźnik wyprzedzający, nie liczba przychodowa, więc zwykle chcesz, żeby płynęły do CRM, gdzie żyje reszta kontekstu sprzedażowego. Deal to przekazanie: marketing zrobił swoje, sprzedaż przejmuje. Stamtąd Twoje normalne workflow Pipedrive przejmują pałeczkę: przypisanie deala do przedstawiciela, ocenianie go, przesuwanie przez etapy, zamykanie.

Jeśli przekazujesz też konwersje do platform reklamowych, te same dane o kliknięciach zasilają oba przepływy. Funkcja śledzenia konwersji obsługuje stronę reklamową, integracja Pipedrive obsługuje stronę CRM, i te dwie nigdy nie walczą o to samo zdarzenie. Najczęściej widzimy tę kombinację na stronie rozwiązania dla marketerów, gdzie cały stos to płatne pozyskiwanie w brandowane linki w lejek CRM.

Dla analityków, którzy chcą utrzymać uczciwe liczby, dwa wcześniejsze wpisy omawiają kwestie wyżej w łańcuchu. Analityka krótkich linków: co mierzyć omawia, które metryki kliknięć faktycznie korelują z przychodem, a Śledzenie UTM od początku do końca omawia higienę UTM, która sprawia, że notatki deala są przydatne, a nie zaszumione. Oba dobrze łączą się z tą integracją, bo deal, który tworzy Pipedrive, jest tylko tak przydatny, jak dane UTM, które niesie.

Ostatni szczegół o planach. Integracja Pipedrive jest na każdym płatnym poziomie Elido, a 14-dniowy trial ją zawiera, więc możesz udowodnić swoją listę progów, zanim się zarejestrujesz. Darmowe workspace'y mogą utworzyć połączenie do testów, ale cron nie wystrzeliwuje dla darmowych linków. Strona z cennikiem ma rozkład per poziom.

Lista kontrolna konfiguracji

Wydrukuj to, zrób raz.

1. W Pipedrive: menu profilu, Personal preferences, zakładka API, skopiuj token.
2. W Elido: Integrations, karta Pipedrive, Connect.
3. Wklej token. Poczekaj na walidację.
4. Wybierz pipeline. Domyślnie Inbound; deale lądują na jego pierwszym etapie.
5. Kliknij Connect.
6. Poczekaj pięć minut. Wyślij kilka testowych kliknięć. Obserwuj, jak ląduje pierwszy deal.

To wszystko. Jeśli hostujesz samodzielnie, cron działa wewnątrz procesu api-core, a nie jako osobne zadanie, i potrzebuje skonfigurowanego połączenia Redis oraz głównego klucza sekretów; bez żadnego z nich cicho się pomija. Na Elido Cloud cron jest zarządzany za Ciebie.