Відстеження кліків посилань Pipedrive: угоди з переходів за коротким посиланням

Відстеження кліків посилань Pipedrive в Elido перетворює позначки коротких посилань на події у воронці. Коли одне з ваших посилань перетинає позначку 100, 1000 чи 10000 кліків, 5-хвилинний cron створює угоду у воронці Pipedrive, яку ви обрали, з назвою, що містить slug посилання і позначку. Нотатки угоди з джерелом UTM і глибоким посиланням назад в Elido - заплановані. Жодного Zapier посередині, жодного ручного експорту, жодного нагадування в календарі перевіряти звіти про посилання.

Це заголовок. Механіка важливіша, тож цей матеріал розглядає три речі, яким команди sales ops мають довіряти, перш ніж вмикати це. По-перше, як насправді працює потік Connect: де живе персональний API-токен, що читає вибір воронки і як токен зберігається після того, як ви його вставите. По-друге, що робить cron порогів на кожному запуску і як він уникає створення дублікатів угод, коли посилання раптово стає вірусним. По-третє, що ви можете і не можете змінити поза трьома стандартними порогами, і що заплановано далі.

Pipedrive перейшов у статус Live для Elido 22 травня 2026 року. До того він два тижні пробув у Beta, поки ми виправляли крайні випадки з ID етапів і ротацією токенів. Код інтеграції лежить у services/api-core/internal/integrations/pipedrive/, якщо ви самостійно розгортаєте систему і хочете прочитати вихідний код. Там, де щось нижче ще заплановано, а не реалізовано, матеріал прямо про це каже.

Підключення Pipedrive за дві хвилини

Відкрийте каталог інтеграцій у вашому робочому просторі Elido і натисніть картку Pipedrive. Модальне вікно Connect спершу запитує одне: персональний API-токен. Ви отримуєте його у своєму акаунті Pipedrive, відкривши меню профілю, обравши Personal preferences, а потім вкладку API. Власний гайд Pipedrive як знайти персональний API-токен має точний шлях зі скриншотами, бо їхній інтерфейс змінюється приблизно щокварталу.

Вставте токен. Elido робить дві речі у фоновому режимі. Він перевіряє токен, викликаючи GET /users/me в API Pipedrive, що підтверджує дійсність токена і повідомляє нам, якій компанії Pipedrive він належить. Він також отримує список активних воронок цієї компанії, тож наступний крок у модальному вікні показує реальні варіанти, а не поле вільного тексту.

Далі модальне вікно запитує ще одне: у яку воронку мають потрапляти нові угоди? Випадний список заповнюється з ваших живих даних Pipedrive. Якщо у вас три воронки з назвами Inbound, Outbound і Partners, ви побачите саме ці три. Оберіть ту, що підходить для завдання, зазвичай Inbound для сигналів, керованих маркетингом, і натисніть Connect. Угоди потрапляють на перший етап цієї воронки; вибір іншого цільового етапу - заплановано.

Що відбувається з токеном після Connect. Elido шифрує його ще до того, як він потрапляє в Postgres, використовуючи envelope encryption з ключем шифрування даних для кожного тенанта, обгорнутим ключем KMS робочого простору. У таблиці integration_credentials зберігається саме обгорнутий блок. Токен у відкритому вигляді існує в пам'яті лише протягом одного виклику API, і ми ніколи його не логуємо, навіть на рівні debug. Якщо ви ротуєте токен у Pipedrive, наступний запуск cron отримає 401, і Elido позначить інтеграцію як таку, що потребує повторної авторизації - це проявляється як банер у робочому просторі, а не тиха відмова. Гігієна ротації - на вас, а збій - гучний.

Вибір воронки - деталь невелика, але важлива. Поширений режим збою в CRM-інтеграціях - створення угод у неправильній воронці, бо інтеграцію налаштовували, коли в компанії була одна воронка, а тепер їх шість. Дозволивши користувачу обирати під час Connect і показуючи актуальний список замість кешованого місячної давнини, ми прибираємо весь цей клас помилок. Ви також можете перепідключитися будь-коли, щоб змінити ціль вибору, не втрачаючи історію порогів.

