Как подключить ИИ-сотрудника VibeLab к Битрикс24 за вечер: вебхук и права

Шаг 1. Проверьте подписку на портале

Для REST API и входящих вебхуков в облаке зоны ru Битрикс24 требует подписку «BitrixGPT + Маркетплейс» (справка helpdesk.bitrix24.ru/open/27018478/ от 09.11.2026). Без неё вебхук не заработает, обойти это нельзя, и мы не предлагаем.

Цены на 11.11.2026 по данным страницы Маркета (проверяйте на bitrix24.ru/apps/market/, цены в месяц без НДС на весь портал): Базовый до 5 пользователей 1 000 ₽, со скидкой 500 ₽; Стандартный до 50 пользователей 3 000 / 1 500 ₽; Профессиональный до 100 пользователей 6 000 / 3 000 ₽; для Энтерпрайза от 250 пользователей по акции от 6 800 ₽. Скидка 50% действует при заказе до 31.12.2026. Если подписка уже есть, переходите к шагу 2. Разбор цен отдельно: сколько стоит ИИ в Битрикс24.

Шаг 2. Заведите пользователя для ИИ

Лучше не вешать вебхук на личный аккаунт собственника. Создайте отдельного сотрудника, например «ИИ-сотрудник», и дайте ему доступ к CRM и задачам в нужных вам разделах. Запросы по вебхуку выполняются от имени пользователя, который его создал, так что его права и есть границы доступа. Подробнее о безопасности: права, подтверждение и prompt injection.

Шаг 3. Создайте входящий вебхук

Войдите в портал под этим пользователем. По справочнику apidocs.bitrix24.ru (проверено 11.11.2026) путь такой: раздел «Разработчикам», вкладка «Готовые сценарии» → «Другое» → «Входящий вебхук». В генераторе запросов можно выбрать метод и нажать «Выполнить», чтобы проверить тестовый вызов. Затем укажите права доступа и нажмите «Создать». Если пункта нет, создание вебхуков для этого сотрудника закрыто: попросите администратора открыть его. Интерфейс портала меняется, поэтому при расхождении сверяйтесь со справочником.

Права доступа (скоупы) для типовых задач ИИ-сотрудника, названия по списку скоупов Битрикс24:

• CRM (crm): лиды, сделки, контакты, компании, дела, стадии;
• Задачи (task);
• Пользователи (user или базовый вариант user_basic) и Структура компании (department): чтобы видеть ответственных и отделы;
• Телефония (telephony), если нужна статистика звонков; пользователю вебхука в этом случае нужно право «Статистика звонков — Просмотр»;
• Учёт рабочего времени (timeman), если он ведётся и нужен в отчётах.

Учтите, что скоуп CRM не делит методы на чтение и запись. Если хотите ограничить запись ещё и на стороне портала, дайте пользователю в ролях CRM только чтение. Не отмечайте «всё». Лишние разрешения вы всегда успеете добавить, убрать их после инцидента сложнее. Сохраните вебхук. Получится адрес вида https://<портал>.bitrix24.ru/rest/<id>/<код>/, где id — номер пользователя, создавшего вебхук. Код в нём работает как пароль: не публикуйте его в чатах и тикетах. Если позже захотите поменять права, правьте вебхук под тем же пользователем: по справочнику, когда администратор редактирует чужой вебхук, код обновляется, а владельцем становится администратор.

Шаг 4. Подключите портал в VibeLab

В VibeLab откройте подключения, выберите Битрикс24 и вставьте адрес вебхука. Какие системы подключаются, смотрите на странице подключений.

Шаг 5. Оставьте право «Читать», запись выключите

У подключения есть отдельные переключатели «Читать» и «Писать» для каждого ИИ-сотрудника. Без явного разрешения инструмент отказывает. Для первой недели включите только «Читать». Сотрудник сможет читать лиды, сделки, контакты, компании, дела и комментарии таймлайна, стадии и воронки, историю смены стадий, задачи и их историю, пользователей и структуру, статистику звонков, учёт рабочего времени, искать дубли по телефону и почте и смотреть поля сущностей. Изменять карточки он не сможет.

Запись («Писать») добавите позже. Её набор: создать сделку, обновить сделку или лид, перенести сделку по стадии, добавить заметку, создать задачу, прикрепить файл. Даже тогда рекомендуем режим «С согласованием»: действие выполняется после подтверждения человеком.

Шаг 6. Поставьте первую задачу

Формулируйте как коллеге, с условиями и форматом отчёта. Пример: «Каждое утро в 8:30 присылай в Telegram список сделок без активности больше пяти дней: название, сумма, ответственный, дней без касаний. Сверху суммарная сумма под риском». Работа идёт по расписанию и по запросу, мгновенной реакции на событие в портале мы не обещаем.

Шаг 7. Сравните с ручным результатом

Это главный шаг. До запуска запишите контрольные числа: сколько минут в неделю уходит на задачу, сколько сделок вы нашли руками. Через неделю возьмите тот же срез и сделайте руками. Сравните:

Проверка	Что смотрим
Полнота	Что нашли вы и не нашёл сотрудник, и наоборот
Точность	Верны ли суммы, даты, ответственные
Время	Сколько минут ушло у вас, сколько у сотрудника
Понятность	Можно ли с отчётом действовать без доп. вопросов

Условный пример: вы нашли руками 12 сделок за 40 минут, сотрудник прислал 15, три из них вы проверили и признали верными. Это условные данные, у вас будут свои. Итог считайте цифрами, не впечатлением. Если расхождения есть, уточните формулировку и повторите.

Если что-то не работает

Отказ при проверке подключения чаще всего значит одно из трёх: нет активной подписки, у вебхука не те разрешения, либо у пользователя нет прав на раздел. Проверьте в таком порядке. Если не читается статистика звонков, проверьте право «Статистика звонков — Просмотр» у пользователя вебхука. Лимиты запросов в облаке по справочнику: на большинстве тарифов блокировка наступает после 50 запросов подряд, а счётчик снижается на 2 в секунду, у Энтерпрайза 250 и 5; при превышении возвращается ошибка 503 QUERY_LIMIT_EXCEEDED. Для отчёта по расписанию этого обычно достаточно.

Что делать в первые две недели

Первые три дня смотрите каждый отчёт и сверяйте с тем, что знаете сами. На второй неделе переходите на выборочную проверку: раз в два дня берите несколько позиций и проверяйте их в карточках. Фиксируйте найденные расхождения: каждое улучшает формулировку задачи. Когда отчёты стабильно сходятся, добавляйте вторую задачу или источник данных. Право «Писать» включайте последним и только для конкретного действия.

Сколько это занимает

Если подписка уже оформлена, а права администратора у вас есть, шаги со второго по пятый занимают около часа. Больше времени уйдёт на формулировку первой задачи и на сравнение с ручным результатом, зато именно они дают ответ на главный вопрос: нужен ли вам такой сотрудник. Подключение можно отозвать в любой момент: удалите вебхук в Битрикс24, и доступ прекратится. Ничего устанавливать внутрь портала не нужно.

Как начать в VibeLab

Откройте подключение Битрикс24, пройдите шаги выше и поставьте одну задачу. Первый месяц бесплатно, карта не нужна. Если в задаче участвует 1С, посмотрите страницу про 1С, а если хотите проверять звонки, то разбор звонков: расшифровку и оценку по скрипту мы показываем как сценарий, который проверяется на вашем пилоте. Что делать дальше, подскажут статьи про утреннюю сводку для РОПа и API и вебхук Битрикс24.