Руководство пользователя
×
Меню
Индекс
Поиск
 
   
   
   
 
  (c) ПРАЙМ ФИНАНС, 2026

9.3.9. Согласование через Max

 
В программе для удобства и скорости работы реализована возможность согласования через корпоративный мессенджер Max (VK Мессенджер).
 

Создание бота Max

Для корректной работы необходимо создать бота в платформе VK Mini Apps / Max Bot API.  Создание бота происходит в платформе VK для разработчиков.
Для создания бота необходимо в браузере перейти на портал dev.vk.com. Выполнить авторизацию с учетной записью администратора сообщества или рабочей группы Max.
 
1. Выбрать раздел "Mini Apps" или "Боты" в личном кабинете разработчика.
2. Нажать кнопку "Создать приложение".
3. Указать тип приложения — "Бот".
4. Заполнить поле "Название". Ввести уникальное имя бота для отображения в списке контактов пользователей. Имя не должно совпадать с существующими ботами в рабочем пространстве организации. Может быть любым на кириллице или латинице. Рекомендуется использовать понятные формулировки: "ФинОфис", "Согласование ФинОфис", "FinOffice Bot".
5. Заполнить поле "Адрес". Указать URL вебхука ФинОфис для получения событий (формат: https://<адрес_сервера_ФинОфис>/hs/max/webhook).
6. Записать изменения.
 

Получение токена доступа

1. Открыть вкладку "Настройки" созданного приложения.
2. Перейти в подраздел "Ключи доступа".
3. Нажать кнопку "Создать ключ".
4. Установить права доступа: "Сообщения сообщества", "Управление сообществом".
5. Подтвердить создание. Скопировать сгенерированный токен API. Сохранить значение в защищенном хранилище. Токен используется однократно при настройке подключения в ФинОфис.
 

Настройка прав и событий

1. Перейти в раздел "Типы событий" настроек бота.
2. Активировать переключатели: "Входящие сообщения", "Нажатия inline-кнопок", "Добавление в чат".
3. Проверить версию API. Указать актуальную версию (не ниже 5.199).
4. Записать настройки.
 

Проверка работоспособности

Отправить тестовое сообщение боту в мессенджере Max. Убедиться в получении ответа или реакции. При отсутствии ответа проверить настройки вебхука на стороне сервера.
 
 

Настройки

Для работы подсистемы согласования "Max" выполнить настройки в разделе "Процессы" — подраздел "Настройки пользователей (процессы)". Открыть группу "Max":
 
9.3.9. Согласование через Max
1

Имя бота Max

1. Имя бота Max
      Вводится имя бота, созданного ранее в панели управления Max.
2

Токен бота Max

2. Токен бота Max
         Вводится токен доступа API, полученный при создании бота. Обеспечивает корректный обмен сообщениями.
3

Маркер последнего обновления бота

3. Маркер последнего обновления бота
        Заполняется автоматически при обмене с мессенджером Max. Хранит идентификатор для пресечения обработки старых данных при получении обновлений.
4

Время жизни сообщений

4. Время жизни сообщений
         Срок хранения сообщений. Сообщения регистров "ФП: Визы сообщений Max" и "ФП: Очередь сообщений Max" очищаются регламентным заданием "ФП: Очистка сообщений Max" по истечении указанного времени. При значении «0» сообщения удаляются в тот же день.
5

ИД чатов пользователей Max

5. ИД чатов пользователей Max
          Гиперссылка на регистр "ФП: ИД чатов пользователей Max". Регистр хранит идентификаторы чатов пользователей с ботом, по которым осуществляется обмен. Идентификаторы обязательны для обмена и получаются из событий бота. Перед началом процесса согласования заполнить регистр.
События в Max имеют срок жизни, поэтому если ИД не появится, то пользователю нужно написать сообщение еще раз. ИД заполняется автоматически в регламентном задании "ФП: Получение обновлений max" для пользователей, чей ид не указан. В самом регистре есть кнопка "Обновить ИД", которая обновит ид у всех пользователей, события которых будут на текущий момент в обмене.
6

Очередь сообщений Max

6. Очередь сообщений Max
          Гиперссылка на регистр "ФП: Очередь сообщений Max". Регистр содержит очередь сообщений для отправки в Max. Заполняется при активации регламентного задания "ФП: Отправка оповещений согласования (Процессы)" по тем же событиям, что и письма и оповещения 1С. Используется регламентным заданием "ФП: Отправка сообщений Max". При успешной отправке запись очищается и создается запись в регистре "ФП: Визы сообщений Max".
7

Визы сообщений Max

7. Визы сообщений Max
      Гиперссылка на регистр "ФП: Визы сообщений Max". Регистр хранит статусы сообщений, отправленных ботом, в периоде, указанном в константе "Время жизни сообщений". Виды сообщений:
  • Сообщение "Уведомление" — автоматически получает статус "Отправлено".
  • Сообщение "Согласование Задачи" — первый статус "Ожидает нажатия", второй статус "Ответ получен".
Регламентное задание "ФП: Получение обновлений Max" обрабатывает сообщения со статусом "Ожидает нажатия". При наличии ответа создается запись со статусом "Ответ получен".
8

Время жизни сообщений

8. Время жизни сообщений
        Срок хранения сообщений. Сообщения регистров "ФП: Визы сообщений Max" и "ФП: Очередь сообщений Max" очищаются регламентным заданием "ФП: Очистка сообщений Max" по истечении указанного времени. При значении «0» сообщения не удаляются.
 

Настройки пользователей

 
Далее необходимо указать пользователей для этого нужно в колонке "Использовать MAX" установить галочки и ввести их ИД.
Получить числовой идентификатор пользователя Max можно следующими способами:
Способ 1. Через системного бота UserInfoBot
1. Открыть мессенджер Max.
2. Ввести @userinfobot в строке поиска или перейти по ссылке https://max.ru/userinfobot.
3. Открыть чат с ботом.
4. Нажать кнопку "Старт" или отправить команду /start.
5. Дождаться ответного сообщения — отобразится карточка профиля текущего пользователя.
6. Найти строку "Id:" в тексте ответа. Скопировать числовое значение.
 
Способ 2. Через веб-версию мессенджера
1. Открыть веб-версию мессенджера Max в браузере.
2. Перейти в раздел "Участники".
3. Выбрать нужного пользователя (например, «Мария Иванова») — откроется окно чата.
4. Скопировать адрес страницы из строки браузера. Формат адреса: https://max.ru/messenger/<числовой_идентификатор> или https://vk.com/im?sel=<числовой_идентификатор>.
5. Извлечь числовое значение из URL.
 
В разделе "Процессы"- подраздел "Настройки пользователей (процессы)".
 

Процесс согласования через Max

 
Для корректной работы согласования включить следующие регламентные задания:
  • "ФП: Отправка оповещений согласования (Процессы)"
  • "ФП: Отправка сообщений Max"
  • "ФП: Получение обновлений Max"
     
После старта согласования бот отправляет пользователю сообщение с информацией по объекту согласования.
 
 
Далее необходимо выбрать вариант согласования:
  • "Согласовать" - объект согласования на этом этапе будет успешно согласован, далее сообщение о согласовании будет отправлено следующему участнику согласования:
     
     
  • "Отменить" - объект согласования будет возвращен предыдущему согласованту. Если по маршруту согласования пользователь находится первым в списке, тогда отклоняется весь процесс:
     
     
    После того как будет изменен текущий статус, инициатору согласования придет сообщение об изменении:
     
     
    По завершению согласования, инициатору согласования придет сообщение о завершении бизнес-процесса: