Уведомления от оборудования и IoT

Депешер принимает события от оборудования по HTTP и доставляет уведомления людям. Это подходит для перегрева, протечки, отказа насоса, восстановления питания или завершения задания.

Измерения и обнаружение события выполняет устройство, контроллер, шлюз или внешняя автоматизация. Депешер получает готовое событие, выбирает оформление и получателей и сохраняет сообщение.

Датчик → устройство или автоматизация определяет событие
→ HTTP POST с текстом или JSON → входящий канал Депешера
→ правила и шаблон → личная история и выбранная доставка

Выберите путь подключения

Источник	Как передать событие
Устройство с HTTPS-клиентом	POST непосредственно в публичный адрес канала
Программа на Linux или Raspberry Pi	HTTP-запрос из программы или скрипта; для текста можно использовать CLI
Система автоматизации	Её HTTP-действие формирует тело и отправляет запрос после определения события
MQTT-датчик или устройство без HTTPS	Внешний шлюз или подписчик преобразует событие в HTTP-запрос

MQTT требует внешнего моста; входящий канал Депешера принимает HTTP. Раздел «Устройства» в ЛК относится к приложениям доставки вроде Depesher Desktop: регистрировать там датчик для отправки HTTP не требуется.

Подготовьте канал

1. Создайте личный входящий канал и выберите способы получения. Если событие нужно коллегам, создайте организационный канал и настройте «Мою доставку» сотрудников.
2. Создайте текстовый шаблон в том же контексте и выберите его у канала:

Объект: {{json.site.name}}
Устройство: {{json.device.id}}
Событие: {{json.event.type}}
Значение: {{json.measurement.value}} {{json.measurement.unit}}

3. При необходимости включите защиту токеном. Сохраните токен в настройках устройства или шлюза и передавайте его в заголовке Authorization: Bearer ВАШ_ТОКЕН.
4. Укажите в источнике скопированный адрес канала и Content-Type: application/json.

Используйте HTTPS для публичного адреса и храните URL и токен вне открытого кода и журналов.

Отправьте первое событие

Это пример формата для вашей интеграции; имена полей выбирает отправитель. Замените адрес своим:

curl --include \
  --request POST \
  --header 'Content-Type: application/json' \
  --data-binary '{
    "site": {"name": "Склад №1"},
    "device": {"id": "sensor-03"},
    "event": {"type": "temperature_high"},
    "measurement": {"value": 12.5, "unit": "°C"}
  }' \
  'https://depesher.ru/w/ВАШ_PUBLIC_ID'

Для защищённого канала добавьте Bearer-заголовок. После HTTP 202 проверьте историю и фактическое получение. Ожидаемый текст:

Объект: Склад №1
Устройство: sensor-03
Событие: temperature_high
Значение: 12.5 °C

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

Различайте аварии и восстановление

Источник может присылать разные event.type; правила обработки зададут им разные метки, важность и получателей. Начните с готового рецепта «IoT: Перегрев и восстановление температуры».

В правилах нет сравнения измерения с числовым порогом. Отправитель определяет переход через порог, момент восстановления и ограничение повторов. Передача каждого измерения отдельным запросом создаёт отдельные сообщения.

Авария и восстановление остаются двумя событиями. Депешер не объединяет их автоматически в состояние инцидента и не создаёт событие при молчании датчика. Подтверждение доставки не означает, что инженер взял сообщение в работу.

Готовые подключения

• Home Assistant — протечка и восстановление через REST-команду.
• Node-RED и MQTT — внешний мост события в HTTP.
• ESP32 с ESPHome — прямой HTTPS POST и тестовая кнопка.
• Raspberry Pi и Linux — отправитель JSON на Python.
• Сервисные объекты — разные команды по объекту и событию.

Ответы и ограничения общего приёма собраны в HTTP-справке.