Почему подключение должно быть простым
Интеграция уведомлений часто воспринимается как техническая задача: нужно создать роботов, настроить бизнес-процессы, разобраться с API, проверить права, прописать условия отправки. Для обычного администратора Битрикс24 такой путь может быть слишком долгим, особенно если нужно быстро запустить уведомления по задачам для команды.
Приложение Уведомления о задачах в MAX сделано для более простого сценария. Оно работает автоматически по событиям задач Битрикс24 и не требует настройки роботов или бизнес-процессов. Администратору нужно установить приложение, выбрать бота, указать MAX ID сотрудников и проверить отправку.
Это особенно важно для тиражного внедрения. В компании может не быть отдельного разработчика или интегратора на каждую мелкую доработку. Но потребность понятная: новая задача создана – исполнитель должен увидеть сообщение в MAX; задача завершена – постановщик и другие участники должны узнать об этом.
Встроенный MAX-бот для быстрого старта
В приложении есть встроенный бот. Это самый простой способ начать работу, потому что не нужно сразу создавать собственного MAX-бота, получать токен и разбираться с настройками Bot API. Администратор может использовать встроенного бота и быстрее проверить сценарий на тестовой задаче.
Такой вариант подходит, если компании важно быстро запустить уведомления и понять, как они работают в реальном процессе. Например, можно подключить несколько сотрудников, заполнить их MAX ID и проверить уведомления о новой и завершенной задаче.
Встроенный бот особенно удобен на старте, когда нужно показать руководителю или команде саму механику: задача ставится в Битрикс24, сообщение приходит в MAX, в сообщении есть ссылка, сотрудник переходит к задаче и работает дальше в Битрикс24.
Собственный MAX-бот компании
Если компании нужно больше контроля над внешним видом и названием отправителя, можно подключить собственного MAX-бота. Это полезно, когда уведомления должны приходить от имени компании, подразделения или внутреннего сервиса.
Собственный бот может иметь свое название и аватар. Также это удобно, если нужно разделить уведомления по подразделениям или использовать несколько ботов для разных сценариев. Например, один бот может отправлять уведомления проектной команде, другой – сервисному отделу, третий – руководителям.
Приложение поддерживает несколько ботов. Администратор может добавить нужных ботов и выбрать, какой использовать для уведомлений о задачах. Если бот не выбран вручную, приложение использует первого доступного бота.
Получение MAX ID сотрудников
Чтобы отправлять личные уведомления, нужно указать MAX ID сотрудника в карточке пользователя Битрикс24. Важно получать этот ID через бота, потому что именно такой идентификатор используется для отправки сообщений через MAX Bot API.
В приложении есть блок “Определение MAX ID”. Сотрудник пишет боту любое сообщение, после чего бот отвечает его MAX ID. Этот ID также появляется на странице настроек приложения. Администратор копирует значение и указывает его в карточке пользователя Битрикс24.
Такой сценарий снижает риск ошибки. Не нужно пытаться искать ID в браузерной версии MAX или копировать непонятные части ссылки. Пользователь просто пишет боту, а приложение показывает корректный идентификатор.
Заполнение карточки пользователя
После установки приложение создает в карточке пользователя Битрикс24 специальные поля: MAX ID для уведомлений о задачах и настройку уведомлений по задачам в MAX. В первое поле указывается пользователь или чат, куда должны приходить сообщения.
Это может быть личный ID сотрудника, ID группового чата, а также формат user: или chat: для явного указания типа получателя. Если уведомления нужно отправлять в групповой чат, бот обязательно должен быть добавлен в этот чат.
Во втором поле можно настроить персональные отключения. Например, отключить уведомление при постановке задачи на сотрудника или уведомление при завершении задачи, которую сотрудник поставил. Это помогает адаптировать приложение под разные роли в компании.
Проверка тестовой задачи
После заполнения настроек лучше создать тестовую задачу в Битрикс24. Нужно назначить исполнителя, добавить при необходимости наблюдателей или соисполнителей и проверить, пришло ли уведомление в MAX. Если исполнитель получил сообщение с названием, описанием, дедлайном и ссылкой, базовый сценарий работает.
Затем стоит завершить тестовую задачу и проверить второе событие. При завершении уведомление должны получить участники задачи, кроме исполнителя. Постановщик, наблюдатели и соисполнители увидят сообщение о завершении, если у них заполнен MAX ID и не отключены соответствующие уведомления.
Если уведомление не пришло, в первую очередь нужно проверить, выбран ли бот, написал ли пользователь боту, заполнен ли MAX ID в карточке пользователя, добавлен ли бот в групповой чат и не отключен ли нужный тип уведомления в персональных настройках.
Что получает компания после настройки
После первичной настройки приложение работает автоматически. Администратору не нужно создавать отдельные роботы, прописывать условия в бизнес-процессах или вручную сопровождать каждую задачу. События задач Битрикс24 сами запускают отправку уведомлений в MAX.
Это удобно для компаний, где нужно быстро связать задачи и мессенджер без сложной разработки. Руководители продолжают ставить задачи в Битрикс24, сотрудники получают уведомления в MAX, а вся работа по задаче остается в привычной системе.
Для запуска достаточно пройти понятную цепочку: установить приложение, проверить встроенного или добавить собственного бота, получить MAX ID сотрудников, заполнить карточки пользователей и протестировать новую и завершенную задачу. После этого Уведомления о задачах в MAX начинают работать как автоматический канал быстрых сигналов по задачам Битрикс24.