Как выбрать способ получения тонганских кодов подтверждения (+676)

Номер Gateway или долгосрочная линия: что подходит для проекта по Тонге?

Начните с формы задачи. Если нужно увидеть, как приходит один SMS-код, — для теста регистрации, проверки локализации или воспроизведения обращения в поддержку, — подходящий продукт это OTP Gateway. Вы получаете номер +676 для одной проверки, код попадает в панель и в ваши системы, а активация закрывается.

Если же нужен номер, который остаётся за аккаунтом на месяцы, чтобы снова входить, получать коды восстановления или вести линию поддержки, это задача для Dedicated Virtual Numbers. Они доступны только в США и Канаде, от $1.95/month, со входящими и исходящими SMS и звонками из браузера.

Самостоятельной долгосрочной тонганской линии в OTP Route нет. Командам, которым она нужна, можно написать на [email protected], понимая, что доступность зависит от местных правил и может быть невозможна. Подробнее о компромиссе — в материале о временных и выделенных номерах.

Зачем кому-то тестировать регистрацию на тонганских номерах?

У Тонги большая диаспора, значительная часть которой живёт в Новой Зеландии, Австралии и США, и семьи поддерживают связь между этими странами через мессенджеры и сервисы денежных переводов. Продуктам, обслуживающим тихоокеанские сообщества, например инструментам денежных переводов, общественным платформам и туристическим сервисам, нужно принимать номер +676 так же уверенно, как +64.

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

Как валидаторам относиться к номерам +676?

Национальные номера Тонги намного короче европейских или американских, которые большинство разработчиков держит в голове, а в международной форме магистрального префикса нет. Код проверки с фиксированной минимальной длиной — самая частая причина, по которой такие номера отклоняются.

• Храните каждый номер в E.164: +676 и цифры абонента, и никогда не дополняйте его.
• Полагайтесь на актуальную библиотеку для работы с телефонными номерами, а не на регулярное выражение, скопированное для другой страны.
• Убедитесь, что ваш отправитель SMS не отбрасывает молча получателей, номер которых выглядит слишком коротким.
• Держите номер подтверждения Тонги в наборе фикстур, чтобы будущий рефакторинг не вернул ошибку.

Разовый заказ +676 в Gateway — недорогой способ убедиться, что весь путь работает с реальным SMS, доставленным оператором.

Какие сервисы охватывает маршрут Тонги?

Тонганский маршрут сейчас включает более 600 сервисов. Среди популярных в последнем снимке — Facebook, TikTok, Viber, WhatsApp, Instagram, Telegram, Google (Gmail & YouTube), Snapchat, Microsoft & Outlook и Amazon.

Список меняется в течение дня по мере перераспределения ёмкости между маршрутами. Воспринимайте его как ориентир и проверяйте актуальную доступность перед заказом — в панели или через конечную точку цен.

Как вызывать OTP API для Тонги?

Авторизуйтесь на https://otproute.com/api/v1 с помощью Bearer-ключа, начинающегося с or_live_, из консоли разработчика. Идентификатор страны Тонга — to.

Проверьте цену и наличие через GET /api/v1/prices?country=to&service=<id>, затем оформите заказ через POST /api/v1/activations с телом вроде {"service": "viber", "country": "to"}. В ответе вернутся идентификатор активации и номер +676.

Чтобы получать SMS OTP-коды Тонги автоматически, зарегистрируйте вебхук на activation.sms_received и activation.expired. Каждый запрос содержит X-OTPRoute-Signature: t=<unix>,v1=<hex>; пересчитайте HMAC-SHA256 от <t>.<raw body> с секретом вашей конечной точки, сравните за постоянное время и отклоняйте старые метки времени. Опрос GET /api/v1/activations/{id} подходит для небольших задач, а POST /api/v1/activations/{id}/cancel освобождает ненужный заказ. Лимиты: 300 запросов в минуту, 10 ключей и 5 конечных точек вебхука на аккаунт. Подробности запросов и ответов — в документации для разработчиков.

Что делать, если тонганский код медлит или не приходит?

Тонкие маршруты на небольших островных рынках — норма, поэтому продумайте политику повторов заранее.

1. Дайте 20-минутному окну завершиться; если SMS не придёт, заказ возвращается полностью.
2. Проверьте, принимает ли тестируемый сервис виртуальные номера. Некоторые не принимают, и ни один маршрут этого не изменит.
3. Подождите, прежде чем пробовать снова, вместо того чтобы подряд оформлять новые заказы.
4. Если тест касается тихоокеанских номеров в целом, попробуйте соседний маршрут, например Фиджи или Самоа.

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

Как устроены оплата и тестирование в песочнице?

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

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

Могу ли я получить тонганский код подтверждения, не находясь в Тонге?

Да. Закажите номер +676 в OTP Gateway, и код появится в вашей панели и придёт на вебхук, где бы ни находилась ваша команда.

Какой идентификатор страны использует API SMS-верификации для Тонги?

Идентификатор — to; он используется в GET /api/v1/prices и POST /api/v1/activations.

Почему моя форма отклоняет корректные тонганские номера?

Обычно из-за проверки минимальной длины, написанной для более длинных номеров. Проверяйте номера поддерживаемой библиотекой и храните их в E.164.

Есть ли долгосрочный номер +676, который можно сохранить?

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

Что будет с моими деньгами, если тонганский код не придёт?

Вся сумма автоматически вернётся на кошелёк, когда 20-минутное окно закроется без SMS или когда вы отмените заказ.

Можно ли тестировать тонганский онбординг моего приложения в CI?

Да. Используйте отдельный API-ключ для каждой среды, опрашивайте или слушайте вебхуки и переведите аккаунт разработки в песочницу, пока строите конвейер.

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

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

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