Скилл: чат-бот в открытых линиях Битрикс24
bitrix24-open-lines-bot
Claude Code skill с проверенными на живом портале нюансами imbot.v2 и imopenlines: регистрация бота, контракт событий, передача оператору
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только справочные знания для агента, сам код не выполняет запросов
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/bitrix24-open-lines-botОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .claude/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .claude/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .agents/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .github/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .github/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .agents/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .agents/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .devin/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .devin/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .cline/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .cline/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .roo/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .roo/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-openlines-skill --skill bitrix24-open-lines-bot -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 9c72ab2
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .agents/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .agents/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-openlines-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-open-lines-bot/
git -C "$tmp" checkout 9c72ab227517aeae393be22068f6fe39d3dd8bad
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-open-lines-bot" .agents/skills/bitrix24-open-lines-botКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Скопируй или подключи символьной ссылкой папку skills/bitrix24-open-lines-bot из soajv/bitrix24-openlines-skill в каталог скиллов Claude Code вместе со связанным скиллом bitrix24-rest-api и загружай перед работой с чат-ботом открытых линий.
Другие способы из описания автора
git clone https://github.com/soajv/bitrix24-openlines-skill.git && cp -r bitrix24-openlines-skill/skills/bitrix24-open-lines-bot ~/.claude/skills/Скопируйте папку скилла в каталог скиллов Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл дает агенту знания для встраивания чат-бота в уже существующую открытую линию Битрикс24 через imbot.v2.Bot.register, а не для регистрации нового типа канала через imconnector, который требует OAuth-приложение и отклоняет вебхук ошибкой WRONG_AUTH_TYPE. Объясняет, почему imopenlines.config.update с WELCOME_BOT_ID не привязывает бота к линии, а относится к отдельной старой функции приветствия. Описывает реальную вложенную форму ответа регистрации, способ сделать ее идемпотентной при перезапусках, контракт входящего события ONIMBOTV2MESSAGEADD с проверкой auth.application_token и вызовы для ответа и передачи диалога оператору.
Для кого. Для разработчиков, которые строят чат-бота внутри открытой линии Битрикс24 через ИИ-агента.
Подходит, если
- Встраиваете бота в уже настроенную открытую линию
- Непонятно, почему WELCOME_BOT_ID не подключает бота к линии
- Нужен контракт входящих событий imbot.v2 и передача оператору
Не подходит, если
- Нужно зарегистрировать новый тип канала или коннектора: для этого нужно полноценное OAuth-приложение
- Нужны общие основы авторизации Битрикс24: для этого есть связанный базовый скилл
Пример запроса к агенту
Зарегистрируй бота в открытой линии Битрикс24 через imbot.v2 и настрой передачу диалога операторуОграничения
Файл знаний для агента, а не готовый бот или библиотека, своего кода бота в репозитории нет. Опирается на связанный скилл bitrix24-rest-api для базовой авторизации. Факты датированы сентябрем 2026 года и проверялись на одном реальном портале.
Как отключить. Удалите папку skills/bitrix24-open-lines-bot из каталога скиллов агента.
Проверка безопасности
- Только справочные знания для агента, сам код не выполняет запросов
Коротко о README
README объясняет, что это файл знаний, а не фреймворк бота, и описывает два пути интеграции с открытыми линиями: бот внутри существующей линии через imbot.v2 или новый тип канала через imconnector. Перечислены нюансы: ловушка WELCOME_BOT_ID, реальная форма ответа регистрации, безопасные проверки прав вебхука без побочных эффектов, контракт события и вызовы ответа и передачи оператору, а также общий паттерн для цикла диалога с LLM.
SKILL.md
--- name: bitrix24-open-lines-bot description: How to build a chatbot that answers inside an existing Bitrix24 Open Line — registration via imbot.v2, the incoming event contract, replying, and handing off to a human operator. Load this before building or debugging the Bitrix24 text-channel sales agent. --- # Bitrix24 Open Lines chatbot Source: official Bitrix24 REST API docs, verified Sep 2026. See bitrix24-rest-api skill first for general auth and retry conventions this builds on. ## The two integration paths — pick the right one - A bot that answers inside an already-existing Open Line — register via imbot.v2.Bot.register with isSupportOpenline: true. This is almost certainly what is meant by a text agent in Open Lines. - A brand-new channel type — requires imconnector.register plus imconnector.activate and imconnector.connector.data.set. Heavier, and not needed just to add an AI responder to an existing line. Confirmed empirically: the entire imconnector.* family rejects inbound-webhook auth outright with WRONG_AUTH_TYPE.
Частые вопросы
Можно ли добавить новый канал только вебхуком?
Нет, вся группа imconnector.* отклоняет вебхук ошибкой WRONG_AUTH_TYPE, нужно полноценное OAuth-приложение или ручная настройка в интерфейсе.
Почему бот не отвечает после WELCOME_BOT_ID?
Потому что это отдельная старая функция приветствия, она не вызывает событие ONIMBOTV2MESSAGEADD, нужна регистрация через imbot.v2.Bot.register с isSupportOpenline.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма