Удаление уведомления

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

ВАЖНО!
Для удаления уведомления необходимо указать хотя бы один из трёх параметров на выбор:
- ID (идентификатор уведомления);
- TAG (тег уведомления);
- SUB_TAG (дополнительный тег).

Можно также комбинировать несколько параметров для более точного удаления.
Если ни один из параметров не будет указан, активити вернёт ошибку.

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

Название поля	Описание и примеры использования
ID уведомления	В данном поле указывается числовой идентификатор уведомления, которое необходимо удалить. Это необязательный параметр, но хотя бы один из трёх параметров (ID, Тег или Дополнительный тег) должен быть заполнен. Пример: {=Variable:notification_id} или 12345. Как получить ID уведомления: - Из результата работы активити "Отправка персонального уведомления" (поле notification_id); - Из результата работы активити "Отправка системного уведомления" (поле notification_id); - Сохранённый из предыдущих операций с уведомлениями; - Переменная бизнес-процесса, в которой хранится ID уведомления. Примеры указания ID: - Прямое указание: 123, 456; - Через переменную: {=Variable:notification_id}; - Из результата предыдущего активити: {=Activity123:notification_id}.
Тег уведомления	В данном поле указывается тег уведомления, уникальный в рамках системы. Это необязательный параметр, но хотя бы один из трёх параметров должен быть заполнен. Пример: {=Variable:NOTIFICATION_TAG} или "PERSONAL_DEAL_123". Удаление по тегу: При указании тега будут удалены все уведомления с этим тегом у пользователя. Это особенно удобно для массового удаления однотипных уведомлений. Примеры использования тегов: - TAG="PERSONAL_DEAL_123" - удалить все персональные уведомления о сделке 123; - TAG="PERSONAL_TASK_456" - удалить напоминания о задаче 456; - TAG="WELCOME_MESSAGE" - удалить приветственные сообщения; - TAG="BIRTHDAY_GREETING_2025" - удалить поздравления с днём рождения за 2025 год. Практическое применение: Если вы отправляли уведомления с определённым тегом, вы можете удалить все эти уведомления, указав тот же тег.
Дополнительный тег	В данном поле указывается дополнительный тег уведомления, без проверки на уникальность. Это необязательный параметр, но хотя бы один из трёх параметров должен быть заполнен. Пример: {=Variable:SUB_TAG} или "TYPE\|PERSONAL". Удаление по дополнительному тегу: При указании дополнительного тега будут удалены все уведомления с этим SUB_TAG. Это позволяет удалять уведомления по категориям или типам. Примеры использования дополнительного тега: - SUB_TAG="TYPE\|PERSONAL" - удалить все персональные сообщения; - SUB_TAG="CATEGORY\|GREETING" - удалить все поздравления; - SUB_TAG="EVENT\|BIRTHDAY" - удалить все уведомления о днях рождения; - SUB_TAG="PRIORITY\|HIGH" - удалить все высокоприоритетные уведомления. Важно: Можно комбинировать несколько параметров для более точного удаления. Например, указать и TAG, и SUB_TAG одновременно.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Удаление напоминания после выполнения задачи	Параметры: ID уведомления - {=Activity456:notification_id} (ID из активити отправки), Тег уведомления - TASK_REMINDER_{=Document:ID}, Дополнительный тег - TYPE\|REMINDER. Когда задача выполнена, робот автоматически удаляет уведомление-напоминание.
Удаление уведомлений при отмене встречи	Параметры: Тег уведомления - MEETING_REMINDER_{=Document:EVENT_ID}, Дополнительный тег - EVENT\|MEETING. При отмене или переносе встречи робот удаляет все связанные уведомления, все участники больше не будут получать напоминания об отменённом событии.
Массовая очистка по категории в конце года	Параметры: Дополнительный тег - EVENT\|BIRTHDAY_2024. В конце года робот удаляет все поздравительные уведомления прошлого года для поддержания порядка и актуальности уведомлений в системе.
Удаление при смене ответственного за сделку	Параметры: Тег уведомления - DEAL_NOTIFICATION_{=Document:ID}_{=Document:OLD_ASSIGNED_BY_ID}, Дополнительный тег - TYPE\|DEAL_ALERT. При смене ответственного робот удаляет уведомления предыдущего ответственного, новому ответственному будут отправлены новые уведомления.
Удаление при закрытии сделки	Параметры: Тег уведомления - DEAL_TEMP_{=Document:ID}, Дополнительный тег - STATUS\|TEMPORARY. При успешном закрытии сделки робот удаляет все временные уведомления, после завершения работы по сделке все промежуточные напоминания становятся неактуальными.
Удаление дублирующихся уведомлений	Параметры: Тег уведомления - UNIQUE_NOTIFICATION_{=Document:ID}. При повторной отправке уведомления с уникальным тегом робот сначала удаляет старое уведомление, затем отправляет новое, гарантируя, что пользователь увидит только актуальную версию уведомления.
Удаление устаревших уведомлений о встречах	Параметры: Тег уведомления - {=Variable:MEETING_TAG}, Дополнительный тег - TYPE\|MEETING. Автоматическое удаление уведомлений о встречах, которые уже прошли или были отменены.
Очистка при переводе пользователя в другой отдел	Параметры: Дополнительный тег - DEPARTMENT\|OLD_DEPT_{=Variable:OLD_DEPARTMENT_ID}. При переводе пользователя робот удаляет все уведомления, связанные с его предыдущим отделом.
Удаление служебных уведомлений по расписанию	Параметры: Дополнительный тег - CATEGORY\|SERVICE, Тег уведомления - {=Variable:SERVICE_TAG}. Робот по расписанию удаляет все служебные уведомления определённого типа для очистки системы.
Удаление тестовых уведомлений после завершения тестирования	Параметры: Тег уведомления - TEST_NOTIFICATION_{=Variable:TEST_ID}, Дополнительный тег - TYPE\|TEST. После завершения тестирования робот удаляет все тестовые уведомления для очистки системы от временных данных.

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

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

