Отслеживание кликов Pipedrive: сделки из кликов по коротким ссылкам

Отслеживание кликов Pipedrive в Elido превращает вехи коротких ссылок в события воронки. Когда одна из ваших ссылок преодолевает 100, 1000 или 10 000 кликов, cron, запускаемый каждые 5 минут, создаёт сделку в выбранных воронке и этапе Pipedrive - со слагом ссылки, источником UTM и прямой ссылкой обратно в Elido в заметках к сделке. Без Zapier посередине, без ручного экспорта, без напоминания в календаре проверить отчёты по ссылкам.

Это заголовок. Механика важнее, поэтому в этой статье мы разберём три вещи, которые команды sales ops должны понять перед включением функции. Во-первых, как на самом деле работает процесс подключения: где хранится личный токен API, что считывает выбор воронки и как токен сохраняется после вставки. Во-вторых, что делает cron порогов при каждом запуске и как он предотвращает создание дублирующих сделок, когда ссылка за ночь становится вирусной. В-третьих, как расширить интеграцию за пределы трёх стандартных порогов - до произвольных значений кликов, триггеров с фильтрацией по UTM и пользовательских полей Pipedrive - с помощью Elido SDK и небольшого обработчика webhook.

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

Подключение Pipedrive за две минуты

Откройте каталог интеграций в рабочем пространстве Elido и нажмите на карточку Pipedrive. Модальное окно Connect сначала запрашивает одно: личный токен API. Его можно получить в аккаунте Pipedrive, открыв меню профиля, выбрав «Личные настройки», а затем вкладку API. В официальном руководстве Pipedrive по how to find the Personal API token есть точный путь со скриншотами - их интерфейс меняется примерно раз в квартал.

Вставьте токен. Elido выполняет в фоне два действия. Проверяет токен, вызывая GET /users/me в Pipedrive API, что подтверждает активность токена и сообщает, к какой компании Pipedrive он принадлежит. Также загружает список воронок и этапов для этой компании, чтобы следующий шаг в модальном окне показывал реальные варианты, а не поля свободного ввода.

Затем модальное окно задаёт ещё два вопроса. В какую воронку должны попадать новые сделки? На какой этап этой воронки? Выпадающие списки заполняются из ваших актуальных данных Pipedrive. Если у вас три воронки с названиями Inbound, Outbound и Partners, вы увидите именно их. Выберите подходящую - обычно Inbound для сигналов от маркетинга - и первый квалификационный этап. Нажмите «Подключить».

Что происходит с токеном после подключения. Elido шифрует его ещё до записи в Postgres, используя конвертное шифрование с ключом шифрования данных на уровне арендатора, который обёрнут ключом KMS рабочего пространства. В таблице integration_credentials хранится именно этот зашифрованный blob. Токен в открытом виде существует в памяти только на время одного вызова API и никогда не попадает в логи - даже на уровне debug. Если вы ротируете токен в Pipedrive, следующий запуск cron получит 401, и Elido пометит интеграцию как требующую повторной аутентификации - это отобразится баннером в рабочем пространстве, а не тихим сбоем. За соблюдение гигиены ротации отвечаете вы; при проблеме будет явное уведомление.

Выбор воронки - небольшая, но важная деталь. Частый сценарий отказа в интеграциях CRM: сделки создаются в неправильной воронке, потому что интеграция была настроена, когда у компании была одна воронка, а теперь их шесть. Предоставление пользователю выбора при подключении и показ актуального списка вместо кеша месячной давности устраняет целый класс ошибок. Вы также можете в любой момент переподключиться, чтобы изменить целевую воронку, не потеряв историю порогов.

Что на самом деле делает cron раз в 5 минут

В services/api-core есть задача с именем click_threshold_hook. Она запускается каждые пять минут. При каждом тике она последовательно выполняет три операции для каждого рабочего пространства с подключённым Pipedrive.

