Выбираем подходящий маршрут для армянских (+374) кодов подтверждения

Какой продукт OTP Route подходит для армянской задачи подтверждения?

Решите это до написания кода, потому что от ответа зависит вся интеграция. OTP Route продаёт два продукта, и до Армении дотягивается только один.

• OTP Gateway: номер от наших партнёров-операторов, зарезервированный для одного сервиса и одного кода. Подходит для тестов регистрации, регрессионных прогонов локализованного экрана онбординга и разовой верификации бизнес-профиля. Именно его вы используете для +374.
• Dedicated Virtual Numbers: линия, которая остаётся у вас, пока продлевается, со входящими и исходящими SMS и звонками из браузера. Продаётся мгновенно только для США и Канады, от $1.95 в месяц.

Самостоятельно оформить долгосрочный армянский номер нельзя. Если проекту он действительно нужен, напишите на [email protected] и опишите сценарий; возможность зависит от местных правил, поэтому считайте это вопросом, а не планом. Для аккаунтов, которым нужно входить и после первого кода, практичная альтернатива — выделенная линия в США или Канаде.

Что может подтвердить номер +374 в OTP Gateway?

Армянские маршруты сейчас охватывают более 1700 сервисов. Среди популярных в актуальном срезе — WhatsApp, Telegram, Viber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, LinkedIn, Microsoft & Outlook, Discord, ChatGPT (OpenAI) и Uber.

Мессенджеры заслуживают отдельного замечания: Viber и Telegram хорошо знакомы в Армении, поэтому продукту, который переводит пользователей в чат-канал, часто нужны тестовые аккаунты в них. Наличие по сервисам меняется в течение дня, поэтому API возвращает его в реальном времени, а мы не печатаем фиксированный список.

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

Всё находится под https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_ из консоли разработчика. Идентификатор страны Армении — am.

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

Вебхук-запросы несут X-OTPRoute-Signature: t=<unix>,v1=<hex>. Вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните и отбросьте всё с устаревшей меткой времени. В документации перечислены остальные события, activation.expired и activation.cancelled, привязанные к тому же идентификатору активации. Аккаунт ограничен 300 запросами в минуту, поэтому опрашивайте бережно.

Может ли коллега без доступа к API заказать номер +374?

Да. Операционные сотрудники и агенты поддержки могут сделать то же самое из браузера:

1. Войдите, откройте OTP Gateway и выберите Армению.
2. Выберите сервис; актуальная цена показывается до подтверждения.
3. Скопируйте номер в приложение или сайт, который его запрашивает.
4. Не закрывайте активацию; код появится рядом с номером, когда придёт.

Панель и API используют один кошелёк и одну историю заказов, так что QA-инженер и руководитель поддержки могут работать с одного баланса.

Как хранить армянские номера и на каком языке приходят коды?

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

У армянского языка собственный алфавит, а русский широко понимают, поэтому интерфейс на армянском — реальная цель локализации. Тексты подтверждения от глобальных приложений обычно следуют языковой настройке приложения и часто приходят на английском, но локализованный шаблон может прийти армянской или русской письменностью. Извлекайте цифры шаблоном, игнорирующим окружающие слова, и следите, чтобы журналы и базы данных работали с UTF-8, иначе тела сообщений на нелатинице будут искажены.

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

Что проверить, если армянский код не пришёл?

У молчания в пределах окна есть несколько обычных причин, и ни одна из них не стоит вам денег.

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

Если до закрытия окна ничего не пришло или вы отменили заказ, вся сумма автоматически возвращается в кошелёк. Наше руководство по снижению числа неудачных доставок OTP подробнее рассказывает о выборе времени повторов.

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

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

Прежде чем тратить реальный баланс, запросите режим песочницы для аккаунта разработки. Он возвращает симулированные номера и коды, так что CI-задача может пройти весь процесс am от начала до конца. В обзоре QA-тестирования показано, как команды встраивают это в конвейер. Используйте сервис только для своих продуктов и легитимных аккаунтов, соблюдайте условия каждой платформы и учтите, что действует Политика допустимого использования OTP Route.

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

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

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

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

Коды стоят от $0.20 за код, точная сумма зависит от сервиса. Вы платите, только если SMS пришло в течение 20-минутного окна.

Нужно ли хранить номер с ведущим 0?

Нет. Храните в E.164: +374 и восьмизначный национальный номер, без внутреннего 0.

Можно ли оставить армянский номер подтверждения для последующих входов?

Самостоятельно — нет. Номера OTP Gateway рассчитаны на один код; долгосрочные выделенные линии — продукт для США и Канады, а о других странах можно спросить на [email protected].

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

Иногда. Многие сервисы присылают текст на английском, но локализованные шаблоны могут использовать армянский или русский, поэтому разбирайте только цифры и храните сообщения в UTF-8.

Можно ли протестировать интеграцию с Арменией, не тратя средства?

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

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