Прочитать уведомления

Данное активити (робот) позволяет отмечать уведомления пользователей Битрикс24 как прочитанные или непрочитанные.
Результатом работы является изменение статуса прочтения для указанных уведомлений.

Основное назначение:
Активити позволяет программно управлять статусом прочтения уведомлений, что полезно для:
- Автоматической отметки уведомлений при выполнении определённых действий;
- Массовой обработки уведомлений по категориям;
- Сброса статуса для повторного привлечения внимания;
- Интеграции с системами обработки задач и уведомлений.

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

Название поля	Описание и примеры использования
ID уведомлений	В данном поле указывается массив идентификаторов уведомлений, которые необходимо отметить. Это обязательный параметр. Можно указать одно или несколько ID уведомлений. Пример: {=Variable:notification_ids} или "1,2,3,4,5". Как получить ID уведомлений: - Из результата работы активити "Отправка персонального уведомления" (поле notification_id); - Из результата работы активити "Отправка системного уведомления" (поле notification_id); - Из результата активити поиска или получения списка уведомлений; - Сохранённые из предыдущих операций в переменные бизнес-процесса; - Массив ID из итератора или цикла обработки. Форматы указания ID: - Прямое указание нескольких ID: 123, 456, 789; - Через переменную с массивом: {=Variable:notification_ids}; - Из результата предыдущего активити: {=Activity123:search_results_array}; - Строка с ID через запятую: "1,2,3,4,5" (автоматически преобразуется в массив). Важно: Поле поддерживает множественный выбор (Multiple), поэтому можно указать несколько ID одновременно.
Действие	В данном поле выбирается, как отметить уведомления - как прочитанные или непрочитанные. Это необязательный параметр, по умолчанию используется значение Y (прочитанные). Варианты действия: - Y (прочитанные) - уведомления будут отмечены как прочитанные и исчезнут из списка непрочитанных; - N (непрочитанные) - уведомления будут отмечены как непрочитанные и появятся в списке активных уведомлений. Когда использовать разные действия: Отметить как прочитанные (Y): После автоматической обработки уведомления; При выполнении связанной задачи или действия; Для массовой очистки уведомлений определённого типа; При закрытии связанных сделок или проектов. Отметить как непрочитанные (N): Для повторного привлечения внимания к важному уведомлению; При эскалации проблемы или задачи; Если действие требует повторного рассмотрения; Для сброса статуса при изменении условий.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Автоматическая отметка после выполнения задачи	Параметры: ID уведомлений - {=Variable:saved_notification_id}, Действие - Y (отметить как прочитанные). При завершении задачи робот отмечает связанное уведомление как прочитанное, условие: статус задачи = "Завершена". Уведомление о задаче автоматически исчезает из списка непрочитанных.
Массовая обработка уведомлений по тегу	Параметры: ID уведомлений - {=Activity456:search_results_array} (из результата поиска по тегу), Действие - Y (отметить как прочитанные). После завершения проекта робот отмечает все связанные уведомления как прочитанные, все уведомления автоматически очищаются.
Повторная активация важного уведомления	Параметры: ID уведомлений - {=Variable:urgent_notification_id}, Действие - N (отметить как непрочитанные). Если сотрудник не отреагировал на важное уведомление в течение более 24 часов и задача не выполнена, робот возвращает уведомление в статус "непрочитанное" для повторного привлечения внимания.
Очистка после изменения статуса сделки	Параметры: ID уведомлений - {=Activity789:search_results_array} (из поиска по тегу DEAL_{=Document:ID}), Действие - Y (отметить как прочитанные). При переходе сделки на стадию "Успешно реализовано" робот автоматически отмечает все уведомления по сделке как прочитанные.
Эскалация с возвратом уведомления	Параметры: ID уведомлений - {=Variable:original_notification_id}, Действие - N (отметить как непрочитанные). При эскалации проблемы (проблема не решена в срок) робот возвращает уведомление в статус "непрочитанное" для повторного рассмотрения, одновременно отправляя новое уведомление руководителю.
Итератор для массовой обработки	Параметры: ID уведомлений - {=Variable:current_notification_id}, Действие - Y (если условие выполнено) или N (если нужно вернуть внимание). Обработка большого количества уведомлений через итератор: получить список всех уведомлений определённого типа, обработать каждое уведомление индивидуально с проверкой условий.
Массовая отметка уведомлений после закрытия проекта	Параметры: ID уведомлений - {=Variable:PROJECT_NOTIFICATIONS} (массив ID всех уведомлений проекта), Действие - Y (отметить как прочитанные). При закрытии проекта все связанные уведомления автоматически отмечаются как прочитанные.
Возврат уведомления при изменении приоритета задачи	Параметры: ID уведомлений - {=Variable:TASK_NOTIFICATION_ID}, Действие - N (отметить как непрочитанные). При изменении приоритета задачи с обычного на высокий робот возвращает связанное уведомление в статус "непрочитанное" для привлечения внимания к изменившейся ситуации.
Очистка уведомлений по расписанию	Параметры: ID уведомлений - {=Variable:OLD_NOTIFICATIONS} (получены через поиск по дате), Действие - Y (отметить как прочитанные). Робот по расписанию отмечает все уведомления старше определенной даты как прочитанные для очистки списка непрочитанных.
Управление статусом уведомлений при смене ответственного	Параметры: ID уведомлений - {=Variable:OLD_RESPONSIBLE_NOTIFICATIONS}, Действие - Y (отметить как прочитанные). При смене ответственного за сделку робот отмечает все уведомления предыдущего ответственного как прочитанные, так как они больше не актуальны для него.

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

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

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

