Подключение бота к Bitrix24 занимает около пяти минут, и почти всё это время уходит на один экран — создание входящего вебхука с правильным набором прав. Ошибаются обычно именно там: выбирают два права из шести, потом выясняют, что файлы не прикрепляются и отделы не видны.
Ниже — весь порядок целиком, от вебхука до первой созданной задачи, с объяснением, что именно ломается при каждом пропущенном шаге.
Что понадобится
Три вещи, все бесплатные:
- портал Bitrix24 и права администратора на нём — вебхук создаёт только администратор;
- рабочий групповой чат в Telegram или MAX, куда добавится бот;
- примерно пять минут.
Платёжные данные для пробного периода не нужны: первые семь дней доступны с полным набором функций.
Шаг 1. Создать входящий вебхук
В Bitrix24 откройте раздел Разработчикам → Другое → Входящий вебхук.
Это единственная интеграция, которую нужно завести. Второй вебхук, приложение OAuth и настройка исходящих событий Bitrix не требуются — их часто предлагают в инструкциях к другим решениям, здесь они лишние.
После сохранения Bitrix24 покажет адрес вида https://ваш-портал.bitrix24.ru/rest/1/xxxxx/. Скопируйте его целиком, вместе с завершающей косой чертой.
Шаг 2. Выдать все шесть прав
На том же экране отмечаются права доступа. Их шесть, и каждое отвечает за конкретную часть работы.
- Задачи и проекты (
task) — создание и ведение задач, чек-листы, комментарии, стадии. Основа всего. - Пользователи (
user) — поиск исполнителей и чтение их полей, включая привязку к мессенджеру. Без этого права бот не поймёт, кому назначать задачу. - Структура компании (
department) — отделы и руководители для маршрутизации. Без него бот не увидит отделы, и выбор отдела при постановке работать не будет. - Рабочие группы / Соцсеть (
sonet_group) — рабочие группы используются как «отделы бота», отсюда же берутся их участники. - Диск (
disk) — загрузка вложений. Без этого права фото и документы из чата в задачу не попадут. - Чат и уведомления (
im) — публикация файлов в чат, привязанный к задаче.
Отмечайте все шесть. Соблазн выдать поменьше понятен, но каждое недостающее право отключает свой кусок функциональности, причём молча — бот не сообщит «мне не хватает прав», он просто не сделает часть работы.
Шаг 3. Вставить адрес в мастер подключения
Скопированный адрес вставляется в мастер на сайте. Дальше сайт сам обращается к порталу и проверяет, все ли права выбраны. Если чего-то не хватает, он назовёт конкретное право — возвращаетесь в Bitrix24, добавляете, пересохраняете.
Эта автопроверка избавляет от самой муторной части: не нужно выяснять опытным путём, почему не работает загрузка файлов.
Шаг 4. Добавить бота в рабочий чат
Бот живёт в групповом чате отдела. Добавьте его туда и выдайте права администратора чата.
В Telegram без прав администратора часть функций всё же работает. В MAX они обязательны: без них бот вообще не видит сообщения, команды до него не доходят, и со стороны это выглядит как неисправность. Если задачи не создаются — проверяйте этот пункт первым.
Про особенности работы в российском мессенджере мы написали отдельно: Бот для Bitrix24 в MAX: задачи в российском мессенджере.
Шаг 5. Разложить отделы
Отделы бота соответствуют рабочим группам Bitrix24. Логика простая: чат отдела привязывается к своему отделу, и задачи из этого чата попадают туда автоматически, без лишнего вопроса при постановке.
Если чат к отделу не привязан, бот спросит кнопками, куда создавать задачу. Для команды с одним потоком работ это лишний клик, для компании с несколькими направлениями — наоборот, страховка от попадания задачи не туда.
Привязка чатов к отделам и передача задач между отделами доступны с тарифа «Продвинутый». На «Старте» отдел один, и задача создаётся сразу.
Шаг 6. Зарегистрировать сотрудников
Регистрация связывает аккаунт в мессенджере с профилем в Bitrix24. Занимает у человека полминуты:
- сотрудник присылает боту ссылку на свою страницу «Мой профиль» в Bitrix24;
- подтверждает кнопкой;
- выбирает свой отдел.
После этого работают кнопки «взять задачу» и «завершить», приходят личные уведомления о новых задачах и открывается список своих задач.
Без регистрации сотрудник по-прежнему может ставить задачи, но брать их в работу кнопками не сможет. Это самая частая причина обращения «кнопки не нажимаются» в первые дни.
Личные уведомления требуют ещё одного условия: у сотрудника должен быть открыт диалог с ботом. Достаточно, чтобы он один раз написал боту в личку.
Шаг 7. Поставить первую задачу
В рабочем чате напишите сообщение, где первая строка — команда, а дальше текст:
#задачаПодготовить смету по объекту на Ессентукской к пятнице
Бот создаст задачу в Bitrix24 и пришлёт карточку с кнопками: взять в работу, изменить срок, переназначить, передать в другой отдел. Дальше вся работа идёт ответами на эту карточку.
Проверьте заодно вложения: прикрепите к сообщению фотографию и добавьте команду в подписи — файл должен уйти в задачу. Если не ушёл, вернитесь к шагу 2 и посмотрите право disk.
Разбор остальных команд и кнопок — в статье Как ставить задачи в Bitrix24 прямо из Telegram и MAX и в полном руководстве.
Проверка после подключения: семь пунктов
Пройдите этот список сразу, пока помните, что настраивали. Каждый пункт занимает меньше минуты и проверяет своё право или шаг.
- Задача создаётся. Написали команду с текстом — пришла карточка. Работает право
task. - Файл долетает. Прикрепили фото с командой в подписи — оно видно в задаче на портале. Работает
disk. - Отделы видны. Если отделов больше одного, при постановке бот предлагает выбор. Работает
departmentиsonet_group. - Исполнитель находится. Назначили задачу коллеге — он определился по имени. Работает
user. - Кнопки нажимаются. Сотрудник взял задачу кнопкой «взять в работу» и статус изменился на портале. Значит, регистрация прошла.
- Личное уведомление пришло. Исполнитель получил сообщение в личку о новой задаче. Если нет — он не открывал диалог с ботом.
- Комментарий вернулся. Написали комментарий в задаче на портале — он появился в чате под карточкой.
Если все семь прошли, подключение выполнено полностью и дальше можно работать. Если споткнулись на каком-то пункте, он прямо указывает, куда возвращаться.
Что стоит сделать до подключения
Бот раскладывает задачи по той структуре, которая уже есть в Bitrix24. Если структура запущена, беспорядок просто переедет в мессенджер.
Полчаса перед стартом окупаются:
- Проверьте список сотрудников. Уволенные должны быть деактивированы, иначе они попадут в список возможных исполнителей.
- Посмотрите рабочие группы. Они станут отделами бота. Группы вида «Тест», «Новая группа» и три варианта одного отдела лучше убрать заранее.
- Заполните структуру компании. Отделы и руководители нужны для маршрутизации задач и для того, чтобы бот понимал, кому что показывать.
- Решите, какой чат к какому отделу относится. Если в компании один общий чат на всё, имеет смысл сначала развести его по направлениям — иначе выбор отдела придётся делать вручную при каждой постановке.
Отдельно подумайте про сотрудников, которые в Bitrix24 почти не заходят. Именно ради них бот и ставится, но им понадобится тридцать секунд на регистрацию. Лучше пройти её вместе на общей встрече, чем потом ловить каждого поодиночке — типичная причина, по которой внедрение буксует, разобрана в статье Сотрудники не заходят в Bitrix24.
Что чаще всего идёт не так
Выдали не все права. Симптомы разные и не всегда очевидные: файлы не прикрепляются, отделы не показываются, исполнитель не находится. Лечится добавлением недостающего права в том же вебхуке.
Забыли права администратора чата. Особенно в MAX. Бот в чате есть, на команды не реагирует.
Скопировали адрес вебхука не полностью. Обрезанный хвост или потерянная косая черта на конце — и обращения к порталу не проходят.
Исполнителя не находит. Человек должен быть либо зарегистрирован у бота, либо иметь заполненное поле мессенджера в профиле Bitrix24.
Вебхук создал не администратор. Пользователь с ограниченными правами создаст вебхук, но выдать полный набор прав не сможет — часть галочек будет недоступна.
Сколько стоит после пробного периода
- Старт, 2 990 ₽ в месяц — один отдел, задача создаётся сразу.
- Продвинутый, 5 990 ₽ в месяц — несколько отделов с выбором, шаблоны задач, передача между отделами, привязка чатов к отделам.
- Бизнес, 9 900 ₽ в месяц — голосовые задачи, ИИ-подбор названия, приоритета и срока, сжатие обсуждений в задачу, отчёты.
Количество задач и файлов тарифом не ограничено — действуют только лимиты мессенджера и самого Bitrix24. Годовая оплата дешевле. Второй мессенджер подключается дополнительным коннектором с общими задачами.
Коротко
Весь порядок: входящий вебхук в Bitrix24 → шесть прав → адрес в мастер → бот в чат с правами администратора → отделы → регистрация сотрудников → первая задача. Самое важное место — набор прав, всё остальное проходит быстро.
Начать можно на странице продукта. Если структура компании сложная, отделов много или Bitrix24 настраивали давно и в нём накопился беспорядок, поможем разложить — это наша обычная работа по интеграциям.
Застряли на каком-то шаге — напишите, посмотрим вместе: t.me/cloudxbear_manager.