テスト用KakaoTalk SMS認証:チェックリスト、手順、対処法

プロダクトチームが、テストにKakaoTalkの電話番号を必要とするのはなぜですか?

KakaoTalkは韓国で圧倒的なシェアを持つメッセンジャーで、そのアカウント基盤はチャットをはるかに超えて広がっています。韓国の多くのアプリがサインイン方法としてカカオログインを提供しているため、その市場向けに開発するチームは、自社のログインボタンをテストするためだけにも、動作するKakaoアカウントが必要になることがよくあります。

KakaoTalkは登録を電話番号に紐づけています。新規インストールでは番号を尋ねられ、SMSコードで確認され、新しい端末に移行するときにも同じ確認が繰り返されます。紐づけられたKakaoアカウントは、復旧や追加のサインイン保護にも、電話番号を使った手順を利用できます。QAでは、初回登録、新しい端末やエミュレーターでの再認証、復旧の経路という、3つの異なるフローを網羅する必要があります。そのいずれかにスタッフ個人の電話を使うと、私的な番号がテストアカウントに漏れてしまいます。KakaoTalk向けのバーチャル番号は、この問題を解決します。

最初のKakaoTalk注文の前の事前チェックリスト

各項目を一度確認すれば、あとは同じ設定を実行のたびに使い回せます。

• 規約を守る目的であること。 実在する1人または1事業者につき1アカウントとし、自社のプロダクトのテストや運用に使います。OTP Routeは、大量の、または使い捨てのアカウントを作るためのものではなく、KakaoTalkの規約は常に適用されます。
• or_live_キー。 Developer consoleで発行し、使用するパイプラインに限定します。
• サービスIDkakaotalkと、GET /api/v1/countriesで取得した国ID。
• インストール用のクリーンな端末またはエミュレーター。 古いセッションが残っていて、電話番号の手順が飛ばされることがないようにします。
• 注文の前に用意しておくWebhookエンドポイントまたはポーリングの補助処理。 20分のウィンドウはすぐに始まるためです。
• アカウントの今後についての判断。 来月またログインする必要があるなら、先に下の専用番号(Dedicated Number)の項目をお読みください。

KakaoTalkのOTPを受信できるのはどの国ですか?

kakaotalkのルートは198か国で提供されています。例として、韓国、日本、ベトナム、フィリピン、モンゴルのほか、インドネシア、タイ、マレーシア、台湾、香港、カザフスタン、ウズベキスタン、オーストラリア、ドイツ、イギリス、アメリカ、カナダがあります。

テストするシナリオに合う国を選んでください。韓国市場での立ち上げのチェックリストには+82の番号が必要です。韓国のサービスを利用する海外ユーザーをオンボーディングがどう扱うかを確認するテストは、実際の顧客がいる国から行うほうが適切です。ルートごとの空き状況は一日の中で変わるため、注文のたびにAPIで確認してください。トレードオフはOTPの国別ルーティングで説明しています。

手順:KakaoTalk認証コードAPI

リクエストは、Bearerキーを付けてhttps://otproute.com/api/v1に送ります。上限は1分あたり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. コードを待ちます。Webhookで受信する側はactivation.sms_receivedを受け取り、ポーリングする側は数秒おきにGET /api/v1/activations/{id}を呼び出します。
6. 実行を取りやめる場合は、POST /api/v1/activations/{id}/cancelを送ります。

Webhook側では、X-OTPRoute-Signatureをt=<unix>,v1=<hex>として解析し、エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を計算し、定数時間で比較し、古いタイムスタンプは拒否します。配信は繰り返されることがあるため、処理済みのアクティベーションIDを記録して、ハンドラーを冪等にします。activation.expiredとactivation.cancelledは最終状態として扱ってください。すべてのフィールドはAPIドキュメントにまとめています。

ダッシュボードからの手順

