Как команды получают SMS-коды WeChat для тестирования и работы

Чем верификация WeChat отличается от других мессенджеров?

WeChat — это гораздо больше, чем чат. Для многих пользователей это ещё и кошелёк, витрина магазина через Mini Programs и главный канал связи с бизнесом в Китае. Поэтому проверки аккаунтов в нём строже, чем в большинстве приложений, а номер телефона в WeChat весит больше, чем простой логин.

Приложение использует SMS-коды в нескольких точках:

• Регистрация, где номер телефона становится основным идентификатором аккаунта.
• Вход на новом устройстве, часто в сочетании с другими проверками.
• Смена или восстановление привязанного номера.
• Проверки безопасности, которые могут потребовать больше, чем SMS: WeChat может потребовать подтверждение от существующего пользователя или другие шаги проверки личности. Никакой номер, ни от какого провайдера, не может их заменить.

Для команды, которая создаёт WeChat Mini Program, интеграцию с официальным аккаунтом или трансграничную службу поддержки, это значит, что тестовые аккаунты нужно планировать заранее, а не создавать на лету.

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

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

Выбирайте страну под тестируемый случай, а не по самому дешёвому маршруту. Службу поддержки, обслуживающую китайских туристов в Европе, нужно тестировать на европейских номерах; Mini Program для китайской общины Малайзии — на малайзийских. WeChat может по-разному относиться к аккаунтам из разных регионов, и ваш тест должен отражать то, что видят реальные пользователи. Цены различаются по странам и возвращаются в реальном времени.

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

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

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

Полное описание находится в документации.

Что должен делать обработчик вебхука для кодов WeChat?

Можно зарегистрировать до 5 эндпоинтов на аккаунт. Каждый запрос содержит X-OTPRoute-Signature: t=<unix>,v1=<hex>. Восстановите подпись как HMAC-SHA256 от <t>.<raw body> с секретом этого эндпоинта, сравните за постоянное время и отклоняйте метки времени старше нескольких минут.

Сделайте обработчик идемпотентным: записывайте код по id активации, чтобы повторная доставка не вызывала ничего нового. Слушайте также activation.expired и activation.cancelled, чтобы тестовые прогоны завершались чисто, а не зависали. Наше руководство по защите OTP-вебхуков показывает проверку шаг за шагом. Опрос — хороший запасной вариант для одного ручного теста; вебхуки лучше масштабируются, когда параллельно идёт много задач.

Можно ли сделать то же самое из панели?

Да. В панели OTP Route откройте OTP Gateway, выберите WeChat и страну, проверьте показанную цену и подтвердите заказ. Вставьте номер в WeChat, запросите код и следите за страницей заказа: SMS появится там после доставки. Это подходит сотрудникам операционных отделов, которые один раз настраивают бизнес-аккаунт и больше не трогают API.

Почему код WeChat может не прийти?

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

Обычные причины тишины:

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

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

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

Временный номер принимает один код. Если стейджинговому аккаунту WeChat нужно войти снова в следующем месяце или служба поддержки пользуется общим бизнес-логином, номер должен оставаться у вас. Это дают Dedicated Numbers: они доступны в США и Канаде от $1.95/month, входящие SMS видны в панели и приходят на ваш вебхук через number.sms_received. В других странах самостоятельного долгосрочного варианта нет; напишите на [email protected], чтобы уточнить.

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

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

Можно ли использовать виртуальный номер для тестирования регистрации в WeChat?

Часто да, но не всегда. WeChat может отклонять некоторые виртуальные номера или требовать дополнительные проверки; если код не пришёл, активация возвращается.

Какой id у WeChat в API?

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

Почему WeChat просит существующего пользователя подтвердить мой новый аккаунт?

Это шаг безопасности WeChat, отдельный от SMS. Номер телефона сам по себе не может его выполнить.

В скольких странах поддерживается SMS-верификация WeChat для тестирования?

Сейчас маршруты WeChat есть в 198 странах. Проверяйте актуальный список перед заказом, так как наличие меняется в течение дня.

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

Коды стоят от $0.20 за код; точная цена зависит от страны и показывается до заказа. Вы платите, только если код пришёл.

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

Да, с Dedicated Number в США или Канаде от $1.95/month. Временные активации рассчитаны только на один код.

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

Попросите поддержку переключить аккаунт разработки в sandbox, который возвращает имитированные номера и коды для сквозных тестов.

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