テスト用Snapchat SMS認証:チェックリスト方式のワークフロー

Snapchatの番号を注文する前の事前チェックリスト

このリストを一度確認しておけば、失敗の大半は事前に防げます。

• APIキーの準備。 Developer consoleでor_live_キーを作成します(最大10個まで保持できます)。
• ウォレットのチャージ。 前払いのUSD残高は1つで、カードまたはUSDT/USDCでチャージします。
• Webhookエンドポイントの登録(1アカウントにつき最大5個)と、署名検証の実装済みであること。
• テストケースに合う国の選択。 たとえば、Snapchatアカウントやキャンペーンが対象とする地域です。
• 規約の確認。 Snapchat自身の利用規約とOTP Routeの利用規定(Acceptable Use Policy)の両方が、すべての注文に適用されます。
• サンドボックスの検討。 初回の連携テストでは、サポートに依頼して開発アカウントをサンドボックスに切り替えると、疑似的な番号とコードを無料で使えます。

Snapchatは電話番号を何に使いますか?

Snapchatはアカウント作成時に電話番号を求めることがあり、確認のためSMSでコードを送信します。その番号は、ログインやパスワードを忘れたときの再設定にも使われることがあります。また二要素認証にも対応しており、SMSは第2段階の選択肢の1つです。ブランド、代理店、開発者にとっては、電話番号がアカウントの復旧経路の一部になるということであり、どの種類の番号を選ぶべきかに影響します。

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

OTP Routeでは現在、197か国でSnapchatにルーティングできます。たとえば、アメリカ、イギリス、オーストラリア、カナダ、フランス、サウジアラビアのほか、ドイツ、オランダ、ノルウェー、スウェーデン、メキシコ、ブラジル、インド、日本、クウェート、アラブ首長国連邦があります。アカウントの実際の市場を反映する国を選んでください。番号の国とアカウントの地域が一致しないと追加の確認が入りやすくなり、ローカライズのテストも、国番号が一致していなければ意味がありません。

手順:Snapchat認証コードAPI

1. 空き状況と料金を確認します:GET /api/v1/prices?country=<id>&service=snapchat。
2. 番号を確保します:POST /api/v1/activationsに{"service": "snapchat", "country": "<id>"}を送ります。
3. 返された番号をSnapchatの電話番号欄に入力し、コードを要求します。
4. Webhookでactivation.sms_receivedを受け取るか、GET /api/v1/activations/{id}を控えめな間隔でポーリングします。
5. 不要になった実行はPOST /api/v1/activations/{id}/cancelで中止します。止まってしまったSnapchatのテストが番号を確保したままにならないようにするためです。

すべての呼び出しは、ベースURLhttps://otproute.com/api/v1、Bearer認証、1分あたり300リクエストの上限が前提です。各フィールドはドキュメントにまとめています。

Webhookハンドラーはどう実装すべきですか?

各配信にはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付きます。タイムスタンプ、ドット、生のリクエストボディをエンドポイントのシークレットでHMAC-SHA256として再計算し、定数時間で比較し、古いタイムスタンプのリクエストは破棄します。そのうえでハンドラーを冪等にしてください。アクティベーションIDをキーにすれば、再送された配信でテストの手順が二重に実行されることはありません。より詳しい手順はHMACによるOTP Webhookの保護にあります。外部からの受信を受け付けられないローカル環境では、ポーリングも十分に使えるフォールバックです。

開発者でない人向けのダッシュボード操作

ソーシャルメディア担当者は、APIをまったく使わなくても構いません。サインインしてOTP Gatewayを開き、Snapchatと国を選び、価格を確認して注文を確定します。番号をSnapchatにコピーしてSMSを要求すると、コードが注文の横に表示されます。APIの場合と同じ20分のウィンドウと返金ルールが適用されるため、うまくいかなかった試行に費用はかかりません。1つのログインを同僚と共有する代理店は、受け渡す前にOTP Routeアカウントで二要素認証(TOTP)を有効にしてください。

トラブルシューティング:Snapchatのコードが届かない

• ウィンドウが終わるまで待つ。 配信時間はSnapchatとルートによるため、決まった目安はありません。
• 時間をおいて再試行するか、別の国のルートを使う。 連続で注文し直さないでください。
• ときどき拒否されることを想定する。 Snapchatは多くのアプリと同様に、バーチャル番号を拒否することがあります。その場合はコードが届かず、ウィンドウが閉じるかキャンセルした時点で、全額がウォレットに戻ります。

失敗するOTP配信を減らすでは、バックオフのパターンも紹介しています。

専用番号のほうが適しているのは、どんなときですか?

ワンタイム番号は、1回のサインアップテストに向いています。数か月後にログインや復旧が必要になるブランドアカウントは、自社で保持する番号に紐づけてください。米国とカナダの専用番号(Dedicated Numbers)は月額$1.95からで、SMSをダッシュボードとnumber.sms_receivedWebhookで受信できます(バーチャル番号)。どちらを選ぶ場合でも、アカウントは実在する1人または1事業者につき1つとし、OTP Routeは自社の正当なプロダクトとアカウントにのみ使用してください。

よくある質問

スタッフの電話なしで、自社アプリのSnapchatログイン連携をテストできますか?

はい。snapchatのアクティベーションを注文し、テスト中にその番号を使うと、コードがWebhookまたはダッシュボードに届きます。

Snapchat用のバーチャル番号は、必ず受け付けられますか?

いいえ。Snapchatはバーチャル番号を拒否することがあります。20分のウィンドウ内にコードが届かなければ返金されるのはそのためです。

Snapchatのコードの料金はいくらですか?

1コード$0.20〜です。国ごとの最新料金はGET /api/v1/pricesで取得でき、注文前にも表示されます。

後でSnapchatアカウントを復旧するために、同じ番号を再利用できますか?

OTP Gateway番号は1コード限りのため、できません。継続的なアクセスが必要なアカウントには、米国またはカナダの専用番号を使ってください。

SnapchatのSMS認証のテストでは、ポーリングとWebhookのどちらを使うべきですか?

Webhookはレート制限への負荷が軽く、イベントにも素早く反応できます。ポーリングは、公開URLのないノートPCでは手軽です。どちらも同じコードが返ります。

OTP RouteはSnapchatと提携していますか?

いいえ。Snapchatはその権利者の商標であり、OTP Routeは独立したルーティングサービスです。

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