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

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

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

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

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

Откройте каталог интеграций в вашем рабочем пространстве Elido и нажмите на карточку Pipedrive. Модальное окно подключения сначала запросит одну вещь: Personal API token. Вы получаете его в своем аккаунте Pipedrive, открыв меню профиля, выбрав Personal preferences, а затем вкладку API. Собственное руководство Pipedrive как найти Personal API token содержит точный путь со скриншотами, поскольку их интерфейс меняется примерно раз в квартал.

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

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

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

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

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

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

Сначала она получает список активных ссылок рабочего пространства и читает у каждой непрерывный счетчик кликов - тот же счетчик, который сервис редиректа увеличивает при каждом клике. Удаленные и неактивные ссылки пропускаются.

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

Затем, для каждой сделки в очереди, Elido вызывает Deals API Pipedrive с POST-запросом на /deals. В теле запроса задается ID воронки из селектора при подключении, сделке присваивается название Engagement: <slug> (<threshold> clicks), а сумма остается нулевой. Запись источника, medium и кампании UTM в заметку сделки со ссылкой обратно на аналитику Elido пока в планах, как и сохранение ID ссылки в пользовательском поле Pipedrive.

Есть несколько вещей, которые этот cron не делает. Он не повторяет попытку внутри одного запуска. Если Pipedrive возвращает ошибку, для этого порога ничего не фиксируется, и на следующем запуске просто предпринимается новая попытка. Лимит запросов Pipedrive на практике составляет 100 запросов за 2 секунды на токен компании, чего с запасом хватает для объемов, с которыми сталкивается большинство команд. Также он смотрит только на активные ссылки, поэтому удаленные или неактивные ссылки никогда не создают сделок.

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

Расширение за пределы трех значений по умолчанию

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

Интеграция Elido с Pipedrive использует одни и те же три отметки для каждого рабочего пространства, и пока нет ни endpoint, ни настройки для собственного списка порогов.

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

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

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

Чтобы ротировать токен: сгенерируйте новый Personal API token в Pipedrive, отзовите старый, затем вставьте новый в модальное окно подключения Elido еще раз. Интеграция проверяет новый токен, подменяет его на месте, и следующий запуск cron использует уже его. Если вы забыли обновить Elido после отзыва старого токена, следующий запуск cron получит 401, и интеграция перейдет в состояние Needs Reauth, видимое как желтый баннер на дашборде рабочего пространства. Никаких тихо умерших токенов.

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

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

Триггеры сделок Pipedrive по кликам - лишь часть более широкого паттерна. Количество кликов - опережающий индикатор, а не показатель выручки, поэтому обычно вы хотите, чтобы они попадали в CRM, где живет весь остальной контекст продаж. Сделка - это точка передачи: маркетинг сделал свою работу, продажи ее подхватывают. Дальше вступают ваши обычные workflow 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. Подождите пять минут. Отправьте несколько тестовых кликов. Понаблюдайте, как появится первая сделка.

Вот и все. Если вы используете self-host, cron выполняется внутри процесса api-core, а не как отдельная задача, и ему нужно подключение к Redis и настроенный мастер-ключ секретов; без любого из них он молча пропускает запуск. В Elido Cloud cron управляется за вас.