Що насправді робить 5-хвилинний cron

Усередині services/api-core є завдання під назвою click_threshold_hook. Воно запускається кожні п'ять хвилин. На кожному тіку воно виконує три дії по порядку для кожного робочого простору з підключеним Pipedrive.

Спершу воно перелічує активні посилання робочого простору і читає поточний лічильник кліків кожного - той самий лічильник, що збільшує сервіс редиректу на кожному кліку. Видалені і неактивні посилання пропускаються.

По-друге, воно порівнює нову суму кожного посилання із записаними порогами. Стандартні пороги - 100, 1000 і 10000. Для кожного посилання Elido записує кожен поріг, що вже створив угоду, у рядок integration_pipedrive_deals, ключем якого є робочий простір, посилання і поріг. Якщо посилання мало 80 кліків на попередньому запуску, а тепер має 240, порівняння показує, що поріг 100 перетнуто, а 1000 - ще ні. Ми позначаємо 100 як досягнутий і додаємо одне створення угоди в чергу. Якщо посилання стрибнуло з 80 до 1200, перетнуто і 100, і 1000, тож ми додаємо в чергу два створення.

По-третє, для кожної угоди в черзі Elido викликає Deals API Pipedrive через POST на /deals. Тіло встановлює ID воронки з вибору під час Connect, називає угоду Engagement: <slug> (<threshold> clicks) і лишає значення нульовим. Запис джерела, каналу і кампанії UTM у нотатку угоди з посиланням назад на аналітику Elido - заплановано, так само як і збереження ID посилання у власному полі Pipedrive.

Кілька речей цей cron не робить. Він не повторює спробу в межах одного тіку. Якщо Pipedrive повертає помилку, для цього порогу нічого не записується, тож наступний тік просто пробує знову. Ліміт швидкості Pipedrive на практиці - 100 запитів на 2 секунди на токен компанії, чого більш ніж достатньо для обсягів, з якими стикається більшість команд. Він також дивиться лише на активні посилання, тож видалені чи неактивні посилання ніколи не створюють угод.

Запобігання дублікатам спирається саме на цю таблицю. Перед кожним створенням cron перевіряє наявність рядка (workspace_id, link_id, threshold_bucket), а наступна вставка захищена унікальним обмеженням на ці ж три стовпці, тож збій і повторний запуск не створюють другу угоду для тієї самої позначки.

Розширення за межі трьох стандартних порогів

Реалізовані пороги - 100, 1000 і 10000. Більшість команд лишають їх такими, бо вони природно вписуються в сценарій продажів. Сотня кліків - слабкий сигнал, вартий погляду. Тисяча - кампанія, варта дзвінка. Десять тисяч - настільки гарячий сигнал, що представник продажів вже мав би діяти. Утім, вам можуть знадобитися інші числа, і сьогодні ви не можете їх встановити.

Інтеграція Pipedrive Elido використовує ті самі три позначки для кожного робочого простору, і поки що немає ні кінцевої точки, ні налаштування для власного списку порогів.

Багатші тригери в дорожній карті, але ще не реалізовані. План інтеграції включає тригер порогу, прив'язаний до кампанії з UTM-кандидатом на угоду, і тригер конверсії, що створює угоду з захопленою вартістю замовлення. Налаштовувані користувачем цільові етапи і власні поля Pipedrive на кшталт Deal Source чи Lead Channel також заплановані на наступну версію. Поки вони не з'явилися, якщо вам потрібен фільтр UTM чи згортання по теках, опитуйте API аналітики Elido у власному завданні і створюйте угоду через API Pipedrive самостійно.

Де живе токен і як його ротувати

