01Вкратце
Для каждого события во внутренней системе отправьте запрос POST /v1/messages. Добавьте тег campaign, например shipping, собственную ссылку в reference, например номер заказа, и отметьте сообщение как транзакционное, чтобы ограничения по времени отправки не задерживали его. События доставки приходят на вебхук с той же ссылкой, поэтому система заказов может зафиксировать, что клиент уведомлён.
- Тип трафика
- Транзакционный
- Вызов API
POST /v1/messagesдля каждого события или/batchдля ночной пакетной отправки- Отслеживание
referenceпередаётся в ответах и вебхуках- Группировка
- Тег
campaignдля каждого типа уведомлений - Длина
- Один или два сегмента; при необходимости ссылка на ваш домен
- История
- Отчёты по сообщениям хранятся 90 дней
Рекомендуемые настройки
02Как это работает
От запроса до доставки — 4 шага.
-
01Зафиксируйте событие
Когда система помечает заказ как отправленный или платёж как полученный, вызовите API. Используйте номер заказа в поле <code>reference</code> и в ключе идемпотентности.
-
02Составьте шаблон
Бренд, факт и следующий шаг: «ACME: заказ 4821 отправлен. Отследить: acme.com/t/8fK2». По возможности уложитесь в один сегмент GSM-7.
-
03Запишите результат
Сохраните рядом с заказом статус <code>delivered</code> или <code>failed</code>. Причина «неизвестный номер» указывает на неверные контактные данные клиента.
-
04Анализируйте по типам
Тег кампании группирует уведомления о доставке, чеки и предупреждения в отчётах, поэтому снижение показателей отдельного типа сразу заметно.
03Что важно
Каким должно быть транзакционное сообщение
Уведомление считается транзакционным, когда клиент ожидает его после своего действия. Оно сообщает факт и при необходимости ведёт к подробностям. Рекламное предложение превращает его в маркетинговое сообщение, для которого нужны согласие и соблюдение ограничений по времени. Разделите эти потоки: используйте разные шаблоны и теги кампаний.
Ставьте ссылки на собственный домен. Публичные сокращатели ссылок чаще попадают под фильтры и скрывают знакомый клиенту бренд.
04На практике
Надёжная отправка на вашей стороне
Формируйте Idempotency-Key из события, например order-4821-shipped. Если задача завершится с ошибкой и будет запущена повторно, API вернёт первоначальный ответ, а клиент получит одно сообщение. Повторяйте ответы 429 и 5xx с увеличивающейся задержкой; остальные ошибки 4xx требуют исправления запроса.
Для ночных задач, например напоминаний об оплате, пакетный метод принимает до 1000 сообщений в одном запросе API сообщений и возвращает причину отклонения каждой строки. Один неверный номер не останавливает весь пакет.
05Сколько это стоит
5 000 сообщений с разбивкой стоимости по направлениям.
Расчёт для одного сегмента по текущим опубликованным тарифам. Цена за сообщение одинакова для первого и миллионного сообщения; тарифного плана, платы за подключение и абонентской платы нет.
Тарифная таблица обновлена 22 сентября 2026
| Направление | Тариф за SMS | 5 000 сообщений |
|---|---|---|
 США | $0,0084 | $42,00 |
 Великобритания | $0,0130 | $65,00 |
 Германия | $0,0238 | $119,00 |
 Франция | $0,0205 | $102,50 |
 Бразилия | $0,0042 | $21,00 |
 Индия | $0,0256 | $128,00 |
Другие направления: калькулятор стоимости
06Пример сообщения
Как оно выглядит на телефоне и в запросе.
Факт, дата и ссылка на собственный домен в одном сегменте.
curl https://api.smsmeteor.com/v1/messages \
-H "Authorization: Bearer $SMSMETEOR_KEY" \
-H "Idempotency-Key: order-4821-shipped" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"from": "ACME",
"text": "ACME: заказ 4821 отправлен и прибудет в четверг. Отследить: acme.com/t/8fK2",
"window": { "quiet_hours": "bypass" },
"campaign": "shipping",
"reference": "order-4821"
}'07Типичные ошибки
Три ошибки, которые мы видим, и как их избежать.
Реклама внутри чека
Такое сообщение становится маркетинговым. Отправляйте предложения отдельной кампанией, получив согласие и соблюдая ограничения по времени.
Публичные сокращатели ссылок
Операторы связи часто фильтруют такие ссылки. Короткий адрес на собственном домене занимает столько же символов.
Нет собственной ссылки
Без поля
referenceсобытие доставки нельзя однозначно связать с заказом, который его вызвал.
09Вопросы, ответы
SMS-уведомления о заказах, платежах и счетах: вопросы и ответы.
Требуется ли согласие на получение уведомлений о транзакциях?
Они вытекают из отношений с клиентом: подтверждение заказа или предупреждение о безопасности не требуют маркетингового согласия. Добавление рекламного контента меняет ситуацию, поэтому держите уведомления исключительно информационными.
Можно ли отправлять уведомления ночью?
Да, если для window.quiet_hours задан режим bypass. Используйте его только для сообщений, которых ожидает клиент. Отправка рекламы в таком режиме нарушает правила допустимого использования.
Как узнать, получил ли клиент сообщение?
Зарегистрируйте вебхук: события message.delivered и message.failed содержат вашу ссылку, а при ошибке — причину от оператора связи. Если направление поддерживает только подтверждение отправки, окончательным положительным статусом будет sent; это указано на странице направления.
Что, если одно и то же событие будет обработано дважды?
Отправьте тот же ключ идемпотентности, и API вернет исходный ответ без повторной отправки в течение 24 часов.
Можно ли отправлять уведомления в разные страны из одной интеграции?
Да. Направление определяется по номеру, стоимость рассчитывается по его опубликованному тарифу, а имя отправителя проверяется по местным правилам. Код интеграции остаётся тем же.
Есть ли минимальный объём?
Нет. Одно уведомление стоит одно сообщение по опубликованному тарифу. Нет никакой ежемесячной платы и никакого договора.