Kommo + DocuSign: автоматизация подписания документов из воронки продаж

Сделка согласована — но до закрытия ещё далеко. Менеджер вручную создаёт договор в DocuSign, заполняет реквизиты клиента, отправляет на подпись, ждёт, потом вручную обновляет статус сделки в Kommo. При 30–40 сделках в месяц это часы рутины и постоянный риск отправить документ с ошибкой в данных. Кастомная интеграция Kommo и DocuSign закрывает этот разрыв: документ уходит на подпись автоматически, а при подписании сделка переходит на следующий этап без участия менеджера.

Почему нативной интеграции не существует

В маркетплейсе Kommo нет официального коннектора с DocuSign. Сторонние платформы — Albato, Latenode, viaSocket — предлагают базовую автоматизацию, но с серьёзными ограничениями:

• ✅ Отправка envelope из Kommo по базовому триггеру
• ✅ Базовое отслеживание статуса envelope
• ❌ Нет передачи данных из полей сделки в поля шаблона DocuSign — реквизиты нужно заполнять вручную
• ❌ Нет автоматического перехода сделки на следующий этап при подписании
• ❌ Нет обратной синхронизации: данные из подписанного документа не возвращаются в поля контакта Kommo
• ❌ Условная логика требует написания JavaScript прямо в интерфейсе Latenode
• ❌ Rate limits при объёме более 20–30 документов в день

Что решает кастомная интеграция от Exceltic.dev

• Автоматическая отправка на подпись — при переходе сделки на этап «Отправить договор» DocuSign envelope создаётся и отправляется автоматически без участия менеджера
• Prefill из полей сделки — реквизиты клиента, сумма договора, сроки, адрес, ИНН — все данные из полей сделки Kommo подставляются в соответствующие поля шаблона DocuSign через Tabs API
• Автоматический переход этапа — при получении события envelope-completed сделка в Kommo автоматически переходит на этап «Договор подписан»
• Обратная синхронизация данных — поля, заполненные подписантом в документе (например, банковские реквизиты или дата начала работ), передаются обратно в кастомные поля карточки Kommo
• Несколько подписантов — интеграция поддерживает routing order: сначала клиент, затем руководитель компании, затем юрист — каждый получает уведомление в нужный момент
• Разные шаблоны для разных воронок — воронка «Новые клиенты» использует один шаблон договора, воронка «Продление» — другой
• Ссылка на документ в карточке — после создания envelope его прямая ссылка записывается в кастомное поле сделки Kommo
• Напоминания по таймеру — если документ не подписан в течение 48 часов, в Kommo автоматически создаётся задача на менеджера

Как работает интеграция — технический процесс

Архитектура подключения

Интеграция построена на связке Kommo Webhooks → middleware Exceltic → DocuSign eSign API. Аутентификация с DocuSign реализована через JWT Grant (Server-to-Server OAuth) — это наиболее надёжный метод для серверных интеграций без участия пользователя. Обратная синхронизация работает через DocuSign Connect Webhooks, которые отправляют уведомления при каждом изменении статуса envelope: envelope-sent, envelope-delivered, envelope-completed, envelope-declined, envelope-voided.

Данные из подписанного документа извлекаются через DocuSign Tabs API — каждое поле шаблона имеет уникальный tabLabel, который маппируется на соответствующее поле сделки Kommo в конфигурационной таблице.

Пошаговый сценарий работы

1. Менеджер переводит сделку на этап «Отправить договор» в Kommo
2. Kommo отправляет webhook с ID сделки на endpoint middleware
3. Middleware запрашивает данные сделки GET /api/v4/leads/{id} и контакта GET /api/v4/contacts/{id}
4. Определяется нужный шаблон DocuSign по типу воронки из конфигурации
5. Формируется объект EnvelopeDefinition с templateId, массивом recipients и prefillTabs — полями из данных сделки
6. Envelope создаётся и отправляется: POST /v2.1/accounts/{accountId}/envelopes
7. DocuSign возвращает envelopeId — middleware записывает его и ссылку в кастомные поля сделки Kommo
8. При подписании всеми сторонами DocuSign Connect отправляет событие envelope-completed
9. Middleware запрашивает данные заполненных полей: GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/tabs
10. Данные из табов документа записываются в кастомные поля контакта Kommo
11. Сделка переводится на этап «Договор подписан»: PATCH /api/v4/leads/{id}