Короткий розділ, бо це питання виникає на кожному огляді безпеки. Персональний API-токен шифрується у стані спокою за допомогою AES-256-GCM з ключем шифрування даних для кожного тенанта. Сам DEK обгорнутий ключем рівня робочого простору в нашому KMS, і розгорнути його може лише процес api-core. Жодного токена у відкритому вигляді немає в жодному логу, жодному бекапі чи трасуванні помилок. Ми перевірили це впровадженням несправності, що змусило Pipedrive повернути 401 посеред запиту, і шлях обробки помилки прибирає токен з відповіді перед тим, як вона дістається Sentry.

Щоб ротувати: згенеруйте новий персональний API-токен у Pipedrive, відкличте старий, а потім вставте новий у модальне вікно Connect Elido знову. Інтеграція перевіряє новий токен, підміняє його на місці, і наступний тік cron використовує саме його. Якщо ви забудете оновити Elido після відкликання старого токена, наступний тік cron отримає 401, і інтеграція перейде в стан Needs Reauth, видимий як жовтий банер на дашборді робочого простору. Жодних тихо мертвих токенів.

На самостійному розгортанні KMS підключається як модуль: за замовчуванням на основі файлів, можна підмінити на HashiCorp Vault чи хмарний KMS. Розгорнуту версію описує ADR-0036.

Місце цього в ширшій воронці

Тригери угод Pipedrive з кліків - лише частина ширшого патерну. Кількість кліків - випереджувальний індикатор, а не показник доходу, тож зазвичай хочеться, щоб вони потрапляли в CRM, де живе решта контексту продажів. Угода - це передача: маркетинг зробив свою роботу, продажі її підхоплюють. Далі вступають ваші звичні робочі процеси Pipedrive: призначення угоди представнику, оцінка, просування етапами, закриття.

Якщо ви також пересилаєте конверсії в рекламні платформи, ті самі дані про кліки живлять обидва потоки. Функція відстеження конверсій обробляє рекламну сторону, інтеграція Pipedrive - сторону CRM, і вони ніколи не конкурують за ту саму подію. Найчастіше ми бачимо цю комбінацію на сторінці рішення для маркетологів, де весь стек - це платне залучення в брендовані посилання у воронку CRM.

Для аналітиків, які хочуть тримати свої числа чесними, два попередні матеріали розглядають суміжні питання вище за потоком. Аналітика коротких посилань: що вимірювати розглядає, які метрики кліків насправді корелюють з доходом, а Наскрізне відстеження UTM розглядає гігієну UTM, яка робить нотатки угоди корисними, а не шумними. Обидва добре поєднуються з цією інтеграцією, оскільки угода, яку створює Pipedrive, корисна рівно настільки, наскільки корисні дані UTM, які вона несе.

Останнє про тарифні плани. Інтеграція Pipedrive доступна на кожному платному рівні Elido, і 14-денний пробний період її включає, тож ви можете перевірити свій список порогів до оплати. Безкоштовні робочі простори можуть створити з'єднання для тестування, але cron не спрацьовує для безкоштовних посилань. Сторінка цін містить розбивку по рівнях.

Чекліст налаштування

Роздрукуйте це, зробіть один раз.

1. У Pipedrive: меню профілю, Personal preferences, вкладка API, скопіюйте токен.
2. В Elido: Integrations, картка Pipedrive, Connect.
3. Вставте токен. Зачекайте на перевірку.
4. Оберіть воронку. За замовчуванням Inbound; угоди потрапляють на її перший етап.
5. Натисніть Connect.
6. Зачекайте п'ять хвилин. Надішліть кілька тестових кліків. Подивіться, як приземлиться перша угода.

От і все. Якщо ви самостійно розгортаєте систему, cron працює всередині процесу api-core, а не як окреме завдання, і йому потрібне з'єднання з Redis і налаштований головний ключ секретів; без будь-якого з них він мовчки пропускає крок. На Elido Cloud cron керується за вас.