Руководство · Telegram и MAX

Полное руководство по боту для Bitrix24

Все функции бота: как зарегистрироваться, ставить и вести задачи, работать кнопками и ответами, смотреть аналитику, а также как правильно настроить входящий вебхук Bitrix24 с нужными правами.

1. Начало работы

Бот живёт в групповых чатах Telegram и MAX и превращает переписку в задачи Bitrix24. Управление — короткими командами-хештегами, кнопками под сообщениями и ответами (reply) на карточки задач. Команду можно писать и через слэш: /задача — полный аналог #задача (удобно в MAX).

Добавьте бота в чат

Добавьте бота в рабочий групповой чат отдела и обязательно сделайте его администратором чата — и в Telegram, и в MAX. Без прав администратора бот не видит сообщения: команды остаются без ответа. В MAX у бота нет реакций-эмодзи, поэтому там, где в Telegram он ставит реакцию, в MAX отвечает текстом.

Зарегистрируйте сотрудников

Регистрация связывает аккаунт мессенджера с профилем Bitrix24 — после неё работают кнопки «взять задачу», «завершить», личные уведомления и список «мои задачи».

  1. Написать боту /start в личку.
  2. Прислать ссылку на свой профиль Bitrix24 (страница «Мой профиль»).
  3. Подтвердить кнопкой и выбрать свой отдел.

Без регистрации можно ставить задачи, но нельзя брать их в работу кнопками.

⚙️ Мои настройки Бизнес

Часть поведения бота каждый настраивает под себя. Откройте личку с ботом и нажмите «⚙️ Мои настройки» в меню или напишите #настройки.

  • ИИ выбирает отдел — включено: бот сам определяет отдел по смыслу задачи. Выключите, если хотите каждый раз выбирать отдел кнопками сами.
  • Подтверждать голосовые задачи — включено: перед созданием бот показывает распознанную задачу на проверку. Выключается и кнопкой «Не спрашивать» под самой задачей, а вернуть проверку можно здесь же.

Настройки личные: у каждого сотрудника свои, на коллег они не влияют. Если выключить выбор отдела ИИ, прямое указание в тексте продолжит работать — задача «Алине подготовить отчёт» уйдёт в отдел Алины, потому что отдел назвали вы, а не угадала модель.

2. Создание задач

Текстом

Напишите команду и текст задачи — в одну строку или с переносом, как удобнее. Бот создаст задачу и пришлёт карточку с кнопками.

#задача Проверить оплату на сайте

#задача
Проверить оплату на сайте,
падает на шаге 3

С исполнителем сразу

Исполнитель должен быть зарегистрирован или иметь заполненное поле мессенджера в профиле Bitrix24.

#задача @ivanov Проверить оплату на сайте

С файлами

Прикрепите фото или документы и напишите #задача … в подписи — файлы уйдут в задачу Bitrix24.

Из чужого сообщения (reply)

Ответьте на любое сообщение командой #задача — его текст и вложения станут описанием задачи. Со второй строки можно дописать примечание.

Голосом Бизнес

Отправьте голосовое, начав со слова «задача». Бот расшифрует речь, покажет превью и попросит подтвердить кнопкой. Кнопка «Не спрашивать» отключает эту проверку лично для вас — дальше голосовые задачи будут создаваться сразу. Вернуть проверку: команда #проверка.

ИИ-анализ Бизнес

ИИ придумывает короткое название, определяет приоритет (🔴/🟡/🟢) и срок из текста («сделать до завтра» → дедлайн завтра). Всё видно в карточке.

Выбор отдела

Если в чате не задан отдел по умолчанию, бот спросит кнопками, в каком отделе создать задачу.

На тарифе Бизнес отдел может определиться сам — по смыслу задачи. Для этого в настройках у отдела должно быть заполнено, чем он занимается: по одному названию бот выбирать не станет и всё равно спросит. Когда ИИ не уверен, вопрос тоже задаётся — наугад задачи не уходят.

Защита от дубликатов

Перед созданием бот ищет похожие открытые задачи в отделе. Если нашёл — покажет список и спросит «Создать ещё одну?».

Чек-листы

Перечислите пункты прямо в тексте задачи — бот создаст чек-лист в Bitrix24:

#задача
Подготовить релиз
Чек-лист:
- собрать сборку
- прогнать тесты
- обновить документацию

Шаблоны (настраиваются под клиента): короткие команды вида #баг, #доступ сами подставят нужный отдел, чек-лист и форму описания.

3. Карточка задачи: кнопки

Под каждой созданной задачей — четыре кнопки быстрых действий.

КнопкаДействиеКто может
📌Взять задачу в работуСотрудник отдела задачи
Завершить задачуИсполнитель
✏️РедактироватьПостановщик
🗑УдалитьПостановщик

Меню «✏️ Редактировать»

  • Срок: завтра / через 3 дня — быстрое изменение дедлайна, карточка обновляется (строки не копятся).
  • Передать в другой отдел — бот закроет задачу в текущем отделе и создаст связанную в новом, со ссылками в комментариях обеих. Кнопка появляется, если отделов больше одного.
  • Отмена — возвращает исходную карточку без изменений.

