Какие бывают способы подключить Битрикс24 к ИИ
Способов три, и у каждого свои условия. Латиницей запрос пишут Bitrix24 MCP: речь о тех же вариантах.
| Способ | Как работает | Что нужно | Что с Allokai |
|---|---|---|---|
| Встроенный MCP-сервер Битрикс24 | Внешняя AI-система работает с порталом: задачи, CRM, структура, приглашения, почта | Администратор включает опцию в «Настройки > MCP»; OAuth или токен; в зоне ru подписка «BitrixGPT + Маркетплейс» | Авторизацию и работу мы не проверяли |
| Входящий вебхук REST | Агент вызывает методы REST по секретному адресу | Вебхук с правами; портал открыт из интернета по HTTPS | Подключение агент пишет под задачу |
| MCP-сервер, который пишет агент | Агент оборачивает вызовы REST в инструменты и запускает сервер в облаке | То же, что для вебхука | Готового коннектора нет |
Сведения о встроенном сервере взяты из справки Битрикс24 на 9 октября 2026. В справке описаны облачные тарифы; про коробочную версию там ничего не сказано.
Есть и четвёртый сервер, который не нужно путать с этими: MCP из документации для разработчиков (apidocs.bitrix24.ru). Он отдаёт ИИ описания методов REST и примеры кода, данных портала не читает и методы не вызывает.
Что можно делать в Битрикс24 через ИИ-агента
Агент читает сделки, лиды и задачи и собирает из них ответ в чате: таблицу, сводку или файл. Для начала подходят вопросы на чтение.
- сделки по стадиям воронки и по ответственным;
- лиды за период;
- задачи сотрудника с просроченным сроком;
- отчёт по воронке по расписанию: приложение ходит в Битрикс24 само и присылает сводку, как в разделе про автоматизацию отчётов.
По документации, списки сделок, лидов и задач методы REST отдают страницами по 50 записей, а общее число найденных записей приходит в поле total. Агент идёт по страницам сам. Методы crm.deal.list и crm.lead.list в документации помечены устаревшими, рекомендован crm.item.list: попросите агента назвать метод, которым он читал.
Как подключить Битрикс24 через входящий вебхук
Входящий вебхук вызывает методы REST по секретному адресу и работает от имени сотрудника, который его создал. По документации Битрикс24, путь такой: «Приложения > Разработчикам > Готовые сценарии > Другое > Входящий вебхук».
- Создайте вебхук и отметьте права (scope), например
crmиtask. Если нужного пункта нет, право создавать вебхуки закрыто: его включает администратор в «Настройки > Настройки Битрикс24 > Безопасность > Интеграции Битрикс24». - Заведите вебхук под сотрудником, у которого в CRM есть только право на чтение нужных сущностей. Это наш совет, он следует из документации: права вебхука определяются выбранными scope и правами создателя.
- Адрес вебхука содержит секретный код, это ключ к порталу. Введите его в защищённую форму Allokai: значение хранится в сейфе в зашифрованном виде. В чат его не пишите.
- Опишите задачу: «Покажи сделки по стадиям». Агент пишет подключение, делает пробный запрос и показывает ответ.
Мы не проверяли подключение к конкретному порталу, поэтому первый запрос агент выполняет при вас. Сверьте результат с самим Битрикс24.
Облако и «коробка»: что нужно для подключения
Агент работает в облаке и обращается к порталу по его адресу, поэтому портал должен быть доступен из интернета по HTTPS. Облачный Битрикс24 это условие выполняет. Для «коробки» нужен внешний адрес и открытый доступ к REST: портал только во внутренней сети агент не достанет, и открывать ли его наружу, решает ваш администратор.
Лимиты тоже зависят от версии. По документации на 9 октября 2026, в облаке запрос REST должен уложиться в 60 секунд, а счётчик запросов растёт с каждым вызовом и убывает на 2 в секунду; выше порога в 50 Битрикс24 отвечает ошибкой QUERY_LIMIT_EXCEEDED. На тарифе «Энтерпрайз» убыль 5 в секунду, порог 250. В «коробке» нагрузку настраивает администратор сервера.
Что агент пишет сам и как проверить результат
Агент пишет подключение к REST, разбирает ответы и, если нужно, оформляет их как инструменты MCP-сервера: «сделки по стадиям», «задачи сотрудника». Сервер запускается в облаке, а внешняя программа вызывает его по ключу доступа, который создаёт агент; ключ можно отозвать. Что такое протокол, объяснено на странице что такое MCP, а как агент создаёт сервер в чате — в статье про создание MCP-сервера.
Проверяйте так:
- сравните число сделок на стадии с воронкой в самом Битрикс24;
- попросите агента назвать метод и фильтр, которыми он читал;
- просите ссылку на сделку или задачу в каждой строке итога.
Права вебхука и безопасность
Секретный адрес вебхука открывает данные в пределах его прав, поэтому с ним обращаются как с паролем. Документация Битрикс24 советует не передавать адрес посторонним и для рабочих интеграций пользоваться запросами POST: в адресе запроса GET секрет может остаться в истории браузера и логах. Попросите агента работать через POST. Срок действия вебхука можно ограничить.
Права на сущности CRM в Битрикс24 задаёт ролевая модель: чтение, добавление, изменение, удаление. По справке, модель доступна не на всех тарифах. Если администратор правит чужой вебхук, секретный код меняется, а владельцем вебхука становится администратор: после правки проверьте права.
Ответы Битрикс24 видит модель, иначе она не смогла бы ответить. Если часть данных агенту показывать не нужно, закройте её правами сотрудника вебхука.
Чего здесь нет и когда лучше другой инструмент
- Агент не встраивается в Битрикс24: нет виджета в карточке сделки и приложения в маркетплейсе Битрикс24. Он работает снаружи, в чате Allokai.
- Агент не заменяет встроенные ассистенты Битрикс24. Если ассистент нужен прямо в портале, смотрите BitrixGPT.
- «Коробка» без внешнего адреса не подключается.
- Готового коннектора к Битрикс24 нет: подключение пишется под вашу задачу.
- Запись в CRM без вашего контроля мы не обещаем. Перед необратимым действием агент останавливается и называет, что будет потеряно.
- Что в продажах остаётся менеджеру, разобрано на странице про ИИ-агента для продаж.