Битрикс24

Битрикс24 — корпоративный портал с CRM, задачами, чатами и почтой. Встроенный ИИ-помощник CoPilot работает во всех этих разделах, и список его моделей открыт: кроме BitrixGPT туда можно подключить свой движок.

Hubris подключается именно так — как собственный движок CoPilot. Регистрация делается вебхуком портала: приложение писать не нужно, модерация не требуется, права администратора достаточно.

Требования

• Битрикс24 с доступом к REST — это подписка «Маркетплейс» (в облаке) либо пробный режим. На бесплатном тарифе вебхуки и приложения недоступны, и движок подключить не получится.
• Права администратора портала: регистрация движка требует доступа ai_admin.
• Аккаунт на hubris.pw и API-ключ.

Шаг 1. Создайте коннектор в Hubris

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

curl -X POST https://api.hubris.pw/v1/integrations/bitrix24/connectors \
  -H "Authorization: Bearer $HUBRIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Отдел продаж",
    "model": "anthropic/claude-sonnet-5"
  }'

В ответе придёт адрес:

{
  "id": "…",
  "completions_url": "https://api.hubris.pw/integrations/bitrix24/completions/…",
  "model": "anthropic/claude-sonnet-5",
  "key_prefix": "sk-gw-a1b2…c3d4"
}

Под коннектор выпускается отдельный ключ с именем «Битрикс24 · Отдел продаж» — он виден в разделе «Ключи». Расход по нему считается отдельно, на него можно поставить свой лимит, а отзыв ключа мгновенно выключает коннектор.

Модель выбирается здесь и менять её в Битрикс24 нельзя: для портала движок — это одна модель. Нужны две разные — создайте два коннектора. Необязательное поле limit_kopecks задаёт дневной лимит выпущенного ключа: "limit_kopecks": 50000 — это 500 ₽ в сутки.

Шаг 2. Создайте вебхук в Битрикс24

1. В портале откройте Приложения → Разработчикам → Другое → Входящий вебхук.
2. В списке прав отметьте ИИ (ai_admin).
3. Сохраните. Портал покажет адрес вида https://ваш-портал.bitrix24.ru/rest/1/abcdef123456/.

Шаг 3. Зарегистрируйте движок

Выполните запрос к своему вебхуку, подставив его адрес и completions_url из первого шага:

curl -X POST "https://ваш-портал.bitrix24.ru/rest/1/abcdef123456/ai.engine.register" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hubris",
    "code": "hubris",
    "category": "text",
    "completions_url": "https://api.hubris.pw/integrations/bitrix24/completions/ВАШ_ТОКЕН",
    "settings": { "model_context_type": "token", "model_context_limit": 200000 }
  }'

В ответе придёт числовой идентификатор движка — значит, он зарегистрирован. Проверить список можно методом ai.engine.list, удалить — ai.engine.unregister.

Поле model_context_limit — это размер контекста выбранной модели в токенах, его видно в карточке модели в каталоге.

Шаг 4. Выберите Hubris в CoPilot

В портале откройте Настройки → Настройки BitrixGPT и выберите Hubris как модель для нужных сценариев. После этого помощник в письмах, задачах, чатах и CRM будет отвечать через ваш коннектор.

Запросы появятся в расходах и логах с пометкой канала Bitrix24.

Как это работает

Битрикс24 не ждёт ответ модели в том же запросе: он присылает вопрос вместе с адресом для ответа и требует подтверждения за 5 секунд. Hubris сразу отвечает «принято», спрашивает модель и присылает готовый текст на адрес обратного вызова портала. Поэтому в интерфейсе ответ появляется с обычной задержкой модели, а не мгновенно.

История переписки приходит от портала вместе с новым вопросом и передаётся модели целиком — контекст диалога сохраняется.

Управление коннекторами

Список:

curl https://api.hubris.pw/v1/integrations/bitrix24/connectors \
  -H "Authorization: Bearer $HUBRIS_API_KEY"

Удаление (вместе с выпущенным ключом):

curl -X DELETE https://api.hubris.pw/v1/integrations/bitrix24/connectors/ИДЕНТИФИКАТОР \
  -H "Authorization: Bearer $HUBRIS_API_KEY"

После удаления коннектора уберите движок и в портале — ai.engine.unregister, иначе CoPilot продолжит слать запросы на несуществующий адрес.

Выбор моделей

ID берите из каталога — они пишутся полностью, вместе с вендором, в точности как в каталоге.

Решение проблем

CoPilot отвечает «сервис недоступен»

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

Ответ не приходит совсем

Проверьте расходы: если запрос там есть, модель ответила и дело в доставке — портал мог закрыть окно ожидания. Если запроса нет, до Hubris он не дошёл: перепроверьте completions_url в ai.engine.list.

Движок не появился в списке моделей

Убедитесь, что вебхук создан с правом ai_admin и что регистрацию выполнял администратор портала. На тарифах без доступа к REST метод вернёт ошибку прав.

Ошибка про недостаточный баланс

Пополните баланс в кабинете — от 500 ₽, через СБП, банковской картой или по счёту для юридических лиц.

Что дальше

• Каталог моделей — ID и размер контекста для настроек движка.
• Управление ключами — лимит на ключ коннектора.
• Расходы — сколько тратит портал.
• Chat Completions — что именно уходит в Hubris.

Обновлено: 19 сентября 2026 г.