Первое: запрашивает у ClickHouse суммарные клики по ссылкам, обновлённые за последние шесть минут, плюс буфер в одну минуту для учёта запоздавших событий. ClickHouse хранит события кликов в таблице clicks, партиционированной по дате, а запрашиваемый rollup - это материализованное представление с ключом по ID короткой ссылки. Запрос возвращает только ссылки, чьи суммы изменились с предыдущего запуска cron, а не всю таблицу. На рабочем пространстве с 50 000 активными ссылками при обычном паттерне кликов этот запрос выполняется менее чем за 200 мс.

Второе: сравнивает новый итог каждой ссылки с зафиксированными порогами. Стандартные пороги - 100, 1000 и 10 000. Для каждой ссылки Elido хранит наивысший достигнутый порог в небольшой строке link_threshold_state с ключом по ID ссылки. Если при последнем запуске ссылка имела 80 кликов, а теперь 240, сравнение показывает, что порог 100 пересечён, а 1000 ещё нет. Мы помечаем 100 как достигнутый и ставим одно создание сделки в очередь. Если ссылка прыгнула с 80 до 1200 - пересечены и 100, и 1000, поэтому в очередь ставятся два создания.

Третье: для каждой сделки в очереди Elido вызывает Deals API Pipedrive с POST на /deals. Тело запроса устанавливает ID воронки и ID этапа из настроек подключения, задаёт читаемое название сделки вроде Ссылка <слаг> достигла <порог> кликов и записывает источник UTM, медиум и кампанию в заметку к сделке вместе с кликабельной ссылкой на аналитику этой ссылки в Elido. Мы также сохраняем ID ссылки в пользовательское поле Pipedrive, если оно настроено в рабочем пространстве, - это позволяет позже запрашивать у Pipedrive все сделки, связанные с конкретной ссылкой Elido.

Несколько вещей, которые этот cron не делает. Он не повторяет попытки бесконечно при ошибках 5xx Pipedrive. Если Pipedrive возвращает 500 или 503, мы делаем два повтора с экспоненциальной задержкой в рамках того же тика, а затем оставляем работу следующему тику. Лимит запросов Pipedrive на практике составляет 100 запросов за 2 секунды на корпоративный токен - этого с запасом хватает для объёмов большинства команд. Мы также не создаём сделки для ссылок, помеченных как тестовые, внутренние или принадлежащих участнику рабочего пространства, который отключил синхронизацию CRM в личных настройках.

Предотвращение дублей потребовало наибольшего числа итераций. В первой версии была гонка состояний: если два пода cron работали одновременно, оба могли увидеть одну ссылку, пересекающую 100, и оба делали POST сделки. Мы решили это с помощью advisory lock Postgres на ID рабочего пространства в начале каждого тика cron, а также уникального ограничения на (link_id, threshold) в link_threshold_state. Если второй под попытается вставить дублирующую строку, Postgres отклонит её, и POST из очереди будет отброшен ещё до обращения к Pipedrive. Двойная страховка.

Расширение за пределы трёх стандартных порогов

Встроенные пороги - 100, 1000 и 10 000. Большинство команд их сохраняют, поскольку они естественно вписываются в логику продаж. Сто кликов - слабый сигнал, заслуживающий внимания. Тысяча - кампания, которая требует звонка. Десять тысяч - достаточно горячий сигнал, чтобы менеджер уже действовал. Тем не менее вам могут понадобиться другие значения, и SDK это поддерживает.

Интеграция Pipedrive в Elido принимает пользовательский список порогов на уровне рабочего пространства. Его задают через endpoint PATCH /v1/workspaces/:id/integrations/pipedrive с JSON-телом вида {"thresholds": [50, 500, 5000, 50000]}. Cron подхватывает новый список при следующем тике. Таблица состояния сохраняет историю, поэтому изменение порогов не создаёт сделки ретроактивно - оно меняет только то, какие будущие пересечения будут срабатывать.