Удаление устаревших уведомлений о встречах и событиях;
Очистка уведомлений при отмене задач или изменении статусов;
Удаление временных напоминаний после выполнения действия;
Массовое удаление однотипных уведомлений по тегу;
Очистка уведомлений при закрытии сделок или завершении проектов;
Удаление дублирующихся уведомлений;
Очистка спам-уведомлений или ошибочно отправленных сообщений;
Удаление уведомлений при переводе пользователя в другой отдел.

Особенности работы с параметрами удаления:
- Можно указать только ID для удаления конкретного уведомления;
- Можно указать только TAG для удаления всех уведомлений с этим тегом;
- Можно указать только SUB_TAG для удаления всех уведомлений с этим дополнительным тегом;
- Можно комбинировать параметры для более точного удаления;
- Если ни один параметр не указан, активити вернёт ошибку.

Связь с другими активити уведомлений:
- Отправка персонального уведомления (notify_personal_add) - создаёт персональное уведомление, возвращает notification_id;
- Отправка системного уведомления (notify_system_add) - создаёт системное уведомление, возвращает notification_id;
- Удаление уведомления (notify_delete) - удаляет уведомления по ID, TAG или SUB_TAG.

Используйте эти активити вместе для полного управления уведомлениями в бизнес-процессах.

Важно помнить:
Удалённые уведомления невозможно восстановить. Убедитесь, что удаляете правильные уведомления, проверив параметры перед запуском робота.

При использовании тегов для удаления будут удалены ВСЕ уведомления с указанным тегом или дополнительным тегом.
Будьте внимательны при массовом удалении.

Возвращаемые параметры данного активити:
- Статус удаления (delete_status) - Y (успешно) или N (ошибка);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования удаления уведомлений:
1. Всегда используйте теги при отправке уведомлений, если планируете их удалять;
2. Сохраняйте notification_id из активити отправки для точечного удаления;
3. Используйте дополнительные теги для категоризации и массового удаления;
4. Удаляйте устаревшие уведомления автоматически при изменении статусов;
5. Комбинируйте параметры для более точного контроля удаления;
6. Регулярно очищайте временные и промежуточные уведомления;
7. При массовых рассылках используйте уникальные теги для каждой категории.

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

Удаление уведомления