Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Уведомления Депешер
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
«Уведомления Депешер» передают события вашего сайта или интернет-магазина в сервис Депешер. Решение помогает следить за заказами, заявками, изменениями контента и другими событиями из единого сервиса уведомлений.
Модуль бесплатный. Право использования предоставляется без ограничения числа установок и без установленного календарного срока окончания, на весь срок действия исключительного права. Допускается использование на личных и коммерческих сайтах.
В административном разделе Битрикса вы выбираете события, объединяете их в группы и задаёте правила отправки в каналы Депешера. События поступают в локальную очередь, а отправка выполняется отдельным обработчиком. При временных сетевых ошибках и временных ошибках сервиса модуль автоматически повторяет запросы.
Какие события поддерживаются- Самостоятельная регистрация пользователя и неуспешная попытка входа.
- Добавление, изменение и удаление элементов выбранных инфоблоков.
- Создание заказа, изменение его статуса, отмена и восстановление заказа.
- Полная оплата заказа и отмена полной оплаты.
- Создание результата выбранной веб-формы.
- Завершение импорта каталога из 1С.
- Пользовательские события, которые разработчик регистрирует и отправляет через PHP API модуля.
Доступность встроенных событий зависит от состава установленной редакции и наличия соответствующих модулей Битрикса.
Возможности- Несколько каналов Депешера и отдельные правила отправки для каждого канала.
- Правила для отдельного события или группы событий.
- Отбор по сайтам, инфоблокам, веб-формам и статусам заказов — в зависимости от события.
- Поддержка многосайтовой конфигурации: правила могут учитывать идентификатор сайта.
- Тестовая отправка для проверки подключения канала.
- Журнал доставок с данными события, состоянием отправки и историей попыток.
- Ручной повтор ошибочных доставок, пока они сохраняются в журнале и не истёк срок актуальности.
- Страница состояния очереди и счётчик уведомлений, отклонённых из-за её переполнения.
- Разделение прав на просмотр и управление модулем.
- Передача названия источника и окружения, чтобы различать рабочий, тестовый и разрабатываемый сайты.
Для отправки уведомлений требуется канал во внешнем сервисе Депешер и его webhook вида https://depesher.ru/w/{public_id}. Модуль отправляет данные событий в этот сервис; получателей и представление уведомлений необходимо настроить в Депешере. Произвольные адреса других сервисов модулем не поддерживаются.
Модуль и сервис Депешер предоставляются бесплатно. В Депешере доступен один тариф — бесплатный; платных тарифов на данный момент нет. Для подключения и использования описанной интеграции дополнительная оплата не требуется.
Требования и ограничения- Хостинг должен поддерживать регулярный запуск агентов Битрикса через cron раз в минуту. Выполнение агентов на посещениях необходимо отключить: иначе отправка может задерживать загрузку страниц сайта.
- Серверу сайта нужен исходящий HTTPS-доступ к depesher.ru на порту 443.
- Очередь и журнал хранятся в базе данных сайта. Реализована работа с MySQL/InnoDB и PostgreSQL.
- Установщик требует PHP 8.2 или новее и модуль main версии 20.0.0 или новее. Функциональность проверена на PHP 8.2, 8.4 и main 26.150.0.
- Реализована работа с UTF-8 и Windows-1251.
- Для установки и основной настройки нужны права администратора Битрикса; для настройки cron — доступ к панели хостинга или помощь администратора сервера. Подключение пользовательских событий требует навыков PHP-разработки.
- Дополнительные партнёрские модули для основной работы не требуются. Для отдельных встроенных событий необходимы соответствующие штатные модули Битрикса.
- Активная очередь ограничена 10 000 доставок. Одно событие, направленное в несколько каналов, создаёт несколько доставок. При переполнении новое событие отклоняется целиком.
- Срок актуальности доставки — 48 часов с момента постановки в очередь. После его истечения уведомление не отправляется и не может быть повторено вручную.
- Автоматическая отправка прекращается после 10 неудачных попыток либо по истечении срока актуальности.
- Завершённая история хранится за текущий день по часовому поясу сервера сайта. Старые завершённые записи удаляются при работе агента очистки; журнал не предназначен для длительного архивного хранения.
- Статус SENT означает, что Депешер принял запрос. Получение уведомления конечным адресатом необходимо проверять в Депешере. При повторных запросах возможны дубли уведомлений.
- Событие импорта каталога отслеживает штатное завершение обмена.
Модуль передаёт код события, время, идентификатор установки, идентификатор сайта при его наличии, название источника, окружение и данные конкретного события. Встроенные обработчики передают идентификаторы объектов и необходимые сведения об изменении; события инфоблоков также содержат название, символьный код и активность элемента. В HTTP-заголовке передаются версия модуля, версия и определённая модулем редакция Битрикса.
Встроенные обработчики не передают логины, имена, фамилии, email и телефоны пользователей, свойства заказов, ответы веб-форм, пароли, cookie, содержимое сессий или лицензионные ключи Битрикса. Не размещайте персональные данные в названиях элементов инфоблоков, подписи источника и других передаваемых полях. Состав данных пользовательских PHP-событий определяет разработчик интеграции.
Подготовьте канал в сервисе Депешер, настройте получателей уведомлений и скопируйте HTTPS webhook канала. Если для канала используется Bearer-токен, подготовьте его для ввода в настройках подключения.
2. Установите модульВойдите в административный раздел сайта с правами администратора. В разделе «Marketplace → Установленные решения» установите решение «Уведомления Депешер» (lakbor.depesher). После установки в разделе «Сервисы» появится меню «Депешер».
3. Настройте фоновые заданияНастройте регулярный запуск агентов Битрикса через cron раз в минуту и отключите их выполнение на посещениях сайта. Это необходимо для отправки уведомлений и очистки истории. Настройку выполняет администратор сервера или специалист хостинга; используйте штатный способ запуска агентов вашей установки Битрикса.
Модуль не меняет глобальные настройки запуска агентов автоматически. На странице «Сервисы → Депешер → Состояние» можно проверить время последнего запуска и завершения обработчика, размер очереди и число отклонённых уведомлений.
4. Задайте источник уведомленийОткройте «Настройки → Настройки продукта → Настройки модулей → Уведомления Депешер».
- Название источника — подпись сайта в отправляемых событиях, например «Основной интернет-магазин». Поле необязательно.
- Окружение — production для рабочего сайта, staging для тестового или development для разработки.
- Идентификатор установки — автоматически созданный идентификатор источника; отображается для диагностики.
Сохраните настройки.
5. Добавьте каналОткройте «Сервисы → Депешер → Каналы Депешер» и нажмите «Добавить канал». Укажите название, включите активность и вставьте webhook вида https://depesher.ru/w/{public_id}. При необходимости укажите Bearer-токен. Сохраните канал.
Токен хранится в зашифрованном виде и после сохранения полностью не отображается. При редактировании оставьте поле токена пустым, чтобы сохранить прежнее значение.
6. Выберите события и создайте правилаВ разделе «Сервисы → Депешер → Каталог событий» проверьте доступность нужных событий. При необходимости объедините несколько доступных событий в разделе «Группы событий».
Откройте «Сервисы → Депешер → Правила», создайте правило и заполните параметры:
- Название и Активно — название правила и включение отправки по нему.
- Тип цели — отдельное событие или группа событий.
- Событие / Группа — какие события отправлять.
- Канал Депешер — куда направлять события.
- Сайты — ограничение по сайтам; пустой выбор означает все сайты и события без определённого сайта.
- Инфоблоки — обязательный выбор для событий инфоблоков.
- Веб-формы — обязательный выбор для событий веб-форм.
- Статусы заказов — отбор для события изменения статуса; пустой выбор означает все статусы.
Доступные условия зависят от выбранного события или состава группы. Для выбора инфоблоков и веб-форм используйте кнопку «Выбрать…»; можно найти сущность по названию и выбрать несколько значений. Сохраните правило. Чтобы направлять одно событие в несколько каналов, создайте отдельное правило для каждого канала.
7. Проверьте отправкуВ списке каналов выберите действие «Тестовая отправка». Уведомление будет поставлено в очередь. После запуска обработчика откройте «Сервисы → Депешер → Журнал доставок» и проверьте результат. В карточке доставки доступны данные события и история попыток.
Убедитесь, что запрос принят Депешером и уведомление получено адресатом. Затем вызовите нужное событие сайта и проверьте срабатывание созданного правила: тестовая отправка канала проверяет подключение, но не заменяет проверку правила.
Пользовательские событияРазработчик может подключить собственные события через класс Lakbor\Depesher\Notify: сначала зарегистрировать событие методом registerEvent(), затем отправлять его методом publish(). После регистрации событие выбирается в каталоге, группах и правилах наравне со встроенными. Метод публикации ставит событие в очередь; канал назначения задаётся администратором через правила.
УдалениеУдаление выполняется в разделе «Marketplace → Установленные решения». Во время удаления можно сохранить данные и настройки для повторной установки. Полное удаление уничтожает таблицы модуля, настройки и реквизиты подключения.
По вопросам работы модуля пишите на support@depesher.ru.
Обращения принимаются по email в любое время. Поддержка отвечает без фиксированного графика; срок ответа на обращение — от 1 до 2 суток. Мгновенный ответ и постоянное присутствие специалиста не предусмотрены.
В обращении укажите версию модуля, редакцию и версию Битрикса, версию PHP, последовательность действий и текст ошибки.
Не отправляйте пароли, Bearer-токены, полные webhook-адреса и лицензионные ключи Битрикса.
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
