01Вкратце
Чтобы отправлять оперативные оповещения через SMSMeteor, настройте в системе мониторинга обычный вебхук на POST /v1/messages. Отмечайте сообщение как транзакционное для немедленной отправки в любое время, задавайте короткий срок действия для удаления устаревших сигналов и формируйте ключ идемпотентности из идентификатора инцидента, чтобы повторное срабатывание не создавало дубль. Уведомления клиентам отправляйте пакетом по списку затронутых пользователей и ограничивайте скорость, если ответы принимает небольшая команда поддержки.
- Тип трафика
- Транзакционный
- Интеграция
- Обычный вебхук из системы мониторинга вызывает REST API
- Защита от дублей
Idempotency-Keyформируется из идентификатора оповещения- Срок действия
- От 15 до 60 минут
- Пакетная отправка
/v1/messages/batch, 1000 сообщений в одном запросе API- Работает без
- Мобильного интернета, приложения и push-токенов
Рекомендуемые настройки
02Как это работает
От запроса до доставки — 4 шага.
-
01Добавьте вебхук
Большинство систем мониторинга умеет отправлять POST с JSON и заданными заголовками. Направьте такой запрос в метод отправки сообщений и добавьте свой ключ API.
-
02Уберите дубли
Используйте идентификатор оповещения или инцидента как ключ идемпотентности. Тогда нестабильная проверка отправит одно SMS на инцидент, а не по сообщению при каждом изменении состояния.
-
03Удаляйте устаревшие оповещения
Задайте срок действия, пока оповещение ещё полезно. Вызов, пришедший через три часа, только создаёт шум.
-
04Настройте эскалацию
Сначала вызовите основного дежурного. Если система не получила подтверждение, вторым сообщением предупредите резервного.
03Что важно
Почему для оповещений подходит SMS
Push-уведомлению нужны работающее приложение, действующий токен, мобильный интернет и разрешённые уведомления. Электронную почту кто-то должен вовремя заметить. Для SMS достаточно сигнала сотовой сети. Когда нужно разбудить дежурного или предупредить клиента без доступа к интернету, у SMS меньше всего внешних зависимостей.
Пишите кратко и по структуре: система, уровень критичности, событие и ссылка на инструкции. На экране блокировки видны прежде всего первые сорок символов.
04На практике
Уведомления об инцидентах, связанных с клиентом
Когда сбой затрагивает клиентов, короткое текстовое сообщение в затронутом списке предотвращает волну заявок. Отправьте его пакетом с тегом кампании для каждого инцидента, задайте темп, если ваша линия поддержки невелика, и следите за разрешением. Это служебные сообщения: никаких предложений, никаких ссылок ни на что, кроме вашей страницы статуса.
05Сколько это стоит
1 000 сообщений с разбивкой стоимости по направлениям.
Расчёт для одного сегмента по текущим опубликованным тарифам. Цена за сообщение одинакова для первого и миллионного сообщения; тарифного плана, платы за подключение и абонентской платы нет.
Тарифная таблица обновлена 22 сентября 2026
| Направление | Тариф за SMS | 1 000 сообщений |
|---|---|---|
| $0,0084 | $8,40 | |
| $0,0130 | $13,00 | |
| $0,0238 | $23,80 | |
| $0,0256 | $25,60 | |
| $0,0084 | $8,40 | |
| $0,0298 | $29,80 |
Другие направления: калькулятор стоимости
06Пример сообщения
Как оно выглядит на телефоне и в запросе.
Система, уровень критичности, событие и ссылка на инструкцию.
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"
}'07Типичные ошибки
Три ошибки, которые мы видим, и как их избежать.
SMS при каждом результате проверки
Нестабильная проверка может отправить десятки сообщений. Привязывайте ключ идемпотентности к инциденту, а не к отдельной проверке.
Пустой баланс во время инцидента
Настройте вебхук о низком балансе, чтобы канал оповещений не остановился в критический момент.
Слишком длинные оповещения
Трассировке стека не место в SMS. Дайте краткое описание и ссылку на инструкцию или карточку инцидента.
09Вопросы, ответы
Оперативные оповещения и уведомления об инцидентах: вопросы и ответы.
Может ли система мониторинга отправлять SMS через API?
Да, если она умеет отправлять POST с JSON и настраиваемыми заголовками. Направьте вебхук на /v1/messages и передайте токен доступа. Плагин или SDK не требуется.
Будут ли оповещения отправляться ночью?
Да. Отметьте сообщение как транзакционное и задайте для window.quiet_hours значение bypass. Оповещение отправится сразу в любое время.
Как избежать дублей при нестабильной проверке?
Сформируйте ключ идемпотентности из идентификатора инцидента. Повторные запросы с тем же ключом в течение 24 часов вернут исходный ответ без новой отправки.
Что произойдёт, если телефон выключен?
Оператор связи повторяет попытки, пока не истечёт срок действия. Установите короткий срок действия, чтобы устаревшее оповещение удалялось, а не доставлялось через несколько часов.
Можно ли уведомить клиентов о сбое?
Да. Отправьте пакет сообщений затронутым пользователям и при необходимости ограничьте скорость. Оставьте текст служебным: что не работает и где следить за обновлениями.
Как не допустить исчерпания баланса?
Задайте порог низкого баланса: вебхук <code>balance.low</code> сработает при его достижении. Система мониторинга также может регулярно опрашивать метод баланса.
