Получение SMS-кодов imo для тестирования и работы с аккаунтами

Ситуация: ваш продукт работает с imo, и для каждого теста нужен телефон

imo — мессенджер с голосовыми и видеозвонками, который идентифицирует каждый аккаунт по номеру телефона. Регистрация или перенос аккаунта на новое устройство запускает отправку одноразового кода по SMS. Для пользователей это просто, а для команд неудобно: всем, кто строит интеграцию, процесс поддержки или тест рынка с участием imo, на каждую попытку нужен доступный номер.

Телефоны сотрудников смешивают личные номера с рабочими аккаунтами и не масштабируются на матрицу тестов по странам. Одноразовый номер из OTP Gateway рассчитан на один код, не задействует личные номера и заказывается как из кода, так и вручную. Общую схему описывает страница о верификации мобильных приложений.

В каких странах можно получать OTP-коды imo?

Сервис imo сейчас доступен в 197 странах. Среди них, например, Индия, Пакистан, Бангладеш, Непал, Саудовская Аравия, Объединённые Арабские Эмираты, Египет, Нигерия, Кения, Индонезия, Филиппины, Германия, Бельгия, Великобритания, США и Канада.

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

Как работает API кодов подтверждения imo?

Создайте Bearer-ключ в консоли разработчика (префикс or_live_, до 10 на аккаунт) и обращайтесь к https://otproute.com/api/v1; лимит — 300 запросов в минуту.

1. Узнайте идентификаторы через GET /api/v1/services и GET /api/v1/countries; идентификатор сервиса — imo.
2. Запросите цену для пары командой GET /api/v1/prices?country=pk&service=imo.
3. Закажите номер через POST /api/v1/activations с телом {"service": "imo", "country": "pk"} и сохраните идентификатор активации.
4. Введите полученный номер на экране регистрации imo.
5. Получите код из вебхука activation.sms_received или опрашивайте GET /api/v1/activations/{id}, если открыть публичный эндпоинт нельзя.

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

Можно ли заказать номер imo из панели управления?

Да. Зарегистрируйтесь по email с 6-значным кодом из письма или через вход Google и включите двухфакторную защиту TOTP. Пополните кошелёк, выберите imo и страну, проверьте показанную цену и подтвердите заказ. Введите номер в imo, и код появится в панели сразу после доставки. Это удобно сотруднику поддержки или аккаунт-менеджеру агентства, которому нужна одна верификация без написания кода.

Почему код imo может не прийти и что делать?

Каждая активация остаётся открытой 20 минут, и вы платите, только если код пришёл. Истёкший или отменённый заказ полностью возвращается на кошелёк автоматически.

Коды пропадают по обычным причинам: imo может отказать виртуальным номерам, маршрут может быть занят, а сервис — добавлять проверки для номеров, которые уже видел. В таком случае:

• Дайте окну закончиться, не отменяя заказ раньше времени.
• Повторите позже или выберите другой страновой маршрут, который по-прежнему подходит для теста.
• Делайте паузу и ограничивайте число повторов: серия заказов imo подряд только расходует попытки.

Когда для imo лучше подходит выделенный номер?

Поскольку imo привязывает аккаунт к номеру телефона, одноразовый номер не получит следующий код, когда тот же аккаунт входит с другого устройства. Для линии поддержки, общего операционного аккаунта или тестового входа, который должен продолжать работать, лучше выделенный номер (Dedicated Number). Они доступны только в США и Канаде, от $1.95/месяц, с входящими SMS в панели и на вашем вебхуке через number.sms_received. Подробности о продлении и освобождении — на странице выделенных номеров.

Ответственное использование и оплата

Соблюдайте условия использования imo: один аккаунт на реального человека или компанию, без массовых и фиктивных регистраций. OTP Route предназначен для тестирования потока вашего собственного продукта и работы с вашими законными аккаунтами, и к нему применяется Политика допустимого использования. imo — товарный знак его владельца, и OTP Route не связан с ним.

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

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

Как получить OTP imo через API?

Создайте активацию с телом {"service": "imo", "country": "<id>"}, введите номер в imo и прочитайте код из вебхука или через GET /api/v1/activations/{id}.

Доступна ли SMS-верификация imo для тестирования в моей стране?

Сейчас imo доступен в 197 странах. Актуальную доступность смотрите через GET /api/v1/countries или в панели.

Всегда ли imo принимает виртуальный номер?

Нет. imo может отказать некоторым виртуальным номерам, поэтому заказ, по которому код не пришёл, полностью возвращается через 20 минут.

Сколько стоит номер imo в OTP Route?

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

Можно ли позже снова войти в тот же аккаунт imo с одноразовым номером?

Ненадёжно, поскольку каждый одноразовый номер рассчитан на один код. Для аккаунтов, в которые нужно входить снова, используйте выделенный номер США или Канады.

Как вебхуку обрабатывать повторные доставки imo?

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

Можно ли так создать несколько аккаунтов imo?

Только для реальных людей или компаний, которых вы представляете, и в рамках условий imo. Массовые или фиктивные регистрации запрещены.

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