Зачем читать
Если ты слышал слова "вебхук", "API", "OAuth", "MCP", "VibeCode", "робот" - но не понимал что это всё, кто из них кому родственник и когда что использовать - статья для тебя. Объясним без кода, через простую метафору гостиницы. После неё ты сможешь поговорить с интегратором про автоматизацию своего Битрикс24 на одном языке.
Метафора: Битрикс24 - это большая гостиница
Представь, что твой портал Битрикс24 - это гостиница. В номерах живут "гости": Лиды, Компании, Сделки, Контакты, Задачи, Документы. У каждого гостя есть досье на ресепшене - какие у него телефоны, какая стадия переговоров, какие даты.
Когда к гостинице нужно подключить что-то снаружи (сайт, мессенджер, бухгалтерскую программу, обогащение данных, AI-помощника) - внешний помощник должен подойти к ресепшену и попросить. Поговорить с гостями напрямую нельзя - только через ресепшен.
Главная мысль: способы не выстраиваются в один список
Когда говорят "у Битрикс24 есть вебхук, OAuth, VibeCode, MCP, роботы…" - это смешивает 3 разных вопроса в одну кучу. На самом деле каждое подключение к Битрикс24 описывается по 3 осям одновременно:
- •Ось 1 - Кем помощник представляется на ресепшене (аутентификация)
- •Ось 2 - В какой форме приносит просьбу (тип запроса)
- •Ось 3 - Есть ли у него консультант-посредник (инструмент-обёртка)
Любое подключение - это точка в трёхмерной сетке. Например: "OAuth-приложение + большой документ во вложении + установка бизнес-процесса". Или другая точка: "Вебхук + одиночный вопрос + чистый REST без посредников".
Поэтому интегратору важно понимать каждую ось отдельно, а не путать их.
Плюс есть бонусная группа - внутренние сотрудники гостиницы (бизнес-процессы, роботы, триггеры), которые не нужны внешнему помощнику для подключения, но влияют на то, как гостиница реагирует на изменения внутри.
Разберём по очереди.
Ось 1 - Кем помощник представляется на ресепшене
Входящий вебхук (webhook) - это обычный телефонный звонок. Помощник звонит на ресепшен по специальному номеру с кодом. Простой, но звонок привязан к конкретному сотруднику гостиницы (от его имени звонят) и есть список того, о чём можно спрашивать. Подходит для простых задач: "добавь Лида", "прочитай его данные".
Исходящий вебхук - это обратная ситуация: гостиница сама звонит помощнику, когда что-то произошло. Например, "в гостиницу заехал новый Лид - позвони веб-сайту, чтобы он зафиксировал заявку".
OAuth-приложение (читается "оАут") - это именное приложение с паспортом и пропуском. Гостиница выдаёт помощнику бейдж со списком полномочий - что он имеет право спрашивать и делать. Бейдж периодически обновляется. Подходит для серьёзных задач: запуск бизнес-процессов, массовые изменения, установка приложений из Маркета.
Бывает двух подтипов:
- •локальное OAuth-приложение - только для одного клиента, ставится вручную интегратором
- •из Маркета - доступно всем клиентам Битрикс24 через Маркетплейс, как мобильные приложения в App Store
JS из placement (читается "джиэс из плэйсмента") - это когда помощник уже внутри гостиницы, как мини-приложение, встроенное в карточку Лида. Авторизация идёт автоматически - он часть гостиницы. Так работают, например, кастомные кнопки в карточках.
Когда какой способ
| Способ | Когда подходит |
|---|---|
| Входящий вебхук | Простые задачи: чтение, простая запись, разовые скрипты |
| Исходящий вебхук | Реагировать на события Битрикс24 в своей системе |
| Локальное OAuth | Серьёзные задачи под одного клиента: бизнес-процессы, массовые операции, аудит |
| Маркетплейс-приложение | Готовое решение для всех клиентов сразу |
| JS из placement | Встроенные мини-приложения в карточках |
Ось 2 - В какой форме помощник приносит просьбу
Одиночный запрос - самая простая форма. Помощник спрашивает одну вещь за раз. "Добавь Лида Иванов с телефоном таким-то". Один вопрос - один ответ. Подходит для маленьких задач.
Список (batch-запрос) - помощник приносит пакет из 50 поручений одной упаковкой. "Прочитай первых 50 Лидов, потом найди их Компании, потом обнови у каждого ИНН". Гостиница выполняет всё одним заходом - экономия времени. Подходит для массовых операций.
Большой документ во вложении (JSON + base64) - когда у поручения большой файл, например, схема бизнес-процесса на 100 шагов. Помощник упаковывает её в специальный конверт (JSON-body + кодировка base64) и кладёт в запрос. Так передаются шаблоны бизнес-процессов через метод template.add.
Подписка на события - помощник говорит: "Когда у вас заедет новый Лид - пришли мне сообщение по этому адресу". Гостиница сама уведомляет помощника при наступлении события. Подходит для интеграций "реагируй на происходящее".
Когда какой способ
| Форма запроса | Когда подходит |
|---|---|
| Одиночный | 1-2 действия, не критично к скорости |
| Список (batch) | Массовая обработка десятков-сотен записей |
| Большой документ во вложении | Установка/обновление бизнес-процессов, передача схем |
| Подписка на события | Постоянный мониторинг изменений в Битрикс24 |
Ось 3 - Есть ли у помощника консультант-посредник
Это инструменты-надстройки, через которые работают современные помощники, особенно AI-помощники. Они не заменяют оси 1 и 2 (всё равно нужна аутентификация и форма запроса), а облегчают жизнь помощнику.
VibeCode - это новый AI-консьерж от самого Битрикс24. Встроен в платформу. Позволяет AI-помощникам выполнять задачи на портале через специальный интерфейс. Сейчас на стадии активного развития.
MCP-сервер (читается "эм-си-пи", от Model Context Protocol) - это переговорный зал, куда AI-помощники приходят с заранее подготовленными инструкциями. MCP помогает AI не путаться в сотнях возможностей Битрикс24, а сразу видеть нужный набор действий. Бывает двух видов:
- •MCP на стороне портала - стоит прямо на гостинице, AI получает доступ ко всем номерам через единый интерфейс
- •MCP-справочник - отдельный сервер, который объясняет AI "как устроена документация Битрикс24" (не сам делает действия, а помогает разобраться)
Приложения из Маркета (Marketplace) - это арендованные сервисы, как химчистка или доставка еды у отеля. Уже готовые внешние сервисы, которые умеют что-то конкретное:
- •DataNewton, Krinfo - обогащают данные о компаниях по ИНН (берут из открытых реестров)
- •IT-Solution - обёртки для типовых задач, которые сложно делать руками
- •SiMiX - поиск компаний
Без посредника - тоже валидная опция. Помощник может работать напрямую через ось 1 + 2, без всяких консультантов. Большинство простых интеграций работают так.
Когда какой способ
| Посредник | Когда подходит |
|---|---|
| Без посредника | Простые интеграции по чистому REST |
| VibeCode | Нативная AI-автоматизация на портале |
| MCP на стороне портала | AI-помощник работает с порталом клиента (на стадии исследования) |
| MCP-справочник | AI нужно понять документацию Битрикс24, прежде чем действовать |
| Приложение из Маркета | Готовое решение для типовой задачи (обогащение, поиск, отчёты) |
Бонус - Внутренние сотрудники гостиницы
Это не способ доступа к API, а способ исполнения действий внутри самой гостиницы. Внешнему помощнику они не нужны для подключения, но очень важны для автоматизации: иногда проще поручить дело внутреннему сотруднику, чем дёргать гостиницу извне.
Бизнес-процесс (БП) - это подробный сценарий действий, как должна работать гостиница в определённой ситуации. Например, "когда заехал новый Лид с ИНН - проверь его в реестре, найди отрасль, поставь стадию, отправь email менеджеру". БП - это последовательность шагов. Запускается автоматически (по событию) или вручную.
Робот автоматизации - это сотрудник на конкретном этаже воронки продаж. Когда Лид переходит на стадию "Дорого!", робот автоматически проставляет "Причина отказа = Дорого". Роботы - простая форма автоматизации, настраиваются в визуальном конструкторе через UI Битрикс24.
Триггер - это сигнализация на событие. Когда что-то происходит снаружи (форма с сайта заполнена, входящий звонок, открытое сообщение в чате) - триггер ловит сигнал и запускает реакцию (например, создание Лида или запуск бизнес-процесса).
PHP-код в бизнес-процессе (CodeActivity) - это возможность написать кусочек программного кода прямо в шаге БП. Полезно, когда штатных шагов не хватает. Работает только на "коробке" (когда Битрикс24 установлен у тебя на сервере), на "облаке" отключено по безопасности.
Когда внутренние сотрудники предпочтительнее внешнего помощника
| Задача | Решение |
|---|---|
| Автозаполнение поля на стадии воронки | Робот автоматизации (внутри Битрикс24) |
| Сложная логика "если-то-иначе" с проверками | Бизнес-процесс |
| Реакция на форму с сайта | Триггер + бизнес-процесс |
| Расчёт чего-то нестандартного внутри БП | PHP-код в шаге (только на коробке) |
Как складываются 3 оси - примеры из жизни
Давай покажем как реальные задачи раскладываются по трём осям сразу. Каждая задача - это одна точка в трёхмерной матрице.
Пример 1: Простая интеграция с сайтом
"Когда на сайте заполнили форму - создать Лида в Битрикс24".
- •Ось 1: входящий вебхук (сайт звонит на ресепшен с готовым кодом)
- •Ось 2: одиночный запрос (одна форма - один Лид)
- •Ось 3: без посредника (чистый REST)
Пример 2: Развёртывание бизнес-процессов под клиента
"Поставить клиенту 4 бизнес-процесса с автозапуском".
- •Ось 1: OAuth-приложение (вебхук не имеет прав на установку БП)
- •Ось 2: большой документ во вложении (схема БП передаётся как JSON-файл с кодировкой base64)
- •Ось 3: без посредника (прямое подключение к Битрикс24)
Пример 3: Обогащение данных по ИНН
"У каждой новой Компании подтянуть её данные из реестра ФНС".
- •Ось 1 + 2: встроены в приложение DataNewton (клиент не думает, как технически это устроено)
- •Ось 3: приложение из Маркета (готовый сервис, подключается за пару кликов)
Пример 4: Массовое обновление 5000 Лидов
"У всех Лидов в стадии "В работе" переписать поле "Менеджер"".
- •Ось 1: OAuth-приложение (потому что массовая запись)
- •Ось 2: список из 50 поручений за раз (batch-запрос) - обработаем 5000 Лидов за 100 запросов вместо 5000
- •Ось 3: без посредника
Пример 5: AI-помощник на портале клиента
"Подключить AI, который помогает менеджеру отвечать на вопросы по карточке Лида".
- •Ось 1: OAuth-приложение (для AI нужны широкие права)
- •Ось 2: одиночные запросы (на каждый вопрос AI один запрос к Битрикс24)
- •Ось 3: MCP-сервер (чтобы AI понимал, какие действия доступны)
Короткий компас по задачам
Если упростить до одной таблицы:
| Задача | Ось 1 | Ось 2 | Ось 3 |
|---|---|---|---|
| Простая запись с сайта | Вебхук | Одиночный | Нет |
| Массовая обработка | Вебхук или OAuth | Список (batch) | Нет |
| Установка бизнес-процессов | OAuth | Документ во вложении | Нет |
| Обогащение по ИНН | Внутри приложения | Внутри приложения | Маркетплейс |
| AI-помощник | OAuth | Одиночный | MCP |
| Реакция на изменение в Битрикс24 | Подписка на события + исходящий вебхук | Уведомления | Нет |
| Автозаполнение поля на стадии | Не нужно (внутри Битрикс24) | - | Робот / Бизнес-процесс |
Что важно понять
Эти способы - не альтернативы, а дополнения. В одном проекте обычно используется сразу несколько:
- •вебхук для простых задач +
- •OAuth для бизнес-процессов +
- •Маркет-приложение для обогащения +
- •роботы для рутины +
- •MCP для AI-помощника
Когда интегратор пишет в плане работ "разворачиваем 4 БП через OAuth + ставим DataNewton из Маркета + настраиваем 5 роботов на стадиях" - теперь ты понимаешь, что:
- •"через OAuth" = по оси 1 это OAuth-приложение
- •"4 БП" = по оси 2 это документы во вложении (JSON+base64)
- •"DataNewton из Маркета" = по оси 3 это посредник из Маркета
- •"5 роботов" = внутренние сотрудники гостиницы
И если кто-то скажет "а почему нельзя всё через вебхук?" - теперь знаешь почему. Вебхук - это "обычный телефонный звонок", он не может запустить бизнес-процесс или скачать большой документ. Для серьёзных задач нужен "именной пропуск" (OAuth), для типовых - арендованный сервис из Маркета, для AI-задач - переговорный зал MCP.
Любая интеграция Битрикс24 - это выбор по 3 осям сразу. Не один список, а 3 параллельных. Если интегратор объясняет иначе - переспроси, на какой оси какой выбор сделан и почему.
Статья подготовлена API-агентом "Системно". Если есть вопросы или примеры из вашего бизнеса - пишите нам!
Связанные материалы: Что такое VibeCode Битрикс24 - подробно о новой платформе разработки Битрикс24 с ИИ.