# Как доставлять OTP и коды подтверждения

> Формат сообщения, срок действия, повторные попытки, резервные сценарии и ограничения частоты запросов для одноразовых кодов.

Обновлено 2026-08-26. Уровень: Продвинутый. Автор: SMSMeteor.

## Главное

- Сначала укажите бренд, затем код; не добавляйте ссылки.
- Установите срок действия кода вместо стандартных 48 часов.
- Пометьте транзакционный трафик, чтобы снять ограничения по времени отправки.
- Ограничивайте частоту запросов по номеру, IP-адресу и аккаунту.

## Сообщение

Сначала бренд, затем код и только необходимые сведения: ACME: ваш код 493 201. Срок действия — 10 минут. Уложите текст в один сегмент GSM-7. Не добавляйте ссылки: операторы особенно строго фильтруют сообщения с кодами и ссылками. Размещайте код ближе к началу, чтобы он был виден в уведомлении.

## Настройки API

Пометьте транзакционный трафик параметром `"window": { "quiet_hours": "bypass" }`, чтобы отправлять его круглосуточно. Установите `validity` равным сроку действия кода, например 10 минутам, вместо стандартных 48 часов: просроченный код не должен приходить пользователю. Формируйте `Idempotency-Key` из идентификатора пользователя и номера попытки, чтобы повтор запроса с вашей стороны не отправил второй код.

## Логика повторной отправки

Разрешайте запросить новый код через 30 секунд, затем через 60 и 120 секунд. При выпуске нового кода делайте предыдущий недействительным. Если вебхук сообщает `message.failed` из-за неизвестного номера, предложите пользователю проверить номер, а не отправляйте ещё одно сообщение.

## Защита конечной точки

Конечная точка без ограничений позволяет злоумышленнику быстро израсходовать ваш баланс. Ограничивайте частоту по номеру, IP-адресу и аккаунту, после второго запроса требуйте пройти проверку и блокируйте направления, которые не обслуживаете. API бесплатно отклоняет неподдерживаемые префиксы, но поток запросов на действительные номера оплачивается.

## Что измерять

Измеряйте по каждому направлению долю отправленных кодов, которые пользователи затем ввели. Этот показатель полезнее отчёта о доставке: он учитывает телефон, уведомление и действия пользователя. Направление, где конверсия на десять процентных пунктов ниже остальных, требует проверки.

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