Тестирование подтверждения тайских (+66) номеров: чек-лист, шаги и решения

Прежде чем начать: чек-лист для тестирования +66

В тайских сценариях регистрации есть несколько ловушек, которые дешевле поймать на бумаге, чем в упавшем прогоне CI. Сначала проверьте каждый пункт:

• Учётные данные. Bearer-ключ с префиксом or_live_ из консоли разработчика, ограниченный той средой, которая будет им пользоваться.
• Идентификаторы. Идентификатор страны Таиланда — th; идентификатор сервиса берите из GET /api/v1/services, а не угадывайте.
• Способ доставки. Либо эндпоинт вебхука с сохранённым секретом подписи, либо задача опроса, соблюдающая лимит в 300 запросов в минуту.
• Обработка номеров. Решите, как ваш код убирает внутренний 0, прежде чем что-либо сохранять (см. раздел о форматировании).
• Разбор сообщений. Убедитесь, что парсер справляется с тайским письмом вокруг цифр.
• Бюджет. Пополненный кошелёк или песочница, если нужно лишь доказать работоспособность интеграции.

Какие тайские сценарии регистрации может покрыть OTP Gateway?

Таиланд — один из самых широких маршрутов: в живом снимке более 1 800 сервисов. В местном использовании преобладают мессенджеры и торговля, поэтому команды обычно начинают с LINE, Shopee, Lazada, TikTok, WhatsApp, Facebook, Instagram и Telegram. В списке есть также Google (Gmail & YouTube), Microsoft & Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon и Airbnb.

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

Заказ проверочного номера Таиланда через API

Базовый URL — https://otproute.com/api/v1.

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

Проверяйте заголовок X-OTPRoute-Signature (t=<unix>,v1=<hex>) в каждой доставке и отбрасывайте события со слишком старой меткой времени. События привязаны к идентификатору активации, поэтому повторные доставки легко игнорировать. Полные примеры запросов — в документации для разработчиков.

Форматы тайских номеров, транковый ноль и сообщения на тайском

Внутри страны тайские мобильные номера записываются с ведущим 0 и ещё девятью цифрами, обычно начинающимися с 06, 08 или 09. Этот 0 — транковый префикс: в международной форме он пропадает, поэтому 08x xxx xxxx превращается в +66 8x xxx xxxx. Храните версию E.164 и нормализуйте любой пользовательский ввод, который ещё содержит ноль, иначе ваша дедупликация сочтёт один аппарат двумя людьми.

Коды из ориентированных на Таиланд приложений часто приходят внутри предложения на тайском. Извлекайте код по шаблону (последовательность цифр ожидаемой длины), а не опираясь на английские слова, и помните, что SMS на тайском используют кодировку Unicode, поэтому сообщения делятся на более короткие сегменты. Вторая причина, по которой команды тестируют здесь, — QA локализации: в тайских интерфейсах поля с датой обычно показывают год по буддийскому летоисчислению, а ограничения длины полей для тайских имён и адресов легко настроить неверно. Запуски продуктов в Юго-Восточной Азии, онбординг продавцов маркетплейсов и тайскоязычные службы поддержки дополняют обычный список.

Как сотрудники поддержки и операционных отделов могут использовать панель вместо этого?

Не каждой проверке нужен скрипт. Сотрудник операционной команды может зарегистрироваться, пополнить баланс, открыть OTP Gateway, выбрать сервис и Таиланд, посмотреть указанную цену и получить номер. Код появится на карточке активации в браузере. Действует то же 20-минутное окно, и возврат происходит сам, если окно закрылось пустым.

Диагностика кодов, которые не доходят до номера +66

Если активация остаётся пустой, пройдите по этому списку:

• Дайте ей пройти всё окно, прежде чем отменять: отложенные повторные отправки — обычное дело.
• Убедитесь, что сервис принимает виртуальные номера для Таиланда. Некоторые нет, и именно это покрывает автоматический возврат.
• Повторите позже или переключитесь на маршрут другой страны, если позволяет тестовый сценарий. В статье о маршрутизации по странам объясняется, как команды выбирают запасные варианты.
• Разносите повторы по времени. Повторные заказы в плотном цикле редко помогают и засоряют логи.

При неудачной попытке деньги не пропадают: истёкшая или отменённая активация возвращает полную сумму на кошелёк.

Долгосрочные линии, кошелёк и песочница для тайских проектов

OTP Route не продаёт самостоятельно оформляемый долгосрочный номер в Таиланде. Команды, которым нужна постоянная тайская линия, могут написать на [email protected]; возможность определяют местные правила. Выделенные номера, которые вы оставляете себе и продлеваете, доступны только в США и Канаде, от $1.95/мес.

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

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

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

Да. Закажите номер +66 в OTP Gateway, введите его в приложении и прочитайте код в панели либо через API и вебхуки.

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

Нет. Отбросьте транковый 0 и храните номер как +66 и далее оставшиеся девять цифр.

Какой идентификатор API ожидает для Таиланда?

Используйте th как значение страны, например в GET /api/v1/prices?country=th&service=<id>.

Почему сообщение от LINE или Shopee приходит на тайском?

Многие сервисы локализуют шаблон SMS по стране номера или по языку аккаунта, поэтому разбирайте цифры, а не английские ключевые слова.

Сколько стоит неудавшаяся активация для Таиланда?

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

Можно ли запускать тайские OTP-тесты в CI, не тратя деньги?

Да, запросите режим песочницы для тестового аккаунта. Он возвращает имитированные номера и коды, так что пайплайн можно проверить от начала до конца — это описано на странице решения для CI/CD.

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