Как выбрать маршрут +55 для SMS-верификации в Бразилии

Что выбрать для бразильского теста: OTP Gateway или долгосрочную линию?

Начните с формы задачи, ведь именно она определяет продукт. Бразильскому тесту верификации обычно нужен один код один раз: экран регистрации на португальском, проверка при входе, шаг смены телефона. Для этого и создан OTP Gateway. Вы выбираете сервис и Бразилию, получаете номер +55 для одного кода, а активация закрывается через 20 минут или когда приходит SMS.

Долгосрочная линия — другая история. Dedicated Numbers — продукт для США и Канады, продаётся мгновенно из панели от $1.95 в месяц и включает входящие SMS, исходящие SMS и звонки из браузера. Самостоятельно оформить долгосрочный номер +55 нельзя. Если вашей команде действительно нужна бразильская линия, которую можно сохранить, напишите на [email protected] и опишите сценарий; возможность зависит от местных правил, и ничего не обещается.

Короткое практическое правило:

• Один код на тест-кейс, чистое состояние при каждом прогоне: OTP Gateway с br.
• Тестовый аккаунт, в который нужно будет войти снова в следующем месяце: Dedicated Number США или Канады, если сервис его принимает.
• Сомневаетесь: прочитайте временные и выделенные номера, прежде чем что-либо покупать.

Какие приложения могут прямо сейчас отправлять коды на бразильский номер?

Маршрут Бразилии сейчас охватывает более 2 900 сервисов, а популярные в актуальном срезе — это WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee и AliExpress.

Считайте этот список срезом, а не обязательством. Доступность меняется в течение дня, пока наши операторы-партнёры добавляют и меняют маршруты, поэтому конвейеру стоит спрашивать API, а не доверять жёстко заданному списку. Каталог стран показывает те же актуальные данные для тех, кто предпочитает браузер.

Как на практике выглядит последовательность вызовов OTP API для Бразилии?

Каждый вызов идёт на https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_, созданным в консоли разработчика. Идентификатор страны для Бразилии — br.

1. Один раз получите идентификаторы сервисов через GET /api/v1/services и храните их в конфигурации.
2. Перед заказом вызовите GET /api/v1/prices?country=br&service=whatsapp (или ваш идентификатор сервиса). В ответе придут актуальные цена и доступность для этой пары.
3. Создайте активацию через POST /api/v1/activations с телом {"service": "whatsapp", "country": "br"}. Сохраните идентификатор активации рядом с тестовым прогоном.
4. Введите номер +55 в тестируемый сценарий.
5. Слушайте событие activation.sms_received на вебхуке; как запасной вариант проверяйте GET /api/v1/activations/{id} раз в несколько секунд.
6. Если тест прерван, освободите номер через POST /api/v1/activations/{id}/cancel, и средства вернутся сразу.

Доставки вебхука подписаны в X-OTPRoute-Signature как t=<unix>,v1=<hex>: это HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта. Проверяйте подпись, отбрасывайте устаревшие метки времени и делайте обработчик идемпотентным по идентификатору активации. Полный справочник находится в документации API.

Может ли сотрудник отдела роста сделать это без кода?

Да. Панель выполняет ту же OTP-маршрутизацию без всяких скриптов:

1. Создайте аккаунт по почте и 6-значному коду из письма или через вход Google.
2. Пополните кошелёк в долларах США.
3. Выберите Бразилию и сервис, проверьте показанную цену и закажите.
4. Вставьте номер +55 в приложение и следите, как код появляется на карточке активации.

Сотрудники маркетинга, поддержки и проверяющие локализации часто идут этим путём, чтобы перед релизом убедиться, что экран онбординга на португальском работает, а инженеры оставляют API для автоматических прогонов.

Как хранить и нормализовать номера +55?

Бразильские номера содержат двузначный код региона (DDD) и абонентский номер, а мобильные номера состоят из девяти цифр и начинаются с 9. Внутри Бразилии для междугородных звонков набирают ведущий 0 и код выбора оператора, поэтому пользовательский ввод часто содержит лишние цифры, которым не место в хранилище.

Храните всё в E.164: +55, код региона, затем абонентский номер, без пробелов, без ведущего 0 и без кода оператора. Нормализуйте при вводе, сравнивайте по нормализованному значению и форматируйте только для отображения. Коды от бразильских отправителей обычно приходят на португальском, иногда на английском, поэтому разбирайте цифры, а не сопоставляйте фиксированную фразу.

Команды тестируют этот рынок для запуска в Бразилии, QA локализации на португальский и онбординга, сопряжённого с обязательствами по бразильскому закону о защите данных LGPD. Страница о финтех-онбординге охватывает сторону верификации в такой работе.

Что делать, если бразильский код не появляется?

Сначала дайте отработать 20-минутному окну: одни отправители медленнее других, а доставка зависит от сервиса и маршрута. Если окно истекло, списание отменяется автоматически, и вы можете повторить чуть позже или через другой маршрут из списка API.

• Убедитесь, что сервис вообще принимает виртуальные номера. Некоторые не принимают, и именно для этого существует правило возврата.
• Не заказывайте заново в плотном цикле. Делайте паузы между попытками и записывайте каждый идентификатор активации.
• Проверьте, что ваше приложение отправило номер в полной международной форме, а не в местном формате с префиксными цифрами.

В руководстве по снижению числа неудачных доставок OTP перечислены дополнительные способы диагностики.

Как сочетаются кошелёк, счета и песочница?

OTP Route списывает средства с единого предоплаченного кошелька в долларах США: оплата по факту, без ежемесячной платы и без выбора тарифа. Пополняйте картой или USDT либо USDC, и за каждое пополнение на почту приходит PDF-счёт. Полные ставки есть на странице тарифов и в API.

Для работы над интеграцией попросите поддержку переключить тестовый аккаунт в песочницу. Она возвращает имитированные номера и коды, так что вы можете отработать путь активации и вебхуков от начала до конца, не трогая средства кошелька. Используйте её только для собственных продуктов, соблюдайте условия каждого сервиса и помните, что к каждому аккаунту применяется Политика допустимого использования.

Частые вопросы

Могу ли я протестировать регистрацию в моём приложении для Бразилии без местной SIM-карты?

Да. Закажите номер +55 в OTP Gateway для вашего приложения или поддерживаемого сервиса, введите его в сценарий и прочитайте код в панели или через API.

Какой идентификатор страны для Бразилии в API OTP Route?

Это br. Передавайте его в поле country при создании активации или в параметре запроса country эндпоинта цен.

Спишут ли деньги, если WhatsApp не пришлёт код на мой номер +55?

Нет. Если SMS не дошло до номера в течение 20 минут или вы отменили заказ раньше, вся сумма автоматически возвращается на кошелёк.

Можно ли купить бразильский номер и сохранить его на месяцы?

Самостоятельно как продукт — нет. Долгосрочные Dedicated Numbers продаются только для США и Канады; по Бразилии можно написать на [email protected], но доступность не обещается.

Нужно ли сохранять ведущий ноль бразильского номера?

Нет. Удалите префиксный 0 и код выбора оператора, затем сохраните номер в формате E.164, начинающемся с +55 и двузначного кода региона.

На каком языке приходят бразильские проверочные сообщения?

Большинство приходит на португальском, а некоторые мировые сервисы отправляют текст на английском. Извлекайте числовой код, а не полагайтесь на формулировку.

Можно ли попробовать API, не пополняя кошелёк?

Запросите режим песочницы для тестового аккаунта. Он имитирует номера и коды, так что всю интеграцию можно протестировать без расхода средств кошелька.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.