Ограничений по времени на редактирование нет.

4. Работа с задачей через ответы (reply)

Все действия ниже — ответом на карточку задачи.

Что написать в ответеЧто произойдёт
Любой текстУйдёт комментарием в задачу Bitrix24
Текст + файлыКомментарий с вложениями
@usernameСмена исполнителя на указанного сотрудника
#срок завтра / #срок 20.07Изменение дедлайна
#результат <текст>Сдать результат: комментарий закрепляется в Bitrix24 как результат задачи
#чеклистПоказать чек-лист с кнопками-галочками
#передать <Отдел>Передача задачи в другой отдел
#статусТекущий статус задачи

Комментарии из Bitrix24 тоже прилетают в чат — под карточкой задачи. Когда задача завершается в Bitrix24, бот объявляет об этом в чате и прикладывает итоговые комментарии и файлы.

Сдача результата и приёмка

Двумя способами — командой в любой момент или кнопкой при завершении.

#результат Выгрузка готова, файл в общей папке

Ответьте так на карточку задачи — текст и приложенные файлы уйдут в Bitrix24, а комментарий закрепится как результат задачи, в отдельный блок карточки.

  1. Второй путь: исполнитель нажимает «Завершить» на карточке.
  2. Если у отдела включено требование результата, бот попросит прислать текст, ссылку или файлы — следующим сообщением в чат.
  3. Постановщик получает кнопки «Принять» и «Вернуть в работу». Принял — задача закрывается, вернул — снова в работе с комментарием о причине.

Сдать результат может только исполнитель задачи. Если требование результата у отдела выключено, кнопка «Завершить» закрывает задачу сразу, без этого шага — настраивается по каждому отделу. Результат с файлами уходит комментарием в чат задачи: в блок «Результат» он не закрепляется, там такой возможности у Bitrix24 нет.

5. Обсуждение → задача Бизнес

  1. Напишите #обсуждение — бот начнёт фиксировать сообщения чата (2 часа).
  2. Обсуждайте вопрос как обычно.
  3. Напишите #итог — ИИ сожмёт обсуждение в структурированную задачу: название, суть, приоритет, срок. Бот покажет превью и кнопки «Создать задачу» / «Отмена».

ИИ читает переписку именно как разговор: берёт то, о чём договорились, пропускает шутки и реплики без решения, а срок и приоритет ставит только по тем сообщениям, где решение принято. Если названо ответственное лицо, оно попадает в описание.

Обе команды работают на тарифе «Бизнес». На остальных бот ответит, что нужен другой тариф. Всю историю чата бот не импортирует — фиксация идёт только между #обсуждение и #итог.

6. Списки и статусы

КомандаЧто показывает
#задачиОткрытые задачи отдела (с пагинацией)
#задачи просроченныеТолько просроченные
#задачи сегодняС дедлайном сегодня
#задачи без исполнителяНеназначенные
#задачи застрявшиеБез движения 3+ дня
#мои задачиВаши задачи (нужна регистрация)
#статистикаСчётчики создано/выполнено по отделу

Если отделов несколько, бот предложит выбрать отдел кнопками — фильтр при этом сохраняется.

7. Аналитика Бизнес

Команда #аналитика — отчёты кнопками. Считаются только задачи, созданные через бота.

Статистика периода

Выполнено, открыто и просрочено за 30 дней.

Здоровье очереди

Просроченные, неназначенные, застрявшие и средний возраст очереди.

Распределение нагрузки

Открытые задачи по исполнителям, в процентах.

Недельный тренд

Сравнение с прошлой неделей и понятный вывод.

Аналитика показывает загрузку и очередь, а не «оценку людей», и охватывает только задачи, поставленные через бота.

8. Напоминания и уведомления

  • Задача без исполнителя — напоминание в чат, если задачу никто не взял.
  • Просроченные задачи — уведомление при пропуске дедлайна.
  • Застрявшие задачи — если по задаче нет движения несколько дней.
  • Ежедневный дайджест — сводка по отделу утром.
  • Недельный отчёт — статистика, очередь, нагрузка и тренд раз в неделю.
  • Личные уведомления — назначенному исполнителю приходит сообщение в личку (нужна регистрация и открытый диалог с ботом).

Уважаются тихие часы и рабочие дни — ночью и в выходные бот не пишет (настраивается под клиента).

9. Настройка входящего вебхука Bitrix24

Боту нужен один входящий вебхук. Второй вебхук, OAuth-приложение и исходящие события Bitrix настраивать не требуется.

  1. В Bitrix24 откройте Разработчикам → Другое → Входящий вебхук.
  2. Отметьте права из таблицы ниже. Ориентируйтесь на код в скобках: подписи на разных порталах отличаются, а код виден всегда.
  3. Сохраните и скопируйте URL вида https://ваш-портал.bitrix24.ru/rest/1/xxxxx/.
  4. Вставьте 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 без нашего бота.

Готовы подключить бота?

Мастер подключения проведёт за пять минут и сам проверит права вебхука. Первая неделя бесплатно.

Подключить бота