Предполётный чек-лист для SMS-верификации в Боливии (+591)

Что должно быть в чек-листе перед заказом номера +591?

Большинство неудачных тестовых прогонов по Боливии связаны с чем-то, что просто не было настроено, а не с самим маршрутом. Сначала отметьте следующее:

• API-ключ с префиксом or_live_, созданный в консоли разработчика и сохранённый как секрет в конфигурации CI или приложения. Один ключ на окружение делает логи читаемыми.
• Эндпоинт вебхука, быстро отвечающий по HTTPS, с загруженным секретом подписи. Опрос тоже работает, но решите заранее, чем пользуется ваш тестовый стенд.
• Средства на кошельке для прогона или аккаунт-песочница, если нужно проверить только обвязку.
• Идентификатор сервиса для тестируемого приложения из GET /api/v1/services и идентификатор страны Боливии — bo.
• Парсер телефонных номеров в вашем продукте, принимающий ввод +591, чтобы полученный номер действительно можно было ввести в форму регистрации.

Если чего-то не хватает, исправьте это до того, как потратите хотя бы одну активацию.

Какие приложения сейчас можно подключить через Боливию?

Актуальный список для Боливии включает более 1 700 сервисов. Команды чаще всего запрашивают WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Discord, LinkedIn, Viber, Signal и AliExpress.

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

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

Каждый вызов идёт на https://otproute.com/api/v1 с вашим Bearer-ключом, лимит аккаунта — 300 запросов в минуту.

1. Получите текущую цену и доступность через GET /api/v1/prices?country=bo&service=<id>. Пропустите заказ, если маршрут сейчас пуст.
2. Создайте активацию: POST /api/v1/activations с {"service": "<id>", "country": "bo"}. Сохраните идентификатор активации и возвращённый номер.
3. Введите номер на экране регистрации или входа тестируемого приложения.
4. Дождитесь вебхука activation.sms_received или опрашивайте GET /api/v1/activations/{id} со спокойным интервалом.
5. Если тест прекращён, вызовите POST /api/v1/activations/{id}/cancel, чтобы удержанная сумма сразу вернулась на кошелёк.

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

Как хранить и проверять боливийский номер?

Мобильные номера Боливии состоят из восьми цифр после кода страны +591 и обычно начинаются с 6 или 7. Храните их в формате E.164, например +591 и эти восемь цифр, без пробелов, а всё, что пользователь ввёл с местной группировкой или ведущим нулём, нормализуйте перед сохранением.

Большинство проверочных сообщений приходит на испанском, хотя в Боливии официально признаны также кечуа, аймара, гуарани и многие другие языки. Если ваш продукт предлагает интерфейс на языке коренных народов, проверьте, что шаблон SMS, который отправляет ваш собственный бэкенд, отображается корректно, ведь этот путь отделён от сообщений сторонних приложений.

Команды обычно приходят в Боливию ради регионального запуска в странах Анд, для QA локализации испаноязычных сценариев или чтобы поддержать клиентов, зарегистрировавшихся с боливийским номером и живущих за границей.

Есть ли путь через панель для тех, кто не пишет код?

Да, и он следует той же логике чек-листа. Сотрудник операционного отдела или поддержки может:

1. Войти через /signup по коду из письма или через Google и включить двухфакторную защиту TOTP.
2. Открыть OTP Gateway, выбрать сервис, а затем Боливию; актуальная цена показывается до любого списания.
3. Скопировать номер в приложение и держать вкладку панели открытой. Код появится там, когда придёт SMS.

Это удобно для разовой проверки экрана входа в продакшене без вмешательства в интеграцию.

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

Действуйте по порядку:

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

Если SMS не пришло до закрытия окна, вся сумма автоматически возвращается на кошелёк. Больше сценариев — в материале как снизить число неудачных доставок OTP.

Можно ли оставить долгосрочную боливийскую линию и как устроена оплата?

Самостоятельно оформить долгосрочный номер для Боливии нельзя. OTP Route продаёт Dedicated Virtual Numbers только в США и Канаде, от $1.95 в месяц; если вашей команде нужна постоянная боливийская линия, напишите на [email protected], и команда скажет, возможно ли что-то в рамках местных правил, ничего не обещая заранее.

Оплата — единый предоплаченный кошелёк в долларах США без ежемесячной платы и без выбора тарифа. Пополняйте картой или USDT/USDC, и за каждое пополнение на почту приходит PDF-счёт. Для работы над интеграцией запросите режим песочницы, который возвращает имитированные номера и коды без расхода средств. Полные ставки — на странице /pricing.

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

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

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

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

Используйте bo и в запросе цен, и в теле активации.

Плачу ли я, если боливийское SMS так и не пришло?

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

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

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

Может ли QA-конвейер использовать номер +591 для тестов каждую ночь?

Одна активация покрывает один код, поэтому ночное задание заказывает новый номер на каждый прогон. Подходы описаны в материале SMS OTP-тестирование в CI-конвейерах.

Подходит ли боливийский номер для аккаунтов, в которые нужно войти снова через несколько месяцев?

Не совсем, ведь одноразовые номера не сохраняются. Для долгоживущих аккаунтов лучше подходит Dedicated Number США или Канады.

Есть ли ограничения на то, что можно проверять номером Боливии?

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

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