1. OTP Gatewayを開き、KakaoTalkを検索します。
2. 国を選びます。確定する前に価格が表示されます。
3. テスト端末のKakaoTalkアプリに番号をコピーします。
4. 注文カードでコードを確認して、登録を完了します。

SMSが届かないまま20分が経過した注文は終了し、全額返金されるので、支払うのは届いたコードの分だけです。

KakaoTalkのSMS認証が届かない場合のトラブルシューティング

• KakaoTalkが番号を拒否した。 一部のバーチャル番号を拒否することがあり、その挙動はいつでも変わる可能性があります。返金でその試行分はカバーされるので、別の国のルートを試してください。
• アプリが古いセッションを再利用した。 アプリのデータを消去するか、新しいエミュレーターを使って、電話番号の手順で実際に新しいコードが送信されるようにします。
• 短時間に試行しすぎた。 KakaoTalkは多くのメッセンジャーと同様に、繰り返されるリクエストを制限します。ループで注文し直さず、再試行の間隔を空けてください。
• 早すぎるキャンセル。 注文をあきらめる前に、20分のウィンドウが終わるまで待ってください。

より広いパターンについては、失敗するOTP配信を減らすをご覧ください。

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

ワンタイムのOTP Gateway番号は、テスト後に捨てて構わない1回きりの登録に向いています。QAチームが新しい端末で何度も開き直す必要のあるKakaoアカウントや、サポートスタッフが共有するビジネスアカウントには、後からも手元で管理できる番号が必要です。OTP Routeの専用バーチャル番号(Dedicated Virtual Numbers)は、米国とカナダでその役割を果たし、月額$1.95から。受信SMSはダッシュボードと、number.sms_receivedとしてWebhookに届きます。この2か国以外には、セルフサービスの長期番号はありません。ご希望の場合は [email protected] までメールでお問い合わせください。

支払いはすべて前払いのUSDウォレット1つから行い、カードまたはUSDT/USDCでチャージします。月額料金はなく、PDFの請求書がメールで届きます。連携作業向けには、疑似的なコードを使えるサンドボックスモードも、申請により利用できます。KakaoTalkはその権利者の商標であり、OTP Routeとは提携関係にありません。

よくある質問

自社アプリのカカオログインのテスト用に、KakaoTalkのOTPを受け取るには?

OTP Gatewayでkakaotalkサービスの番号を注文し、その番号でテストアカウントを登録して、ダッシュボードかAPIでコードを確認します。

KakaoTalkのテストアカウントには、どの国を選ぶべきですか?

テストする市場に合わせてください。韓国での立ち上げなら韓国を、海外ユーザーをテストするなら、その顧客がいる国を選びます。

KakaoTalkはすべてのバーチャル番号を受け付けますか?

いいえ。KakaoTalkが一部のバーチャル番号を拒否することがあります。20分のウィンドウ内にコードが届かなかった場合、料金はウォレットに戻ります。

あとから同じKakaoTalkアカウントに再度ログインできますか?

ワンタイム番号はそれに向きません。アカウントに引き続きアクセスできる状態を保つ必要があるなら、米国またはカナダの専用番号(月額$1.95から)を使ってください。

KakaoTalkのコードには、Webhookとポーリングのどちらを使うべきですか?

並列のジョブにはWebhookが拡張しやすく、単一のスクリプトにはGET /api/v1/activations/{id}のポーリングのほうが簡単です。ジョブごとにどちらか一方を使い、両方は使わないでください。

マーケティングのために、複数のKakaoTalkアカウントを作成できますか?

いいえ。OTP Routeは、自社の正当なアカウントやプロダクトのテストと運用のためのもので、利用規定(Acceptable Use Policy)とKakaoTalkの規約の両方が適用されます。

OTP RouteでのKakaoTalkのコードの料金はいくらですか?

料金は1コード$0.20〜で、国によって異なります。最新の金額は料金ページとAPIで確認できます。

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