Возьмите один 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 ID | UI/rate limit/валидация | Ответ endpoint и audit event |
| Есть request ID, нет provider SID | Credentials, сеть или Service SID | API response и account/environment |
| SID создан, status pending | Маршрут ещё обрабатывается | Send attempts и возраст |
| Provider failed/undelivered | Permission, 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 использует реальный маршрут безопасно
- Выбрать разрешённый тестовый номер для каждой production-страны и оператора.
- Создать verification через тот же service и deployment, что обслуживает пользователей.
- Записать время API accepted, provider status и фактической доставки без OTP content.
- Проверить status callback или polling и алерт на рост failed/undelivered.
- Повторить после изменения 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, провайдера и оператора.