Особенности работы с массовыми операциями:
- Можно отметить одно уведомление, указав один ID;
- Можно отметить несколько уведомлений, указав массив ID;
- Все указанные уведомления будут обработаны одним запросом;
- При ошибке операция не выполняется ни для одного из ID;
- Поле processed_count показывает фактическое количество обработанных уведомлений.

Интеграция с другими активити уведомлений:
Активити "Отметка уведомлений" является частью комплексной системы управления уведомлениями:
- Отправка персонального уведомления (notify_personal_add) → создаёт уведомление, возвращает notification_id;
- Отправка системного уведомления (notify_system_add) → создаёт уведомление, возвращает notification_id;
- Отметка уведомлений (notify_read_list) → изменяет статус прочтения по ID;
- Удаление уведомления (notify_delete) → удаляет уведомления по ID, TAG или SUB_TAG.

Типичный цикл работы: 1. Создание уведомления (personal_add или system_add) → получение ID; 2. Сохранение ID в переменную для последующего использования; 3. Выполнение бизнес-логики и ожидание действий; 4. Отметка уведомления (read_list) или удаление (delete) в зависимости от результата.

Разница между отметкой и удалением уведомлений:
Отметка уведомлений (notify_read_list): Уведомления остаются в системе, но меняют статус прочтения; Можно вернуть уведомление обратно в статус "непрочитанное"; Сохраняется история уведомлений; Подходит для временного управления видимостью.
Удаление уведомлений (notify_delete): Уведомления полностью удаляются из системы; Операция необратима, восстановить уведомление нельзя; Используется для окончательной очистки; Подходит для устаревших или ошибочных уведомлений.
Рекомендация: Используйте отметку для управления вниманием, а удаление - для окончательной очистки системы.

Возвращаемые параметры данного активити:
- Статус операции (read_status) - Y (успешно) или N (ошибка);
- Количество обработанных уведомлений (processed_count) - число успешно обработанных ID;
- Тип выполненного действия (action_type) - Y (прочитанные) или N (непрочитанные);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования отметки уведомлений:
1. Сохраняйте ID уведомлений в переменные БП для последующей работы с ними;
2. Используйте теги при создании уведомлений для удобного поиска и группировки;
3. Отмечайте уведомления как прочитанные автоматически после выполнения связанных действий;
4. Используйте возврат в статус "непрочитанное" для эскалации и повторного привлечения внимания;
5. При массовой обработке используйте активити поиска для получения списка ID;
6. Проверяйте поле processed_count для контроля успешности операции;
7. Комбинируйте с условиями и итераторами для сложной логики обработки;
8. Используйте отметку вместо удаления, если уведомления могут понадобиться в истории.

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

Прочитать уведомления