Возьмите один production-запрос и найдите его у SMS-провайдера по Verification SID или Message SID. Если объекта нет, проблема до провайдера: неверные credentials, Service SID, environment variables или код не вызвал live API. Если объект есть, продолжайте по status и error code, не создавая новый OTP.

Тестовый успех может быть полностью синтетическим. Twilio прямо пишет, что test credentials не соединяются с реальными телефонами, не меняют production resources и не вызывают status callbacks. Поэтому unit-тест проверяет контракт приложения, но не sender, маршрут, страну, регистрацию и доставку оператора.

Один идентификатор сужает поиск до слоя

Что найденоГде разрывСледующая проверка
Нет локального request IDUI/rate limit/валидацияОтвет endpoint и audit event
Есть request ID, нет provider SIDCredentials, сеть или Service SIDAPI response и account/environment
SID создан, status pendingМаршрут ещё обрабатываетсяSend attempts и возраст
Provider failed/undeliveredPermission, sender, carrier или номерТочный error code
Delivered, пользователь не видитУстройство, фильтр, задержка или неверный номерMasked destination и carrier trace

Production-конфигурация проверяется отдельно от кода

  • Live Account/API key относится к тому же account или subaccount, где создан Verify Service.
  • Service SID взят из production и канал SMS включён для нужного сценария.
  • Номер нормализован в E.164 до запроса, а не склеен из локальной маски.
  • Страна назначения разрешена в Geo Permissions и поддерживается выбранным каналом.
  • Sender type зарегистрирован там, где это требуется правилами страны и оператора.

Twilio использует country code номера назначения для Messaging Geo Permissions и возвращает ошибку 21408, когда регион отключён или канал его не поддерживает. Включать все страны ради устранения ошибки небезопасно: разрешите только реальные рынки после проверки локальных требований и защиты от SMS pumping.

Лог хранит маршрут, но не код

{
  "request_id": "otp_demo_b71",
  "provider_sid": "VE_redacted",
  "service": "verify-prod",
  "country": "DE",
  "channel": "sms",
  "status": "pending",
  "error_code": null,
  "attempt": 1
}

Не записывайте OTP, полный номер телефона, Auth Token или текст сообщения. Для корреляции достаточно внутреннего ID, provider SID, маскированного destination, страны, статуса и error code. Ограничьте доступ и retention: даже технический лог содержит данные об аутентификации пользователя.

Повторная отправка не должна создавать шторм

Кнопка «Отправить ещё раз» сначала читает состояние текущей verification и применяет cooldown. Новый код может инвалидировать старый или запутать пользователя, а частые попытки ухудшают deliverability и увеличивают стоимость. Rate limit ставится на account/user, destination и device signals, а не только на IP офиса.

Если SMS задерживается, предложите заранее спроектированный fallback — голос, email, TOTP или другой поддерживаемый канал — после проверки риска. Нельзя принимать статический код «для production» или отключать проверку только потому, что carrier route временно недоступен.

Canary использует реальный маршрут безопасно

  1. Выбрать разрешённый тестовый номер для каждой production-страны и оператора.
  2. Создать verification через тот же service и deployment, что обслуживает пользователей.
  3. Записать время API accepted, provider status и фактической доставки без OTP content.
  4. Проверить status callback или polling и алерт на рост failed/undelivered.
  5. Повторить после изменения sender/permissions и сравнить точный error distribution.

Twilio рекомендует начинать расследование с Messaging logs и Message resource: если записи нет, запрос не дошёл; если есть — error code показывает дальнейший путь. Это эффективнее, чем менять текст, sender и retries одновременно.

Материалы для точного разбора

Подготовьте provider SID, timestamps, masked destination, country/carrier, Service SID в усечённом виде, sender type, status/error и deploy version. Не присылайте сам код, полный номер или credentials. Такой набор отделяет ошибку приложения от account permission, провайдера и оператора.

Проверенные источники