Оповещения об ошибках на почту, по СМС и в мессенджеры, ver. 1.0.0

Модуль «Оповещения об ошибках на почту, по СМС и в мессенджеры» подключается к штатному обработчику исключений Bitrix и присылает администратору уведомление о необработанных ошибках — по почте или через SMS/мессенджер, — используя уже настроенные на сайте почтовые события и SMS-провайдер.

Модуль не подменяет системный лог ошибок Bitrix, а дополняет его: регистрируется как ещё один обработчик и при каждом необработанном исключении или критической ошибке формирует и отправляет уведомление через стандартные события Bitrix (CEvent, SMS-событие модуля messageservice). Сам модуль писем не рассылает — он лишь инициирует штатное событие, поэтому канал доставки полностью зависит от того, что уже настроено на сайте: почтовый шаблон, SMS-шлюз, интеграция с мессенджером через messageservice.

• Уведомления по email и SMS/мессенджерам — два независимых события (почтовое и SMS), каждое можно включать, выключать и настраивать отдельно, стандартными средствами Bitrix.
  
• Группировка одинаковых ошибок — повторяющиеся исключения (по классу, тексту, файлу и строке) не заваливают почту дублями, а копятся в очереди и раз в заданный интервал (по умолчанию — раз в час) отправляются одним письмом со счётчиком повторений.
  
• Приоритет для критичных ошибок — fatal error и необработанные исключения можно настроить отправлять мгновенно, даже при включённой группировке, чтобы администратор не ждал конца интервала, узнав о падении сайта. Управляется отдельной галочкой в настройках, включена по умолчанию.
  
• API для собственного кода — метод Rover\Notifier\Notifier::report() позволяет отправлять произвольные сообщения (не только пойманные исключения) из кода сайта или других модулей напрямую через ту же инфраструктуру письма/SMS, минуя очередь группировки — удобно для «ручных» уведомлений вроде «не прошла оплата заказа».
  
• Настраиваемый интервал группировки — регулируется из административной панели модуля, без правки кода.
  
• Готов к работе сразу после установки — при установке автоматически создаются почтовый и SMS-типы событий и шаблон письма по умолчанию; нужно только донастроить получателя SMS и включить модуль. Для реальной доставки в Telegram/WhatsApp/MAX помимо получателя ещё нужен установленный штатный модуль «Сервис уведомлений» с подходящим коннектором-отправителем
  
• Корректное удаление — при деинсталляции модуль аккуратно убирает себя из конфигурации обработчика исключений, удаляет агент, таблицу очереди и (по желанию) созданные события/шаблоны, либо оставляет их, если отмечена соответствующая опция.
  

• Модуль никогда не прерывает основной обработчик исключений: любая ошибка на стороне самого решения (недоступна БД, не настроен SMS-шаблон и т.п.) перехватывается и гасится внутри модуля — сайт продолжает работать штатно.
  
• Защита от повторного вызова обработчика в рамках одного запроса для избегания дублирования отправки.
  
• Очередь группировки хранится в отдельной таблице через ORM Bitrix, агент разбирает её по расписанию и чистит за собой.
  
• При отключении группировки все накопленные сообщения об ошибках немедленно отправляются.
  
• Модуль не создаёт собственную инфраструктуру доставки сообщений — использует ту, что уже есть на проекте, поэтому не конфликтует с существующими интеграциями и легко встраивается в проекты любого масштаба.
  
• Приоритизация ошибок использует штатные константы обработчика исключений Bitrix (FATAL, UNCAUGHT_EXCEPTION) — отдельной системы приоритетов изобретать не пришлось, всё завязано на то, что уже даёт ядро.
  
• Административная панель отражает реальное состояние в моменте: сколько сообщений сейчас ждут отправки в очереди (со ссылкой на саму таблицу) и когда сработает следующий запуск агента группировки — не нужно лезть в БД, чтобы понять, что происходит.
  

Разработчикам и агентствам, сопровождающим коммерческие проекты, где важно узнавать о фатальных ошибках раньше, чем о них сообщит клиент, — но без риска «шторма» одинаковых писем при массовых сбоях и без изменения кода сайта после установки.

• Любая редакция «Битрикс: Управление сайтом» или «Битрикс24» в коробке.
  
• PHP 8.2 и выше.
  
• Для отправки email — ничего дополнительно не нужно, используется штатный CEvent и уже настроенный на сайте почтовый транспорт.
  
• Для отправки SMS или в мессенджер (Telegram/WhatsApp/MAX и т.п.) — модуль messageservice с настроенным провайдером; без него включена и работает только почта, ошибок это не вызывает.
  
• Агент группировки использует стандартный агентский механизм «Битрикс» — отдельный крон настраивать не нужно.