Интеграция
Pipedrive, где воронка и есть весь продукт
Интеграция с Pipedrive позволяет Telegram-боту создавать людей, организации и сделки и двигать сделки по этапам воронки. Модель объектов здесь самая простая среди распространённых CRM, поэтому такая интеграция делается быстрее всех остальных, — а вот смена этапа всё равно требует аккуратности.
Pipedrive — интеграция: доступ, лимиты и доступность
- Модель авторизации
- Ключ API
- Лимит частоты
- На каждый токен API, с допуском на всплеск и скользящим бюджетом
- Доступность в Заливе
- Региональных ограничений нет; регион хранения выбирается на уровне аккаунта
- Схема данных
- 5 узлов, всё через воркер
As of 2025-10-01, Telegram Bot API 13.4
Зачем нужна эта интеграция
Pipedrive держится в отделах продаж тем, что занимается одной вещью. Есть воронка, по ней движутся сделки, всё остальное подчинено этому. Такая сосредоточенность видна в API: меньше объектов, понятнее связи и несравнимо меньше накопленных настроек, чем у платформы, которая заодно старается быть ещё и маркетинговым пакетом.
Для интеграции с Telegram это имеет прямое практическое значение. Продавец, обновляющий сделку из такси, хочет уложиться в два касания, а операции, осмысленные в переписке — передвинуть на следующий этап, записать активность, поставить дату следующего шага, — ложатся на понятия Pipedrive почти один в один. Никакого переходного слоя изобретать не приходится.
Осторожность нужна вокруг смены этапа, потому что в Pipedrive смена этапа — не нейтральная правка. Она кормит прогноз продаж, она запускает автоматизацию, и именно по ней руководитель продаж понимает, как прошла неделя. Бот, разрешающий кому угодно двигать любую сделку из чата, наплодит данные об этапах, отражающие, у кого телефон был под рукой, а не то, что произошло на самом деле. Поэтому набор доступных операций и круг тех, кому они разрешены, — это осознанное решение, а не следствие того, что API это позволяет.
Как на самом деле движутся данные
Токен API, привязанный к конкретному пользователю и хранимый в секретах воркера. Токен наследует видимость этого пользователя, поэтому токен продавца видит только его собственные сделки — и это либо ровно то, что нужно, либо тихий источник недостающих данных, смотря что вы имели в виду. Для бота, действующего от лица всей команды, правильная схема — выделенный технический пользователь с явно заданной областью видимости.
Модель доступа: API-ключ
Их лимиты и что они означают для вас
Лимиты частоты применяются к каждому токену API отдельно, с допуском на всплеск и скользящим бюджетом.
Поскольку лимит привязан к токену, один общий токен на несколько ботов расходует один бюджет. Отдельные токены на каждую интеграцию не дают одной загруженной задаче придушить другую.
Сделка в каждый момент принадлежит ровно одной воронке и ровно одному этапу.
Перенос сделки в другую воронку сбрасывает её этап. Бот, предлагающий смену воронки, обязан обрабатывать это явно, а не исходить из того, что позиция сохранится.
Пользовательские поля адресуются сгенерированным хеш-ключом, а не именем.
Сопоставление хранит хеш, выясненный один раз при настройке. Сопоставление по подписи ломается в момент, когда поле переименуют, а ломается оно как молчаливая запись в никуда.
Доставка webhook гарантируется как минимум однократно, и в нём приходит и прежнее значение, и новое.
Обработчики идемпотентны, а прежнее значение действительно полезно: оно позволяет боту сообщать, что именно изменилось, а не только каким значение стало.
Как это ломается и что происходит потом
У токена интеграции область видимости уже, чем предполагалось.
Сделки просто не появляются, и ошибки при этом нет. Это самый частый сюрприз интеграции с Pipedrive и ровно та причина, по которой выделенный технический пользователь с явной видимостью предпочтительнее личного токена.
Сделка переведена на этап, запускающий автоматизацию, которую никто не разбирал.
Существующая автоматизация отрабатывает на записи от бота так же, как на действия человека. Её разбор входит в оценку работ: смена этапа, отправляющая письмо клиенту, — запоминающийся способ узнать о ней.
Запись в пользовательское поле молча ничего не делает.
Почти всегда это устаревший хеш поля после переименования или пересоздания. Сопоставления проверяются при запуске, и неразрешимый ключ падает громко, а не пишет в пустоту.
Двое продавцов двигают одну сделку с разницей в секунды.
Побеждает последняя запись, без всякой ошибки, — как в большинстве CRM. Ответный webhook означает, что оба увидят фактическое итоговое состояние, а не каждый своё намерение.
Доступность в ОАЭ и остальных странах Залива
Весь мир
Региональных ограничений нет. Регион хранения данных на части тарифов выбирается на уровне аккаунта.
Небольшие и средние отделы продаж
Тот самый случай, ради которого всё сделано, и там эта интеграция действительно быстрая. Команды примерно до пятидесяти продавцов получают от неё почти всю пользу.
Потребность в маркетинговой автоматизации
Здесь она тонкая по сравнению с HubSpot. Если требования выходят за пределы управления воронкой, сравнение меняется существенно.
Сложные маршруты согласований
Это не тот инструмент. Pipedrive намеренно остаётся воронкой, а не движком процессов, и попытка вписать в него согласования порождает данные об этапах, которым никто не верит.
Когда эту интеграцию делать не нужно
- Вам нужна маркетинговая автоматизация рядом с воронкой. HubSpot закрывает и то и другое; попытка впихнуть её в Pipedrive всё равно означает две системы.
- Вашему процессу нужны согласования и ветвления. Pipedrive по замыслу воронка, и его выгибание порождает данные об этапах, которым ваши руководители перестанут доверять.
- Двигать любую сделку из чата должны все. Удобно — и на выходе история этапов, фиксирующая, у кого телефон был под рукой.
- Ваша команда на самом деле не работает в Pipedrive. Интеграция с неиспользуемой CRM даёт правильные данные, которые никто не читает.
На чём это работает
| Компонент | Версия | Зачем |
|---|---|---|
| Cloudflare Workers | current | Запись через очередь и обработка webhook. |
| Cloudflare D1 | current | Очередь записи, хеши пользовательских полей и история изменений. |
| Zod | 4.4 | Валидация ответов API и содержимого webhook. |
| grammY | 1.45 | Команды продавца и действия по смене этапа кнопками. |
Вопросы, которые возникают при оценке
Почему именно эта интеграция с CRM делается быстрее всех?
Потому что модель объектов небольшая, а операции, осмысленные в переписке, ложатся на понятия Pipedrive почти один в один. Переходный слой проектировать не надо, а именно на него уходит большая часть времени на более крупных платформах.
Почему бот не видит часть сделок?
Почти всегда из-за видимости токена. Токен API наследует права своего владельца, поэтому личный токен видит только сделки этого человека — и никакой ошибки, сообщающей, что чего-то не хватает, при этом нет. Выделенный технический пользователь снимает вопрос.
Должны ли все сотрудники двигать сделки прямо из Telegram?
Осознанно нет. Смена этапа кормит прогноз и запускает автоматизацию, поэтому открытый для всех доступ даёт данные, отражающие удобство, а не реальность. Кому что разрешено двигать — это решение, а не значение прав по умолчанию.
Почему запись в пользовательские поля иногда ничего не даёт?
Пользовательские поля адресуются сгенерированным хешем, а не именем, и устаревший хеш пишет в пустоту. Сопоставления проверяются при запуске, поэтому неразрешимый ключ падает громко, а не молча.
Что произойдёт, если двое одновременно обновят одну сделку?
Победит последняя запись, без ошибки, — это норма для CRM без управления конкурентным доступом. Ответный webhook означает, что обоим показывают фактическое итоговое состояние, а не подтверждение собственного намерения каждому.
Может ли бот создавать сделки, а не только двигать их?
Да, со сверкой человека и организации перед созданием, чтобы повторное обращение не завело второго человека. Дубли во всех CRM берутся именно из создания, и Pipedrive тут не исключение.
Что почитать дальше
Если маркетинговая автоматизация тоже входит в объём работ, стоит посмотреть на интеграцию с HubSpot.
Ещё один частый выбор команд такого размера в Заливе — интеграция с Zoho CRM.
Общее устройство двусторонней интеграции с CRM описано в разборе бота, подключённого к CRM.
Что наполняет воронку в самом её начале, показывает разбор бота квалификации лидов.