SkillFoxx
Telegram

Скилл: чат-бот в открытых линиях Битрикс24

bitrix24-open-lines-bot

Claude Code skill с проверенными на живом портале нюансами imbot.v2 и imopenlines: регистрация бота, контракт событий, передача оператору

  • 0 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Только справочные знания для агента, сам код не выполняет запросов
Все причины и проверки
Российский стек

svjszn/bitrix24-openlines-skillАвтор:soajv

Установка

Сервисы

Ручная установка

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 из каталога скиллов агента.

Частые вопросы

Можно ли добавить новый канал только вебхуком?

Нет, вся группа imconnector.* отклоняет вебхук ошибкой WRONG_AUTH_TYPE, нужно полноценное OAuth-приложение или ручная настройка в интерфейсе.

Почему бот не отвечает после WELCOME_BOT_ID?

Потому что это отдельная старая функция приветствия, она не вызывает событие ONIMBOTV2MESSAGEADD, нужна регистрация через imbot.v2.Bot.register с isSupportOpenline.

Обсуждение

Вопросов и отзывов пока нет.

Битрикс24 — все инструменты
Российский стек

Claude Code skill с проверенными на живом портале нюансами REST API Битрикс24: авторизация, ошибки под HTTP 200, ретраи и лимиты

СкиллМинимальный доступ
Российский стек

Скилл Битрикс24 REST с разбивкой по модулям, allowlist методов, подтверждением рискованных действий и аудит-логом

СкиллШирокий доступ26

Bitrix24 BI-connector для Claude Code

Bitrix24 BI-connector — Claude Code skill

Российский стек

Скилл Claude Code для BI-аналитики Битрикс24: список таблиц, их колонки и выборка строк по фильтрам на естественном языке

СкиллРасширенный доступ9
Российский стек

Плагин и скилл для OpenClaw: агент общается в мессенджере Битрикс24 и работает с CRM, задачами, календарем и диском

ПлагинШирокий доступ12
Российский стек

Битрикс24 как штаб ИИ-агентов разработки: канбан-конвейер задач, общая память и приемка результата одной кнопкой с телефона

СкиллШирокий доступ1
Российский стек

Скилл для Claude Code и Codex по разработке на 1С-Битрикс и коробочном Битрикс24: сначала сверка с ядром проекта, потом решение

СкиллРасширенный доступ22

Коротко о README

README объясняет, что это файл знаний, а не фреймворк бота, и описывает два пути интеграции с открытыми линиями: бот внутри существующей линии через imbot.v2 или новый тип канала через imconnector. Перечислены нюансы: ловушка WELCOME_BOT_ID, реальная форма ответа регистрации, безопасные проверки прав вебхука без побочных эффектов, контракт события и вызовы ответа и передачи оператору, а также общий паттерн для цикла диалога с LLM.

Бейдж для README

Исходный 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.

Сообщить о проблеме