SMS-верификация KakaoTalk для тестирования: чек-лист, шаги и решения проблем

Зачем продуктовым командам номер KakaoTalk для тестирования?

KakaoTalk — доминирующий мессенджер в Южной Корее, и его система аккаунтов выходит далеко за пределы чата. Многие корейские приложения предлагают Kakao Login как способ входа, поэтому команде, создающей продукт для этого рынка, часто нужен рабочий аккаунт Kakao просто чтобы протестировать собственную кнопку входа.

KakaoTalk привязывает регистрацию к номеру телефона: при новой установке приложение запрашивает номер и присылает SMS-код для подтверждения, а при переходе на новое устройство проверка повторяется. Привязанный аккаунт Kakao может также использовать телефонные шаги для восстановления и дополнительной защиты входа. Для QA это три отдельных сценария: первая регистрация, повторная верификация на новом устройстве или эмуляторе и путь восстановления. Использование личного телефона сотрудника в любом из них раскрывает частный номер в тестовом аккаунте, и именно эту проблему решает виртуальный номер для KakaoTalk.

Чек-лист перед первым заказом KakaoTalk

Подтвердите каждый пункт один раз, затем используйте настройку повторно:

• Цель, соответствующая условиям. Один аккаунт на реального человека или компанию, для тестирования или работы вашего собственного продукта. OTP Route не предназначен для массового или одноразового создания аккаунтов, и условия KakaoTalk действуют всегда.
• Ключ or_live_ из консоли разработчика, выданный для конвейера, который будет им пользоваться.
• Id сервиса kakaotalk и id страны из GET /api/v1/countries.
• Чистое устройство или эмулятор для установки, чтобы старая сессия не пропустила телефонный шаг.
• Эндпоинт вебхука или помощник опроса наготове до заказа, потому что окно в 20 минут начинается сразу.
• Решение о будущем аккаунта. Если ему нужно войти снова в следующем месяце, сначала прочитайте ниже раздел о Dedicated Number.

В каких странах можно получить OTP KakaoTalk?

Маршрут kakaotalk доступен в 198 странах. Среди примеров: Южная Корея, Япония, Вьетнам, Филиппины, Монголия, Индонезия, Таиланд, Малайзия, Тайвань, Гонконг, Казахстан, Узбекистан, Австралия, Германия, Великобритания, США и Канада.

Выбирайте страну под тестируемый сценарий. Чек-лист запуска на корейском рынке требует номера +82; проверку того, как ваш онбординг обращается с зарубежными пользователями корейского сервиса, лучше проводить из страны, где живут ваши реальные клиенты. Наличие по маршрутам меняется в течение дня, поэтому спрашивайте API перед каждым заказом. Компромиссы объясняет материал о маршрутизации OTP по странам.

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

Запросы идут на https://otproute.com/api/v1 с вашим Bearer-ключом; лимит — 300 запросов в минуту.

1. Проверьте средства через GET /api/v1/balance.
2. Узнайте актуальную цену через GET /api/v1/prices?country=kr&service=kakaotalk (замените kr выбранным id).
3. Закажите через POST /api/v1/activations с {"service": "kakaotalk", "country": "kr"}. Сохраните id активации и номер.
4. Введите номер на телефонном экране KakaoTalk на вашем тестовом устройстве.
5. Дождитесь кода. Получатели вебхуков получают activation.sms_received; те, кто использует опрос, вызывают GET /api/v1/activations/{id} каждые несколько секунд.
6. Если запуск оставлен, отправьте POST /api/v1/activations/{id}/cancel.

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

Пошагово из панели

1. Откройте OTP Gateway и найдите KakaoTalk.
2. Выберите страну; цена появится до подтверждения.
3. Скопируйте номер в приложение KakaoTalk на тестовом устройстве.
4. Прочитайте код на карточке заказа и завершите регистрацию.

Заказ без SMS по истечении 20 минут закрывается и возвращается полностью, так что вы платите только за пришедшие коды.

Диагностика: SMS-верификация KakaoTalk не приходит

• KakaoTalk отклонил номер. Он может отказывать некоторым виртуальным номерам и менять это поведение в любой момент. Возврат покрывает попытку; попробуйте маршрут другой страны.
• Приложение использовало старую сессию. Очистите данные приложения или возьмите свежий эмулятор, чтобы телефонный шаг действительно отправил новый код.
• Слишком много попыток подряд. KakaoTalk, как и большинство мессенджеров, ограничивает повторные запросы. Растягивайте повторы во времени, а не заказывайте заново в цикле.
• Слишком ранняя отмена. Дайте окну в 20 минут отработать, прежде чем отказываться от заказа.

О более общих схемах читайте в материале о снижении числа неудачных доставок OTP.

Когда Dedicated Number лучше одноразового кода?

Одноразовый номер OTP Gateway подходит для одной регистрации, которую можно выбросить после теста. Аккаунту Kakao, который вашей QA-команде нужно открывать на новых устройствах, или бизнес-аккаунту, общему для сотрудников поддержки, нужен номер, остающийся под вашим контролем. Dedicated Virtual Numbers OTP Route выполняют эту роль в США и Канаде, от $1.95/month, с входящими SMS в панели и на вашем вебхуке как number.sms_received. За пределами этих двух стран самостоятельного долгосрочного номера нет; напишите на [email protected], чтобы уточнить.

Всё оплачивается с одного предоплаченного кошелька в USD, пополняемого картой или USDT/USDC, без ежемесячной платы и с PDF-счётом по email. Режим sandbox с имитированными кодами доступен по запросу для работы над интеграцией. KakaoTalk является товарным знаком своего владельца; OTP Route с ним не связан.

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

Как получить OTP KakaoTalk для тестов Kakao Login в моём приложении?

Закажите номер для сервиса kakaotalk в OTP Gateway, зарегистрируйте на него тестовый аккаунт и прочитайте код в панели или через API.

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

Соответствующую тестируемому рынку. Южная Корея подходит для корейского запуска; выберите страну ваших клиентов, если тестируете зарубежных пользователей.

Примет ли KakaoTalk любой виртуальный номер?

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

Можно ли позже снова войти в тот же аккаунт KakaoTalk?

Одноразовый номер для этого не подходит. Используйте Dedicated Number в США или Канаде от $1.95/month, если аккаунт должен оставаться доступным.

Что лучше для кодов KakaoTalk: вебхук или опрос?

Вебхуки лучше масштабируются для параллельных задач; опрос GET /api/v1/activations/{id} проще для одного скрипта. Используйте один способ на задачу, а не оба.

Можно ли создать несколько аккаунтов KakaoTalk для маркетинга?

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

Сколько стоит код KakaoTalk в OTP Route?

Цены начинаются от $0.20 за код и различаются по странам. Актуальная сумма указана на странице тарифов и в API.

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