Код не приходит в режиме «Под ключ»

Причина: интеграция в статусе Черновик или Заблокированный. Решение: Откройте 2FA Service → 2FA SMS. Проверьте статус — должен быть Активный. Если статус другой — активируйте интеграцию. Как редактировать 2FA-интеграцию →

OTP: код не приходит

Q: Неверный номер в запросе

Причина: номер получателя указан неверно или без кода страны. Решение: проверьте номер. Формат — с кодом страны, без «+». Проверьте через HLR. HLR-проверка →

Q: Отписка контакта

Причина: получатель ранее отправил команду отписки. Решение: проверьте команды отписки в разделе Контакты → Команды отписки.

Q: Блокировка FMS

Причина: Fraud Management System определила активность как подозрительную. Решение: обратитесь в поддержку сервиса с ID рассылки и временем. Как работает FMS →

Q: Имя отправителя не активно

Причина: имя отправителя не имеет статуса Активно. Решение: дождитесь одобрения или проверьте причину отклонения.

Q: Превышен лимит запросов

Причина: более 5 одновременных запросов на один канал. Решение: уменьшите частоту, используйте очередь. Ошибка 429 →

Q: Ошибка оператора

Причина: техническая ошибка на стороне оператора связи. Решение: повторите отправку через 1–2 часа. Если повторяется — обратитесь в поддержку. Ошибки по операторам →

Q: Каскад не переключается на следующий канал

Причина: статус, указанный в successOn, уже наступил — например, sent, а вы ждали delivered. Решение: явно укажите successOn: "delivered" для каждого сообщения каскада.

Q: Код в EDR виден как ******

Причина: это нормальное поведение при isOtp: true. Код маскируется в EDR. Решение: ничего делать не нужно. Получателю код отправлен в открытом виде, в EDR — маска. Подробнее о isOtp →

Коротко: если код верификации не доходит, проверьте канал, EDR, статус имени отправителя и возможные блокировки.

Кому подходит

Роль: Клиент, Разработчик, Интегратор
Уровень: Новичок / Опытный

Симптом

Пользователь не получает код верификации.

Пошаговая диагностика

Проверьте EDR

Откройте Статистика → Записи сообщений (EDR).
Найдите код по номеру получателя.
Проверьте статус.

Статус	Что означает
Доставлено	Код дошёл до получателя
Отправлено	Код ушёл провайдеру, но не доставлен
Неуспешно	Код не доставлен

Записи сообщений (EDR) по OTP →

Проверьте канал

Для каждого канала — свои требования:

Канал	Что проверить
SMS	Длина текста, оператор
RCS	Поддержка оператором
Viber	Настройки сессии, активное окно 24 часа
WhatsApp	Шаблон одобрен, окно 24 часа
TTS	Язык, количество повторов
FlashCall	Настройки `code`, `dial_timeout`
Email	Домен верифицирован
Telegram Gateway	Настройки `ttl`, `code_length`
Mobile Push	Приложение подключено

Форматы payload по каналам →

Проверьте имя отправителя

Откройте Активы → Имена отправителей.
Убедитесь, что статус Активно.

Использовать можно только имя со статусом Активно. Если статус другой — дождитесь одобрения.

Через API: проверьте имена и их статусы через GET /senders.

Как зарегистрировать имя отправителя →

Проверьте баланс

Откройте Финансовые документы → Платежи.
Проверьте, что баланс положительный.

Через API: проверьте баланс через GET /balance.

Как пополнить баланс →

Проверьте лимиты

На один канал действует ограничение — не более 5 одновременных запросов на отправку.

Симптом: API возвращает 429 Too Many Requests.

Решение:

Уменьшите частоту запросов.
Используйте очередь.
Если лимит критично низкий — обратитесь в поддержку.

Ошибка 429 →

Проверьте блокировку FMS

Fraud Management System может автоматически заблокировать отправку кодов.

Признак: коды не доходят массово, в EDR — пусто.

Решение: обратитесь в поддержку сервиса.

Как работает FMS →

Проверка по режимам работы

Платформа сама генерирует и проверяет код. Вам нужно проверить:

2FA-интеграция активна. Откройте 2FA Service → 2FA SMS. Статус должен быть Активный.
Генерация на стороне платформы. В настройках 2FA-интеграции проверьте поле Генерация и проверка кода — должно быть На стороне платформы.
Период валидности кода не истёк. Проверьте поле Период валидности кода — максимум 600 секунд.
Код не отозван. Если пользователь запросил новый код — старый отзывается автоматически.
Превышено 3 попытки ввода. Действует 10-минутный перерыв.