チームがテストと運用でWeChatのSMSコードを受け取る方法

WeChatの認証は、他のメッセージングアプリとどう違いますか?

WeChatは単なるチャットアプリではありません。多くのユーザーにとっては、ウォレットであり、ミニプログラムを通じた店舗の入口であり、中国の企業と接点を持つ主要なチャネルでもあります。そのため、アカウントの確認は他のアプリより厳しく、WeChatの電話番号は単なるログインIDより重い意味を持ちます。

このアプリは、いくつかの場面でSMSコードを使います。

• 登録: 電話番号がアカウントの主たる識別子になります。
• 新しい端末でのログイン: 他の確認と組み合わされることが多いです。
• 紐づけた番号の変更や復旧。
• セキュリティ審査: SMS以上のものを求められる場合があります。WeChatは、既存ユーザーによる承認やその他の本人確認の手順を要求することがあり、どのプロバイダーの番号でも、これらを代わりに満たすことはできません。

WeChatのミニプログラム、公式アカウントの連携、越境サポートデスクを構築するチームは、テスト用アカウントをその場で作るのではなく、慎重に計画する必要があります。

WeChatのSMSコードを受信できるのはどの国ですか?

WeChatのルートは現在198か国で提供されています。例として、中国、香港、シンガポール、マレーシア、アメリカ、カナダのほか、台湾、マカオ、タイ、ベトナム、インドネシア、フィリピン、オーストラリア、イギリス、ドイツ、バングラデシュがあります。

最も安いルートではなく、テストするケースに合う国を選んでください。ヨーロッパで中国人観光客に対応するサポートデスクなら、ヨーロッパの番号でテストし、マレーシアの華人コミュニティ向けのミニプログラムなら、マレーシアの番号でテストします。WeChatは地域ごとにアカウントの扱いを変える場合があり、テストは実際のユーザーが目にするものを反映すべきです。料金は国によって異なり、最新の価格が取得できます。

WeChat認証コードAPIのフローはどう動きますか?

呼び出しは、Developer consoleで作成したor_live_のBearerキーを付けてhttps://otproute.com/api/v1に送ります(キーは最大10個、1分あたり300リクエスト)。

1. GET /api/v1/servicesでサービスIDwechatを、GET /api/v1/countriesで国IDを確認します。
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_receivedWebhookからコードを受け取るか、数秒おきにGET /api/v1/activations/{id}をポーリングします。
6. テストを途中で止める場合は、POST /api/v1/activations/{id}/cancelを呼び出します。

完全なリファレンスはドキュメントにあります。

WeChatのコードを処理するWebhookハンドラーは、何をすべきですか?

1アカウントにつき最大5つのエンドポイントを登録できます。各リクエストにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付きます。そのエンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256として署名を再構築し、定数時間で比較し、数分より古いタイムスタンプは拒否してください。

ハンドラーは冪等にします。コードをアクティベーションIDに対して書き込むので、再送された配信で新しい処理が起こることはありません。またactivation.expiredとactivation.cancelledも受け取るようにして、テストの実行が待ち続けることなくきれいに終わるようにします。確認の手順は、OTP Webhookの保護のガイドで順を追って示しています。1回きりの手動テストにはポーリングで十分ですが、多くのジョブを並列に動かす段階では、Webhookのほうが拡張しやすくなります。

代わりにダッシュボードから操作できますか?

できます。OTP Routeのダッシュボードで、OTP Gatewayを開き、WeChatと国を選び、表示された価格を確認して注文します。WeChatに番号を貼り付けてコードを要求し、注文ページを見ていると、SMSが届いた時点でそこに表示されます。ビジネスアカウントを一度だけ設定し、APIには触れない運用担当者に向いています。

WeChatのコードが届かないのはなぜですか?

各アクティベーションは20分間有効で、コードは1件を受け取れます。支払うのはコードが届いた場合のみで、ウィンドウが何も届かないまま閉じた場合やキャンセルした場合は、料金が自動的にウォレットに戻ります。

反応がない主な理由は次のとおりです。

• WeChatがバーチャル番号を拒否した、またはSMSだけでは満たせない追加の認証を求めた。
• 選んだルートが混んでいる。時間をおいて再試行するか、ケースに合う別の国でテストします。
• リクエストがそもそも送信されなかった。アプリが先にキャプチャやセキュリティの確認を表示したことが原因のことが多いです。

注文し直す前にウィンドウが終わるまで待ち、続けての再試行は避けてください。ほかのヒントは失敗するOTP配信を減らすにあります。

ワンタイムコードより専用番号が適しているのは、どんなときですか?

一時番号が受け取れるのは1つのコードだけです。ステージング用のWeChatアカウントが来月またサインインする必要がある場合や、サポートチームがビジネス用のログインを共有する場合は、その番号を手元に残さなければなりません。専用番号(Dedicated Numbers)がそれを実現します。米国とカナダで利用でき、月額$1.95から。受信SMSはダッシュボードと、number.sms_received経由のWebhookで受け取れます。それ以外の国にはセルフサービスの長期オプションはありません。ご希望の場合は [email protected] までメールでお問い合わせください。

WeChatのアカウントはすべて、WeChatの規約に沿って使ってください。アカウントは実在する1人または1事業者につき1つとし、自社の正当なプロダクトのために作成します。WeChatはその権利者の商標であり、OTP Routeとは提携関係にありません。当社の利用規定(Acceptable Use Policy)が適用されます。

よくある質問

WeChatのサインアップテストにバーチャル番号を使えますか?

多くの場合は使えますが、常にではありません。WeChatが一部のバーチャル番号を拒否したり、追加の確認を求めたりすることがあります。コードが届かなかった場合、アクティベーションは返金されます。

APIでのWeChatのサービスIDは何ですか?

wechatです。料金の呼び出しと、アクティベーションのリクエストボディで使います。

WeChatは、なぜ新しいアカウントを既存ユーザーに承認してもらうよう求めるのですか?

それはSMSとは別のWeChatのセキュリティ手順です。電話番号だけでは完了できません。

WeChatのSMS認証をテストで利用できる国はいくつありますか?

現在198か国にWeChatのルートがあります。空き状況は一日の中で変わるため、注文前に最新の一覧を確認してください。

WeChatのOTPを受け取るのに、費用はいくらかかりますか?

コードは1件$0.20〜で、正確な料金は国によって異なり、注文前に表示されます。支払うのはコードが届いた場合のみです。

今後のログインのために、同じWeChat用電話番号を保持できますか?

はい。月額$1.95からの米国またはカナダの専用番号を使えば可能です。一時的なアクティベーションで受け取れるのは1つのコードだけです。

お金をかけずにWeChat連携をテストできますか?

サポートに依頼して開発アカウントをサンドボックスに切り替えると、エンドツーエンドのテスト用に疑似的な番号とコードが返されます。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。