amoCRM / Kommo — интеграционный ландшафт

report · domain: crm · 2026-06-08 · confidence: high

Построено из глубокого веб-ресерча по официальным докам Kommo: 22 источника → 95 claims → 25 верифицировано adversarial-голосованием (3 независимых рефьютера на claim), 0 убито. Технические claims — из вендорской документации, независимо не аудированы.

amoCRM = Kommo

amoCRM — историческое название (доминирует в РФ/СНГ). Kommo — международный ребренд того же продукта, под которым теперь живёт актуальная дев-документация (developers.kommo.com, прод-хост {subdomain}.kommo.com). Класс продукта — messenger-based / conversational CRM: продажи через входящие чаты, лиды, воронки. Это важно держать в голове при выборе угла интеграции.

Три поверхности интеграции

Главная развилка дизайна: у Kommo не один API, а три механизма — с разными хостами и разной аутентификацией. Их нельзя путать.

1 · REST API v4 + аутентификация

Жёсткие лимиты

• ≤ 7 запросов/сек. Превышение → 429; повторные нарушения → 403 + блокировка IP.
• ≤ 250 сущностей на запрос (чтение и add/update). Рекомендация доки — ≤ 50, иначе ошибки и 504.
• Следствие: массовые операции — батчами ≤50, throttle под 7 rps, retry с бэкоффом на 429.

Два пути аутентификации

JWT access-токен несёт user_id, integration_id, доступные действия и account_id. Refresh ротируется при каждом обновлении и отзывается после 3 месяцев простоя (тогда нужна повторная авторизация).

POST https://{subdomain}.kommo.com/oauth2/access_token
{
  "client_id":     "",
  "client_secret": "",
  "grant_type":    "authorization_code",   // или "refresh_token"
  "code":          "",          // для authorization_code
  "refresh_token": "",            // для refresh_token
  "redirect_uri":  "https://..."
}
# code и refresh_token взаимоисключающие — по grant_type

2 · Digital Pipeline — webhooks и триггеры

Событийный push-слой воронки: вместо опроса API получаешь события сразу. Но набор событий узкий, а доставка self-throttling.

Webhooks

• Настройка: Leads → Automate → API: Send webhook.
• События (только эти): mail_in, call_in, chat, site_visit, смена стадии (status).
• Payload: поля лида — id, pipeline_id, status_id (+ old_* при смене стадии). Формат {"lead":{"event":{...}}}.
• Доставка: до 4 ретраев в течение часа; >100 невалидных ответов за 5 мин → пауза 5 мин → авто-возобновление. Успех = HTTP 100–299, ответ ожидается ~2с.

12 триггеров автоматизации

Send Webhook · Salesbot · Change Lead Stage · Add/Complete Task · Create Lead · Send Email · Add Tags · Generate Form · Change Lead's User · Change Field · Delete Files.

3 · Chats API + Salesbot

Мессенджер-слой. Отдельный хост и другая аутентификация — это главная ловушка: OAuth-токен отсюда не работает.

POST https://amojo.kommo.com/v2/origin/custom/{scope_id}
X-Signature: hash_hmac('sha1', body, channel_secret)
Date: ...
Content-MD5: ...
Content-Type: application/json

Salesbot + widget SDK

Salesbot автоматизирует общение (приветствия, follow-up, nurturing) и расширяется кастомными виджетами. widget_request — главный хук для внешней логики (генерация контента, маршрутизация, вызов LLM).

• Виджет: манифест "locations": ["salesbot_designer"]; состав manifest.json + script.js + стилизация.
• Колбэк onSalesbotDesignerSave (вход handler_code, params) возвращает JSON-код для бота с учётом exit-кодов.

Цены и тарифы

Гэп: VK/Telegram и постинг контента

Решения для разработчика

Caveats и открытые вопросы

• Все технические claims — из вендорских доков, независимо не аудированы; точное окно rate-limit/burst валидировать эмпирически.
• Цены time-sensitive; названия тарифов недавно реорганизованы.
• Конкурентный угол (Bitrix24 / HubSpot) дал 0 выживших claims — сравнение требует отдельного прохода.
• Не покрыто: официальные SDK-библиотеки, полный список scopes, пер-тарифные гейты фич (Salesbot/воронки/кастом-поля), нативные VK/TG-коннекторы.