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