# Оперативные оповещения и уведомления об инцидентах

> Отправляйте по SMS сигналы мониторинга, вызовы дежурных и уведомления о сбоях. Достаточно одного вызова REST из системы оповещений; транзакционный режим и вебхуки доставки уже предусмотрены.

Чтобы отправлять оперативные оповещения через SMSMeteor, настройте в системе мониторинга обычный вебхук на `POST /v1/messages`. Отмечайте сообщение как транзакционное для немедленной отправки в любое время, задавайте короткий срок действия для удаления устаревших сигналов и формируйте ключ идемпотентности из идентификатора инцидента, чтобы повторное срабатывание не создавало дубль. Уведомления клиентам отправляйте пакетом по списку затронутых пользователей и ограничивайте скорость, если ответы принимает небольшая команда поддержки.

## Рекомендуемые настройки

- Тип трафика: Транзакционный
- Интеграция: Обычный вебхук из системы мониторинга вызывает REST API
- Защита от дублей: `Idempotency-Key` формируется из идентификатора оповещения
- Срок действия: От 15 до 60 минут
- Пакетная отправка: `/v1/messages/batch`, 1000 сообщений в одном запросе API
- Работает без: Мобильного интернета, приложения и push-токенов

## Шаги

1. Добавьте вебхук: Большинство систем мониторинга умеет отправлять POST с JSON и заданными заголовками. Направьте такой запрос в метод отправки сообщений и добавьте свой ключ API.
2. Уберите дубли: Используйте идентификатор оповещения или инцидента как ключ идемпотентности. Тогда нестабильная проверка отправит одно SMS на инцидент, а не по сообщению при каждом изменении состояния.
3. Удаляйте устаревшие оповещения: Задайте срок действия, пока оповещение ещё полезно. Вызов, пришедший через три часа, только создаёт шум.
4. Настройте эскалацию: Сначала вызовите основного дежурного. Если система не получила подтверждение, вторым сообщением предупредите резервного.

## Почему для оповещений подходит SMS

Push-уведомлению нужны работающее приложение, действующий токен, мобильный интернет и разрешённые уведомления. Электронную почту кто-то должен вовремя заметить. Для SMS достаточно сигнала сотовой сети. Когда нужно разбудить дежурного или предупредить клиента без доступа к интернету, у SMS меньше всего внешних зависимостей.

Пишите кратко и по структуре: система, уровень критичности, событие и ссылка на инструкции. На экране блокировки видны прежде всего первые сорок символов.

## Уведомления об инцидентах, связанных с клиентом

Когда сбой затрагивает клиентов, короткое текстовое сообщение в затронутом списке предотвращает волну заявок. Отправьте его пакетом с тегом кампании для каждого инцидента, задайте темп, если ваша линия поддержки невелика, и следите за разрешением. Это служебные сообщения: никаких предложений, никаких ссылок ни на что, кроме вашей страницы статуса.

## Пример сообщения

От OPSALERT: "PROD db-eu-2 КРИТИЧЕСКИЙ: задержка репликации 340 с (порог 60 с). Инструкция: ops.acme.com/r/db-lag"

```bash
curl https://api.smsmeteor.com/v1/messages \
  -H "Authorization: Bearer $SMSMETEOR_KEY" \
  -H "Idempotency-Key: incident-2291-page-primary" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+4915112345678",
    "from": "OPSALERT",
    "text": "PROD db-eu-2 КРИТИЧЕСКИЙ: задержка репликации 340 с. Инструкция: ops.acme.com/r/db-lag",
    "validity": 30,
    "window": { "quiet_hours": "bypass" },
    "campaign": "oncall"
  }'
```

## Вопросы

**Может ли система мониторинга отправлять SMS через API?** Да, если она умеет отправлять POST с JSON и настраиваемыми заголовками. Направьте вебхук на /v1/messages и передайте токен доступа. Плагин или SDK не требуется.

**Будут ли оповещения отправляться ночью?** Да. Отметьте сообщение как транзакционное и задайте для window.quiet_hours значение bypass. Оповещение отправится сразу в любое время.

**Как избежать дублей при нестабильной проверке?** Сформируйте ключ идемпотентности из идентификатора инцидента. Повторные запросы с тем же ключом в течение 24 часов вернут исходный ответ без новой отправки.

**Что произойдёт, если телефон выключен?** Оператор связи повторяет попытки, пока не истечёт срок действия. Установите короткий срок действия, чтобы устаревшее оповещение удалялось, а не доставлялось через несколько часов.

**Можно ли уведомить клиентов о сбое?** Да. Отправьте пакет сообщений затронутым пользователям и при необходимости ограничьте скорость. Оставьте текст служебным: что не работает и где следить за обновлениями.

**Как не допустить исчерпания баланса?** Задайте порог низкого баланса: вебхук balance.low сработает при его достижении. Система мониторинга также может регулярно опрашивать метод баланса.



---
Источник: https://smsmeteor.com/ru/use-cases/alerts-and-incidents (HTML). Создано SMSMeteor на основе тех же данных, что и страница. Сводка всего сайта: https://smsmeteor.com/ru/llms.txt