Представьте: отдел продаж из 12 менеджеров тратит в среднем 20 минут в день на поиск задач и контактов в Битрикс24. Внутренний чат-бот может автоматизировать эти запросы, отвечая на команды /сделки или /клиент за секунду. Мы разрабатываем бота для внутреннего чата Битрикс24 с нуля: от регистрации в модуле im до асинхронной архитектуры и OAuth-авторизации. Внутренний чат Битрикс24 — не просто мессенджер, через него проходят уведомления CRM, напоминания о задачах, алерты из внешних систем. Бот автоматизирует рутину: отвечает на вопросы сотрудников, агрегирует данные из разных модулей, выполняет команды прямо из диалогового окна. Наш опыт — 50+ проектов для отделов продаж, HR и IT-поддержки. Бот работает на основе REST API Битрикс24 и может выполнять действия от имени пользователя.
Что даёт внутренний бот по сравнению с клиентским?
Клиентский бот работает в открытых линиях и ограничен: не имеет доступа к CRM и задачам. Внутренний бот, напротив, получает полный доступ к данным портала через REST API, может использовать права конкретного пользователя и отправлять rich-сообщения в групповые чаты. Регистрация через imbot.register без флага OPENLINE: Y. Это делает его в 3 раза эффективнее для автоматизации внутренних процессов.
Типовые сценарии и их реализация
HR-бот
Сотрудник пишет /отпуск 15.07-28.07 → бот создаёт запрос на отпуск через timeman.absence.create, уведомляет руководителя, отмечает дни в календаре через calendar.event.add. Без хождения по разделам Битрикс24.
Бот отчётности
Руководитель пишет /отчёт продажи июнь → бот делает запрос crm.deal.list с фильтром по датам и ответственным → формирует сводку прямо в чате: количество сделок, сумма, конверсия по стадиям.
Дежурный бот
Мониторинг внешних систем (сервер, сайт, очередь задач) → при превышении порогов отправляет алерт в чат дежурного инженера с кнопками «Принял», «Эскалировать».
IT-helpdesk бот
Сотрудник пишет проблему → бот создаёт задачу в проекте техподдержки через tasks.task.add, назначает исполнителя по ротации, присылает номер тикета. Статус тикета можно запросить командой /тикет 1234.
Регистрация и обработка команд
Бот регистрируется с указанием обработчика команд:
POST /rest/imbot.register
{
"CODE": "internal_helper",
"EVENT_MESSAGE_ADD": "https://your-server.com/internal-bot/message",
"EVENT_COMMAND_ADD": "https://your-server.com/internal-bot/command",
"OPENLINE": "N"
}
Команды регистрируются через imbot.command.register:
{
"BOT_ID": 456,
"COMMAND": "отчёт",
"COMMON": "Y",
"HIDDEN": "N",
"EXTRANET_SUPPORT": "N",
"LANG": [{"LANGUAGE_ID": "ru", "TITLE": "Отчёт по продажам", "PARAMS": "период"}]
}
После регистрации команда появляется в автодополнении чата при вводе /. Подробнее о REST API читайте в официальной документации.
Пошаговая инструкция по регистрации
- Создайте приложение в Битрикс24 (раздел Разработчикам).
- Получите код приложения и настройте обработчики событий.
- Выполните запрос imbot.register с вашим сервером-обработчиком.
- Зарегистрируйте команды через imbot.command.register с параметрами.
- Настройте обработку вебхуков и верните 200 OK.
Кейс: бот для отдела продаж
Задача: 12 менеджеров, частые вопросы «сколько у меня открытых сделок», «когда последний контакт с клиентом X», «что по задачам на сегодня». Клиент — компания с оборотом 500+ сделок в месяц.
Реализация: Python (FastAPI) + Битрикс24 REST API. Команды:
-
/сделки→ список открытых сделок менеджера с суммами и стадиями. -
/клиент [название]→ поиск контакта с последней активностью. -
/задачи→ задачи на сегодня с дедлайном. -
/звонок [телефон]→ инициировать исходящий звонок.
Авторизация: бот использует токен пользователя, полученный через OAuth при первом обращении. Токены хранятся в Redis с TTL 30 дней.
Экономия составила 15–20 минут в день на менеджера, что при средней зарплате даёт снижение затрат на рутину на 30%. Нагрузка минимальная — 3-5 API-запросов на команду. Окупаемость — меньше месяца.
Главная сложность: ротация токенов. Bitrix24 REST-токены живут 1 час, refresh — 30 дней. Если пользователь не обращался к боту 30 дней — нужна повторная авторизация. Решение: webhook вместо OAuth для портальных приложений (webhook не протухает, но имеет права приложения, а не конкретного пользователя).
Почему асинхронная обработка обязательна?
Бот-сервис должен отвечать на вебхук Битрикс24 за 3 секунды. Иначе Битрикс24 считает запрос неуспешным и повторяет его — что приводит к дублям сообщений. Асинхронная обработка в 10 раз снижает количество дублей по сравнению с синхронным подходом.
Правильная архитектура:
- Вебхук принимает запрос, немедленно возвращает 200 OK.
- Задача кладётся в очередь (Redis Queue, RabbitMQ).
- Воркер обрабатывает задачу асинхронно, отвечает через imbot.message.add.
| Подход | Время ответа | Риск дублей | Сложность |
|---|---|---|---|
| Синхронный | <3 сек | Высокий | Низкая |
| Асинхронный | <1 сек | Низкий | Средняя |
Оценка трудозатрат
| Компонент | Трудозатраты |
|---|---|
| Базовый бот (3-5 команд) | 16–32 ч |
| OAuth авторизация пользователей | 8–16 ч |
| Сложные команды с агрегацией данных | 16–40 ч |
| Очередь + асинхронная обработка | 8–16 ч |
| Деплой, мониторинг, тесты | 8–16 ч |
Что входит в работу?
- Полный цикл: аудит сценариев, прототипирование, разработка, тестирование, деплой.
- Документация по командам и эксплуатации.
- Настройка мониторинга и алертинга.
- Обучение администраторов.
- Гарантия 6 месяцев на код.
Получите консультацию по архитектуре вашего бота — наши инженеры имеют сертификаты 1С-Битрикс и 5+ лет опыта в разработке ботов. Свяжитесь с нами — мы оценим ваш проект за 1 день.