Получение SMS-кодов Zoho для тестирования и бизнес-аккаунтов

Ситуация: экран Zoho просит мобильный номер

Команды встречаются с этим шагом по нескольким предсказуемым причинам. Разработчику интеграции нужен свежий аккаунт Zoho, чтобы протестировать OAuth-подключение к CRM, Books или Desk. Агентство настраивает Zoho Mail и Zoho One для клиента и не хочет привязывать личный телефон сотрудника к админскому логину. QA-лид должен доказать, что регистрация ведёт себя одинаково для пользователя в Дубае и в Сиднее. Во всех случаях препятствие одно и то же — SMS, а нужной SIM-карты из правильной страны под рукой у человека обычно нет.

OTP Route превращает это сообщение в то, что ваши инструменты могут запросить, дождаться и прочитать.

Где Zoho использует подтверждение по телефону?

Zoho обычно просит мобильный номер при создании нового аккаунта и может использовать SMS как второй фактор при входе наряду со своим приложением-аутентификатором. Подтверждённый номер также применяется для восстановления аккаунта при потере пароля. Когда именно запрашивается код, зависит от продукта, региона аккаунта и настроек безопасности, выбранных администратором, поэтому стройте тесты так, чтобы они выдерживали как появление запроса, так и его отсутствие.

Выбор страны для номера Zoho

Сервис zoho сейчас маршрутизируется в 198 странах. Подбирайте номер под рынок аккаунта, который вы создаёте или тестируете, потому что страна влияет на телефонный код, который ожидает Zoho, на язык сообщения, а иногда и на то, в каком региональном дата-центре окажется аккаунт.

Часто выбирают маршруты Индии, США, Великобритании, ОАЭ, Австралии и Германии. В списке есть и другие: Канада, Бразилия, Мексика, Сингапур, Саудовская Аравия, ЮАР, Нидерланды, Испания, Франция, Япония, Индонезия, Малайзия и Кения. Наличие меняется в течение дня, поэтому читайте его из GET /api/v1/countries в начале прогона.

Подключение API кода подтверждения Zoho к вашим тестам

Вызовы идут на https://otproute.com/api/v1 с Bearer-ключом из консоли разработчика.

1. Узнайте цену: GET /api/v1/prices?country=<id>&service=zoho.
2. Создайте активацию: POST /api/v1/activations с {"service": "zoho", "country": "<id>"}.
3. Пусть ваша браузерная автоматизация введёт полученный номер в форму Zoho и запросит код.
4. Ждите на вебхук-эндпоинте событие activation.sms_received, привязанное к идентификатору активации.

Две привычки делают обработчик надёжным. Во-первых, проверяйте X-OTPRoute-Signature: вычислите HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта и отклоняйте устаревшие метки времени. Во-вторых, сделайте обработчик идемпотентным: записывайте идентификатор активации и игнорируйте повторную доставку, чтобы код никогда не отправлялся дважды. Если ваш тест-раннер не принимает входящий трафик, опрашивайте GET /api/v1/activations/{id} и не превышайте 300 запросов в минуту. Оба подхода показаны в руководстве по вебхукам.

Вручную в личном кабинете

Для разовой настройки откройте OTP Gateway, выберите Zoho, укажите страну, проверьте показанную цену и подтвердите. Скопируйте номер в Zoho, нажмите кнопку отправки кода и не закрывайте активацию. Код появится на экране, когда придёт. У вас есть 20 минут; если ничего не пришло или вы отменили заказ, вся сумма возвращается на баланс.

Почему OTP Zoho может не прийти

У отсутствующего кода обычно самая обыденная причина:

• Zoho может отклонять виртуальные номера для некоторых регионов или типов аккаунтов. Это его решение, и именно поэтому возврат автоматический.
• Маршрут этой страны в данный момент может быть перегружен. Повторите позже или выберите другую страну, подходящую для теста.
• Повторные запросы из одной браузерной сессии сам Zoho может ограничивать, поэтому делайте паузы между попытками.
• Новые активации в плотном цикле не помогают и расходуют ваш лимит API.

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

Когда лучше выбрать Dedicated Number

Одноразовая активация подходит для создания и тестирования аккаунтов. Она не подходит для админского логина, который снова запросит SMS в следующем месяце, потому что позже этот номер вам не принадлежит. В таком случае Dedicated Number от $1.95/месяц даёт американскую или канадскую линию, которая остаётся у вас, пока вы её продлеваете, с входящими SMS в личном кабинете и пересылкой на ваш вебхук. Выделенные линии предлагаются только в этих двух странах. Подробнее — на странице виртуальных номеров.

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

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

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

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

Создайте активацию с идентификатором сервиса zoho и выбранной страной, затем прочитайте код из вебхука activation.sms_received или опросом активации.

Можно ли использовать виртуальный номер для SMS-верификации Zoho при тестировании?

Часто да, но Zoho может отказывать виртуальным номерам в некоторых случаях. Если код не пришёл за 20 минут, оплата возвращается.

Сколько стоит номер Zoho на один код?

От $0.20 за код. Актуальную цену по стране возвращает эндпоинт цен, она же показана в личном кабинете.

Какую страну выбрать для тестового аккаунта Zoho?

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

Можно ли сохранить тот же номер для будущих входов в Zoho?

Не с одноразовой активацией. Для аккаунта, который должен подтверждаться снова позже, подходит американский или канадский Dedicated Number.

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

Да. Аккаунт разработки можно перевести в песочницу по запросу: она возвращает имитированные номера и коды. Подробности — в документации.

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