Сценарий: документ не подписан вовремя

1. При создании envelope middleware запускает отложенный таймер на 48 часов
2. Если за это время событие envelope-completed не получено — в Kommo создаётся задача на менеджера: «Договор не подписан — напомните клиенту»
3. Менеджер может отправить повторное напоминание прямо из Kommo через Salesbot — это триггерирует POST /v2.1/accounts/{accountId}/envelopes/{envelopeId}/resend в DocuSign

Что происходит при ошибке

DocuSign API возвращает детализированные коды ошибок. Middleware обрабатывает наиболее частые сценарии: INVALID_EMAIL_ADDRESS — задача на менеджера с просьбой проверить email подписанта; TEMPLATE_ID_NOT_FOUND — уведомление администратора интеграции; ACCOUNT_LACKS_PERMISSIONS — немедленное уведомление с описанием проблемы тарифного плана.

Реальный кейс

Рекрутинговое агентство, 6 менеджеров, ~80 сделок в месяц, клиенты в EU.

Агентство работало с двумя типами договоров: договор на подбор персонала (с клиентом) и оферта кандидату. Оба документа отправлялись вручную: менеджер создавал envelope в DocuSign, копировал реквизиты из Kommo, ждал подписи и вручную обновлял статус сделки. На каждый комплект документов уходило 15–20 минут.

Отдельной проблемой было отслеживание: при 80 сделках в месяц менеджеры регулярно забывали проследить за неподписанными документами. В среднем 8–10 сделок в месяц зависали на этапе «Ожидание подписи» дольше недели без напоминания.

После запуска интеграции документы уходят на подпись автоматически при смене этапа. Реквизиты подставляются из Kommo без ручного ввода. Незакрытые envelope через 48 часов автоматически создают задачу на менеджера. За первый месяц среднее время от отправки договора до подписания сократилось с 4,2 до 1,8 дня.

Результат: 20 часов в месяц возвращено команде, 0 забытых неподписанных договоров, цикл подписания сократился вдвое.

Для каких бизнесов подходит

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

Особенно ценна для компаний с несколькими типами договоров и несколькими подписантами — маршрутизация по routing order и выбор шаблона по типу воронки исключают путаницу при работе с большим объёмом документов.

Часто задаваемые вопросы

Можно ли настроить интеграцию Kommo и DocuSign через Albato или Latenode?
Для простого сценария «отправить envelope при смене этапа» — можно. Но как только нужны prefill полей из сделки, обратная синхронизация данных из документа, routing order для нескольких подписантов или автоматические напоминания — эти платформы требуют JavaScript и быстро упираются в технические ограничения. Кастомная интеграция через DocuSign eSign API закрывает все эти сценарии.

Можно ли использовать разные шаблоны DocuSign для разных воронок Kommo?
Да. Middleware хранит конфигурационную таблицу маппинга: воронка Kommo → шаблон DocuSign. Смена шаблона для любой воронки выполняется через конфигурацию без изменения кода.

Что происходит если клиент отказывается подписывать документ?
При событии envelope-declined middleware обновляет поле сделки Kommo и создаёт задачу на менеджера с причиной отказа, которую указал подписант в DocuSign. Менеджер может скорректировать условия и запустить новый envelope.

Поддерживает ли интеграция несколько подписантов?
Да. Routing order настраивается в конфигурации: например, сначала клиент, затем директор компании. Каждый подписант получает уведомление только после того, как предыдущий завершил подписание.

Сколько времени занимает разработка интеграции Kommo и DocuSign?
Базовая интеграция с prefill, автоматическим переходом этапа и напоминаниями — 4–6 рабочих дней. Версия с несколькими шаблонами, routing order и обратной синхронизацией данных — 8–10 рабочих дней. Exceltic.dev определяет точные сроки после технического брифа.

Если вы хотите автоматизировать отправку договоров DocuSign из воронки Kommo — опишите задачу команде Exceltic.dev. Разберём сценарий и предложим архитектуру под ваш документооборот.