Приём SMS-кодов LINE на номерах OTP Route: чек-лист и шаги

Для чего LINE использует номер телефона?

LINE привязывает аккаунт к номеру телефона. Новая регистрация подтверждается SMS-кодом, а приложение может запросить номер снова при переносе аккаунта на новое устройство или при входе после переустановки. Номер также участвует в восстановлении доступа, поэтому важно, с каким номером был создан аккаунт.

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

Чек-лист перед заказом номера LINE

• API-ключ из консоли разработчика (префикс or_live_); до 10 ключей на аккаунт.
• Достаточный баланс кошелька, проверенный через GET /api/v1/balance.
• Страна, выбранная под рынок аккаунта или тестовый сценарий.
• Актуальная цена для этой пары, потому что цены различаются по странам.
• Зарегистрированный эндпоинт вебхука с проверенной проверкой подписи либо готовый цикл опроса.
• Решение о том, должен ли этот аккаунт входить снова позже; если да, прочитайте ниже раздел о Dedicated Number.
• Быстрое перечитывание условий LINE для типа создаваемого аккаунта.

Какую страну выбрать для LINE и почему это важно?

Сервис LINE доступен в 197 странах. Самая сильная аудитория приложения находится в части Восточной и Юго-Восточной Азии, поэтому команды, запускающиеся там, часто начинают с Японии, Таиланда, Тайваня, Индонезии, Гонконга или Малайзии. Среди других вариантов: Сингапур, Филиппины, Вьетнам, Южная Корея, Австралия, США, Великобритания, Германия, Бразилия и Румыния.

Выбирайте страну, откуда приходят ваши реальные пользователи. Сборку для тайского рынка нужно проверять с тайским номером, чтобы телефонный код, формат номера и региональные экраны онбординга вели себя так же, как в продакшене. Охват нескольких рынков почти не требует дополнительных усилий, ведь между запусками меняется только значение country.

Пошагово: как работает API кодов подтверждения LINE

1. Вызовите GET /api/v1/prices?country=<id>&service=linemessenger и убедитесь, что маршрут доступен.
2. Создайте активацию через POST /api/v1/activations с телом вроде {"service": "linemessenger", "country": "th"}.
3. Введите возвращённый номер на экране телефонной верификации LINE.
4. Дождитесь activation.sms_received или опрашивайте GET /api/v1/activations/{id} каждые несколько секунд в рамках лимита 300 запросов в минуту.
5. Если запуск оставлен, вызовите POST /api/v1/activations/{id}/cancel.

Подробности по эндпоинтам есть в документации для разработчиков.

Как обработчик вебхука должен работать с событиями LINE?

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

Заказ номера LINE из панели

Войдите, откройте OTP Gateway, выберите LINE и страну, проверьте показанную цену и закажите. Введите номер в LINE и держите карточку активации открытой: код появится там после получения. Продуктовые менеджеры и агенты поддержки часто используют этот вид, чтобы вручную проверить локализованный экран онбординга LINE, прежде чем подключится автоматический набор тестов. Действуют те же окно в 20 минут и правило возврата.

Диагностика: почему код LINE может не прийти

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

• попробуйте другую страну, которая всё ещё подходит для тестового сценария;
• повторите позже, а не заказывайте заново в плотном цикле;
• убедитесь, что номер введён с правильным телефонным кодом страны.

Когда Dedicated Number лучше подходит для LINE?

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

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

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

Какой id сервиса OTP Route использует для LINE?

linemessenger. Используйте его в запросе цены и в поле service при создании активации.

Можно ли выполнить SMS-верификацию LINE для тестирования без физической SIM-карты?

Да. Номер OTP Gateway принимает код LINE, который вы читаете через API, вебхук или панель.

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

Выберите рынок, к которому относятся ваши пользователи или тестовый сценарий, например Японию или Таиланд для запуска там.

Примет ли LINE любой номер OTP Route?

Не всегда. LINE может отклонять некоторые виртуальные номера, и если код не пришёл, возврат делается автоматически.

Сколько стоит получение OTP LINE?

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

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

Только с Dedicated Number, который доступен в США и Канаде. Одноразовые номера рассчитаны на один код.

Нужен ли вебхук для получения OTP-кодов LINE, или достаточно опроса?

Опрос GET /api/v1/activations/{id} хорошо работает для небольших прогонов. Вебхуки лучше масштабируются, когда параллельно идёт много активаций.

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