Руководство · Telegram и MAX
Полное руководство по боту для Bitrix24
Все функции бота: как зарегистрироваться, ставить и вести задачи, работать кнопками и ответами, смотреть аналитику, а также как правильно настроить входящий вебхук Bitrix24 с нужными правами.
1. Начало работы
Бот живёт в групповых чатах Telegram и MAX и превращает переписку в задачи Bitrix24. Управление — короткими командами-хештегами, кнопками под сообщениями и ответами (reply) на карточки задач. Команду можно писать и через слэш: /задача — полный аналог #задача (удобно в MAX).
Добавьте бота в чат
Добавьте бота в рабочий групповой чат отдела и выдайте ему права администратора чата. В MAX это обязательно — без прав администратора бот не видит сообщения. В MAX у бота нет реакций-эмодзи, поэтому там, где в Telegram он ставит реакцию, в MAX отвечает текстом.
Зарегистрируйте сотрудников
Регистрация связывает аккаунт мессенджера с профилем Bitrix24 — после неё работают кнопки «взять задачу», «завершить», личные уведомления и список «мои задачи».
- Написать боту
/startв личку. - Прислать ссылку на свой профиль Bitrix24 (страница «Мой профиль»).
- Подтвердить кнопкой и выбрать свой отдел.
Без регистрации можно ставить задачи, но нельзя брать их в работу кнопками.
2. Создание задач
Текстом
Первая строка — команда, дальше текст задачи. Бот создаст задачу и пришлёт карточку с кнопками.
#задача Проверить оплату на сайте, падает на шаге 3
С исполнителем сразу
Исполнитель должен быть зарегистрирован или иметь заполненное поле мессенджера в профиле Bitrix24.
#задача @ivanov Проверить оплату на сайте
С файлами
Прикрепите фото или документы и напишите #задача … в подписи — файлы уйдут в задачу Bitrix24.
Из чужого сообщения (reply)
Ответьте на любое сообщение командой #задача — его текст и вложения станут описанием задачи. Со второй строки можно дописать примечание.
Голосом Бизнес
Отправьте голосовое, начав со слова «задача». Бот расшифрует речь, покажет превью и попросит подтвердить кнопкой.
ИИ-анализ Бизнес
ИИ придумывает короткое название, определяет приоритет (🔴/🟡/🟢) и срок из текста («сделать до завтра» → дедлайн завтра). Всё видно в карточке.
Выбор отдела
Если в чате не задан отдел по умолчанию, бот спросит кнопками, в каком отделе создать задачу.
Защита от дубликатов
Перед созданием бот ищет похожие открытые задачи в отделе. Если нашёл — покажет список и спросит «Создать ещё одну?».
Чек-листы
Перечислите пункты прямо в тексте задачи — бот создаст чек-лист в Bitrix24:
#задача Подготовить релиз Чек-лист: - собрать сборку - прогнать тесты - обновить документацию
Шаблоны (настраиваются под клиента): короткие команды вида #баг, #доступ сами подставят нужный отдел, чек-лист и форму описания.
3. Карточка задачи: кнопки
Под каждой созданной задачей — четыре кнопки быстрых действий.
| Кнопка | Действие | Кто может |
|---|---|---|
| 📌 | Взять задачу в работу | Сотрудник отдела задачи |
| ✅ | Завершить задачу | Исполнитель |
| ✏️ | Редактировать | Постановщик |
| 🗑 | Удалить | Постановщик |
Меню «✏️ Редактировать»
- Срок: завтра / через 3 дня — быстрое изменение дедлайна, карточка обновляется (строки не копятся).
- Передать в другой отдел — бот закроет задачу в текущем отделе и создаст связанную в новом, со ссылками в комментариях обеих. Кнопка появляется, если отделов больше одного.
- Отмена — возвращает исходную карточку без изменений.
Ограничений по времени на редактирование нет.
4. Работа с задачей через ответы (reply)
Все действия ниже — ответом на карточку задачи.
| Что написать в ответе | Что произойдёт |
|---|---|
| Любой текст | Уйдёт комментарием в задачу Bitrix24 |
| Текст + файлы | Комментарий с вложениями |
@username | Смена исполнителя на указанного сотрудника |
#срок завтра / #срок 20.07 | Изменение дедлайна |
#результат <текст> | Сдача результата: постановщик получит кнопки «Принять» / «Вернуть в работу» |
#чеклист | Показать чек-лист с кнопками-галочками |
#передать <Отдел> | Передача задачи в другой отдел |
#статус | Текущий статус задачи |
Комментарии из Bitrix24 тоже прилетают в чат — под карточкой задачи. Когда задача завершается в Bitrix24, бот объявляет об этом в чате и прикладывает итоговые комментарии и файлы.
5. Обсуждение → задача Бизнес
- Напишите
#обсуждение— бот начнёт фиксировать сообщения чата (2 часа). - Обсуждайте вопрос как обычно.
- Напишите
#итог— ИИ сожмёт обсуждение в структурированную задачу: название, суть, приоритет, срок. Бот покажет превью и кнопки «Создать задачу» / «Отмена».
На тарифах без ИИ #итог присылает краткое текстовое резюме. Всю историю чата бот не импортирует — фиксация идёт только между #обсуждение и #итог.
6. Списки и статусы
| Команда | Что показывает |
|---|---|
#задачи | Открытые задачи отдела (с пагинацией) |
#задачи просроченные | Только просроченные |
#задачи сегодня | С дедлайном сегодня |
#задачи без исполнителя | Неназначенные |
#задачи застрявшие | Без движения 3+ дня |
#мои задачи | Ваши задачи (нужна регистрация) |
#статистика | Счётчики создано/выполнено по отделу |
Если отделов несколько, бот предложит выбрать отдел кнопками — фильтр при этом сохраняется.
7. Аналитика Бизнес
Команда #аналитика — отчёты кнопками. Считаются только задачи, созданные через бота.
Статистика периода
Выполнено, открыто и просрочено за 30 дней.
Здоровье очереди
Просроченные, неназначенные, застрявшие и средний возраст очереди.
Распределение нагрузки
Открытые задачи по исполнителям, в процентах.
Недельный тренд
Сравнение с прошлой неделей и понятный вывод.
Аналитика показывает загрузку и очередь, а не «оценку людей», и охватывает только задачи, поставленные через бота.
8. Напоминания и уведомления
- Задача без исполнителя — напоминание в чат, если задачу никто не взял.
- Просроченные задачи — уведомление при пропуске дедлайна.
- Застрявшие задачи — если по задаче нет движения несколько дней.
- Ежедневный дайджест — сводка по отделу утром.
- Недельный отчёт — статистика, очередь, нагрузка и тренд раз в неделю.
- Личные уведомления — назначенному исполнителю приходит сообщение в личку (нужна регистрация и открытый диалог с ботом).
Уважаются тихие часы и рабочие дни — ночью и в выходные бот не пишет (настраивается под клиента).
9. Настройка входящего вебхука Bitrix24
Боту нужен один входящий вебхук. Второй вебхук, OAuth-приложение и исходящие события Bitrix настраивать не требуется.
- В Bitrix24 откройте Разработчикам → Другое → Входящий вебхук.
- Отметьте все шесть прав доступа из таблицы ниже.
- Сохраните и скопируйте URL вида
https://ваш-портал.bitrix24.ru/rest/1/xxxxx/. - Вставьте URL в мастере подключения — сайт автоматически проверит, что все права выбраны, и подскажет, если чего-то не хватает.
| Право доступа | Код | Зачем боту |
|---|---|---|
| Задачи и проекты | task | Создавать и вести задачи, чек-листы, комментарии, стадии |
| Пользователи | user | Находить исполнителей и читать их поля (в т.ч. привязку к мессенджеру) |
| Структура компании | department | Отделы и руководители для маршрутизации задач |
| Рабочие группы / Соцсеть | sonet_group | Рабочие группы как «отделы бота» и их участники |
| Диск | disk | Загружать вложения задач |
| Чат и уведомления | im | Публиковать файлы в чат, привязанный к задаче |
Если какого-то права не хватает, часть функций не заработает: без disk/im не прикрепятся файлы, без department/sonet_group бот не увидит отделы. Поэтому включайте все шесть.
10. Тарифы
| Возможность | Продвинутый | Бизнес / Премиум |
|---|---|---|
| Задачи, комментарии, файлы, кнопки | ✅ | ✅ |
| Списки, фильтры, статистика | ✅ | ✅ |
| Чек-листы, результаты, передача отделов | ✅ | ✅ |
| Напоминания и сводки | ✅ | ✅ |
| ИИ-анализ задач (название, приоритет, срок) | — | ✅ |
| Голосовые задачи | — | ✅ |
| ИИ-итог обсуждений | — | ✅ |
| Аналитика (отчёты) | — | ✅ |
Премиум = всё из «Бизнеса» плюс выделенная инфраструктура, приоритетное внедрение и сопровождение по договору. После окончания подписки кнопки и команды вежливо сообщают о необходимости продления. Второй мессенджер (Telegram + MAX) подключается как дополнительный коннектор с общими задачами. Актуальные цены — на странице продукта.
11. Шпаргалка команд
#задача <текст> — создать задачу (также /задача) #задача @user <текст> — создать с исполнителем #обсуждение / #итог — зафиксировать обсуждение → задача (ИИ) #задачи [фильтр] — списки задач #мои задачи — персональный список #статистика — счётчики отдела #аналитика — отчёты (кнопками) Ответом на карточку задачи: <текст> — комментарий @username — сменить исполнителя #срок <дата/завтра> — изменить дедлайн #результат <текст> — сдать результат #чеклист — показать чек-лист #передать <Отдел> — передать в другой отдел #статус — статус задачи
Готовы подключить бота?
Мастер подключения проведёт за пять минут и сам проверит права вебхука. Первая неделя бесплатно.
Подключить бота