Получить пользователей важного сообщения

Данное активити (робот) позволяет получить список пользователей, которые видят важное сообщение в живой ленте.
Результатом работы является получение массива ID пользователей, имеющих доступ к просмотру указанного важного поста.

Описание параметров активити

Название поля	Описание и примеры использования
ID поста	В данном поле указывается числовой идентификатор поста, являющегося важным сообщением в живой ленте. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Что такое важное сообщение: Важное сообщение - это пост в живой ленте, у которого установлен флаг "Важное сообщение" и, возможно, указана дата окончания важности. Такие сообщения выделяются особым образом в интерфейсе Битрикс24 и отображаются в верхней части ленты. Данное активити возвращает список пользователей, которые: - Имеют права на просмотр этого сообщения; - Входят в список получателей (напрямую или через группы/отделы); - Видят это сообщение как важное в своей ленте. Как получить ID важного поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" с фильтрацией; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста с параметром "Важное сообщение = Y"; - Из возвращаемых параметров роботов, срабатывающих при создании важных постов.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, например, в итераторе для обработки каждого пользователя, используйте параметр "Массив результатов".

Примеры использования активити

Описание примера	Решение
Анализ охвата важных объявлений и информационных сообщений	Параметры: ID поста - {=Variable:IMPORTANT_POST_ID}. Результат: Массив результатов (массив ID пользователей), Количество результатов для анализа охвата.
Отслеживание, кто видит критически важную информацию	Параметры: ID поста - {=Variable:CRITICAL_POST_ID}. Результат: Массив результатов для проверки того, кто имеет доступ к критической информации.
Автоматическая отправка дополнительных уведомлений пользователям из списка	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и отправки персональных уведомлений каждому пользователю.
Создание отчётов о распространении важной информации	Параметры: ID поста - {=Variable:INFO_POST_ID}. Результат: Количество результатов, Результаты через запятую для формирования отчёта о количестве информированных сотрудников.
Формирование списков для последующей рассылки или создания задач	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в активити создания задач или рассылки сообщений.
Проверка корректности настройки получателей важного сообщения	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов, Соответствует условиям (Y/N) для проверки наличия получателей.
Интеграция с системами аналитики для отслеживания информированности сотрудников	Параметры: ID поста - {=Variable:ANALYTICS_POST_ID}. Результат: Результаты через запятую для передачи данных в системы аналитики.
Автоматическое создание задач для каждого пользователя из списка получателей	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и создания задачи каждому получателю.
При публикации важного объявления о корпоративных изменениях - формирование списка для HR-отдела	Параметры: ID поста - {=Variable:HR_POST_ID}. Результат: Массив результатов, Количество результатов для передачи HR-отделу списка информированных сотрудников.
Контроль доступа пользователей к важной информации о проекте	Параметры: ID поста - {=Variable:PROJECT_POST_ID}. Результат: Первый результат, Последний результат, Количество результатов для контроля доступа.

Сценарий работы робота

Активити "Получить пользователей важного сообщения" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Анализ охвата важных объявлений и информационных сообщений;
Отслеживание, кто видит критически важную информацию;
Автоматическая отправка дополнительных уведомлений пользователям из списка;
Создание отчётов о распространении важной информации;
Формирование списков для последующей рассылки или создания задач;
Проверка корректности настройки получателей важного сообщения;
Интеграция с системами аналитики для отслеживания информированности сотрудников;
Автоматическое создание задач для каждого пользователя из списка получателей.

Пример использования:
При публикации важного объявления о корпоративных изменениях можно настроить робот, который:
1. Получит список всех пользователей, видящих это важное сообщение;
2. Создаст персональную задачу каждому сотруднику с требованием ознакомиться с информацией;
3. Отправит дополнительное уведомление в чат или по email;
4. Сформирует отчёт для руководства о количестве информированных сотрудников;
5. Создаст контрольный список для HR-отдела.

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

Работа с результатами:
Активити возвращает данные в стандартном формате поиска, что позволяет легко интегрировать его с другими активити:
- Массив результатов - используйте в итераторах для обработки каждого пользователя;
- Результаты через запятую - удобно для передачи в другие методы API;
- Первый/последний результат - для быстрого доступа к граничным значениям;
- Количество результатов - для аналитики и условий в роботах;
- Соответствует условиям - быстрая проверка наличия результатов (Y/N).

Возвращаемые параметры данного активити:
- Массив результатов (массив ID пользователей);
- Результаты через запятую (строка с ID через запятую);
- Первый результат (ID первого пользователя);
- Последний результат (ID последнего пользователя);
- Количество результатов (общее количество пользователей);
- Соответствует условиям (Y - пользователи найдены, N - не найдены);
- Сообщение об ошибке (при наличии).

Ваша корзина пуста

Получить пользователей важного сообщения