Для более сложных триггеров SDK предоставляет хук CreateDeal, который можно зарегистрировать из любого сервиса. Классический случай: создавать сделку только тогда, когда ссылка пересекает порог И источник UTM - ваша платная социальная кампания, а не органический блог. Это однострочный фильтр внутри хука. Другой распространённый случай: срабатывать только на ссылках внутри конкретной папки Elido, потому что именно там находятся ссылки кампании, а всё остальное - шум. Тот же хук может устанавливать пользовательские поля Pipedrive, такие как «Источник сделки», «Канал лида» или любую таксономию, принятую в вашей команде sales ops. В руководстве по переадресации конверсий описан тот же паттерн хука для рекламных платформ - случай с Pipedrive структурно идентичен.

Замечание о пользовательских полях. SDK принимает как читаемую метку, так и хешированный API-ключ, который Pipedrive использует внутренне. Если вы ссылаетесь на метку, которой нет в подключённой компании, сделка всё равно создаётся, а отсутствующее поле логируется как предупреждение, но никак не ошибка. Отсутствующее пользовательское поле не должно блокировать реальный сигнал продаж.

Команды с большим количеством ссылок на кампанию иногда хотят агрегировать пороги по папке. Укажите aggregation: "folder" в конфигурации интеграции рабочего пространства, и cron будет группировать суммарные клики по папкам, проверяя общую сумму. Название сделки включает папку, а в заметках перечислены три ссылки с наибольшим вкладом.

Где хранится токен и как его ротировать

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

Для ротации: сгенерируйте новый личный токен API в Pipedrive, отзовите старый, затем вставьте новый в модальное окно Connect в Elido. Интеграция проверит новый токен, заменит его на месте, и следующий тик cron будет использовать его. Если вы забудете обновить Elido после отзыва старого токена, следующий тик cron получит 401, и интеграция перейдёт в состояние «Требуется повторная аутентификация» - видимое как жёлтый баннер на панели рабочего пространства. Никаких тихих мёртвых токенов.

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

Как это вписывается в более широкую воронку

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

Если вы также перенаправляете конверсии на рекламные платформы, одни и те же данные кликов питают оба потока. Функция отслеживания конверсий обрабатывает сторону рекламы, интеграция Pipedrive - сторону CRM, и они никогда не конкурируют за одно и то же событие. Эта комбинация чаще всего встречается на странице решений для маркетологов, где весь стек - это платное привлечение через брендированные ссылки в CRM-воронку.

Для аналитиков, которые хотят сохранять точность чисел, два более ранних материала освещают вопросы выше по потоку. Short link analytics: what to measure - о том, какие метрики кликов реально коррелируют с выручкой, Track UTM end to end - о гигиене UTM, которая делает заметки к сделкам полезными, а не шумными. Оба хорошо сочетаются с этой интеграцией, поскольку создаваемая Pipedrive сделка полезна ровно настолько, насколько полны UTM-данные, которые она несёт.

Последняя деталь о планах. Интеграция Pipedrive доступна на каждом платном уровне Elido, а 14-дневный пробный период включает её, чтобы вы могли проверить список порогов до подписки. Бесплатные рабочие пространства могут создать подключение для тестирования, но cron не срабатывает для бесплатных ссылок. На странице тарифов есть разбивка по уровням.

Чек-лист настройки

Распечатайте, выполните один раз.

1. В Pipedrive: меню профиля, «Личные настройки», вкладка API, скопировать токен.
2. В Elido: «Интеграции», карточка Pipedrive, «Подключить».
3. Вставить токен. Дождаться проверки.
4. Выбрать воронку и этап. По умолчанию: Inbound и первый квалификационный этап.
5. Нажать «Подключить».
6. Опционально: отредактировать список порогов, если 100/1k/10k не соответствует вашему процессу продаж.
7. Опционально: зарегистрировать пользовательский хук CreateDeal для фильтрации по UTM или агрегации по папкам.
8. Подождать пять минут. Отправить несколько тестовых кликов. Убедиться, что появилась первая сделка.

Вот и всё. При самостоятельном хостинге также проверьте, что cron включён: kubectl get cronjob api-core-click-threshold-hook должен возвращать активное расписание. В Elido Cloud cron управляется за вас.