Приём грузинских SMS-кодов +995 для QA и региональных запусков

Почему страна Georgia сбивает с толку при планировании тестов?

Первый сюрприз — название. Страна Georgia делит его с американским штатом, поэтому библиотеки форм, фильтры аналитики и даже коллеги путают их. В API идентификатор страны — ge, по коду ISO GE, а телефонный код — +995. Тест, который молча берёт американский номер +1, потому что кто-то ввёл «Georgia» в строку поиска, — это ошибка, которую стоит поймать заранее.

Второй — письменность. Грузинский использует собственный алфавит мхедрули, который не входит в 7-битный набор GSM. Любое SMS с грузинскими буквами отправляется в Unicode, поэтому в сегмент помещается меньше символов, а длинные сообщения разбиваются раньше. Если ваш продукт сам отправляет сообщения на грузинском, именно это и должна проверить локализационная QA.

Как выглядит правильно сохранённый номер +995?

Внутри страны перед абонентским номером набирают префикс 0; в международном формате этот 0 пропадает. Мобильные номера состоят из девяти цифр и начинаются с 5, поэтому форма E.164 — это +995 и девять цифр, начинающихся с 5.

Практическая процедура нормализации грузинского ввода:

• Удалите пробелы, точки и дефисы, которые пользователи вводят по привычке.
• Если значение начинается с 0 и состоит из десяти цифр, отбросьте 0 и добавьте +995.
• Если оно начинается с 995 без знака плюс, добавьте плюс.
• Отклоняйте всё, где после плюса всё ещё не двенадцать цифр.

Хранение единого канонического формата означает, что номер, который вводит ваш тест, совпадает с номером, который позже ищет бэкенд.

Какие грузинские сценарии верификации можно проверить?

В срезе по Georgia сейчас значатся WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Discord, LinkedIn и Viber, а весь каталог насчитывает более 1,500 сервисов.

Команды тестируют здесь по нескольким повторяющимся причинам: продукт выходит на Южный Кавказ, удалённая команда в Тбилиси проверяет региональные бизнес-аккаунты или при локализации нужно убедиться, что грузинский текст правильно отображается на экранах регистрации. Наличие меняется в течение дня, поэтому перед резервированием номера +995 для тестов спросите API, а не доверяйте вчерашнему списку. Маршрутизация OTP выбирает из того, что доступно в этот момент.

Как выполняется последовательность вызовов Georgia OTP API?

Все вызовы идут на https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_. В одном аккаунте может быть до 10 ключей, что позволяет разделить стейджинг и продакшен.

1. Один раз получите GET /api/v1/countries и убедитесь в наличии id ge.
2. Вызовите GET /api/v1/prices?country=ge&service=<id>, чтобы узнать сегодняшнюю цену и наличие.
3. Оформите заказ через POST /api/v1/activations, например {"service": "whatsapp", "country": "ge"}.
4. Введите номер +995 в тестируемое приложение и запустите шаг с SMS.
5. Прочитайте код через GET /api/v1/activations/{id} или пусть его доставит вебхук.
6. Если сценарий прерван, освободите заказ через POST /api/v1/activations/{id}/cancel.

Лимит 300 запросов в минуту оставляет запас для опроса раз в несколько секунд в нескольких параллельных задачах.

Опрашивать или использовать вебхуки для кодов +995?

Оба способа используют один и тот же SMS verification API, и опроса достаточно одному разработчику, который хочет получать грузинские SMS OTP с ноутбука. В CI спокойнее вебхук: зарегистрируйте до 5 эндпоинтов в консоли разработчика и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

Проверяйте каждый запрос. Заголовок X-OTPRoute-Signature содержит t=<unix>,v1=<hex>; вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните за постоянное время и отбрасывайте запросы со старой меткой времени. Сохраняйте результаты по id активации, чтобы повторная доставка была безвредной. Готовый шаблон есть в разборе приёма через вебхуки.

Грузинский код не пришёл. Что попробовать?

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

Долгосрочные номера, оплата и песочница

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

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

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

Как убедиться, что я получаю номер страны Georgia, а не американского штата?

Используйте в вызовах API идентификатор страны ge и ищите телефонный код +995 в дашборде. У американского штата собственного идентификатора страны не бывает.

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

Да. Номер OTP Gateway с префиксом +995 принимает код, а вы читаете его в дашборде или через API.

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

Нет. 0 — внутренний префикс; храните номер как +995 и девять цифр, начинающихся с 5.

Почему грузинские SMS на сегмент вмещают меньше текста?

Грузинские буквы не входят в 7-битный алфавит GSM, поэтому сообщение использует кодировку Unicode, в которой в каждый сегмент помещается меньше символов.

Сколько стоит грузинский номер подтверждения?

От $0.20 за код, в зависимости от сервиса. Актуальную цену возвращает GET /api/v1/prices, и она отображается в дашборде до заказа.

Спишут ли деньги, если платформа отвергла номер?

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

Какое использование номеров +995 допускается?

Тестирование собственного продукта, QA-автоматизация и работа с вашими бизнес-аккаунтами. Соблюдайте правила каждого сервиса и Политику допустимого использования OTP Route.

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