日本語
テストと運用のためのグアテマラ（+502）認証番号
はい、OTP Route は OTP Gateway のワンタイムの番号でグアテマラ（+502）の SMS 認証コードを受信でき、各コードはダッシュボードで読み取るか、API と署名付き Webhook で取得できます。料金は 1 コード $0.20 からで、各サービスのライブ価格は注文前に表示され、20 分以内に何も届かなければ請求額はウォレットに戻ります。
グアテマラで専用のテスト実行が必要なのはなぜか？
グアテマラは中米で最も人口が多い国で、多くのチームにとって、スペイン語圏の地域展開で最初の市場になります。公用語はスペイン語ですが、人口の多くはマヤ諸語のいずれかも話しており、オンボーディングの文言やサポートコンテンツがスペイン語を超える場合は重要です。
次の 3 つの状況が繰り返し出てきます。
- 地域ローンチ。 実際の +502 ルートで、電話番号の入力画面、スペイン語の SMS の文言、認証ステップを確認する必要がある場合（モバイルアプリの認証）。
- ディアスポラ向けプロダクト。 米国に住むグアテマラ人が使う送金や通話のアプリなど、アカウントが母国の番号に紐づく場合。
- 運用チーム。 誰かの個人の電話を紐づけたくないグアテマラのクライアントのために、ビジネスプロファイルを管理する場合（運用チーム）。
グアテマラの電話番号はどう整形されるか？
グアテマラの国内番号は 8 桁で、トランクプレフィックスはない ため、取り除く先頭のゼロもありません。E.164 形式は +502 にその 8 桁を続けるだけで、+502 xxxx xxxx と書きます。
この短さは、10 桁の北米の番号を想定して書かれたフォームのバリデーターをつまずかせます。8 桁の入力、プラス記号なしで 502 を入力するユーザー、途中にスペースやハイフンが入るケースのテストを追加してください。正規化した E.164 文字列を保存し、携帯か固定かを桁数だけで推測するのは避けてください。どちらも同じ 8 桁だからです。
API でグアテマラの SMS OTP コードを受信できるか？
はい。グアテマラ OTP API は、ベース URL https://otproute.com/api/v1 に対して国 ID gt を使い、or_live_ プレフィックスの Bearer キーで認証します。
まず GET /api/v1/services でサービス ID を調べ、GET /api/v1/prices?country=gt&service=<id> で現在の見積もりを確認します。番号は、POST /api/v1/activations とボディ {"service": "<id>", "country": "gt"} で作成します。アプリが SMS を送信したら、GET /api/v1/activations/{id} をポーリングするか、Webhook エンドポイントで activation.sms_received を受信します。OTP Webhook の保護で説明しているとおり、X-OTPRoute-Signature ヘッダー（タイムスタンプと生のボディに対する HMAC-SHA256）を検証し、古いタイムスタンプは拒否してください。上限は開発者向けの概要に記載されています。キー 10 個、Webhook エンドポイント 5 個、1 分あたり 300 リクエストです。
現在 +502 のルートにあるサービスは？
グアテマラには、1,600 を超えるサービスが掲載されています。人気のあるものの直近のスナップショットには、WhatsApp、Facebook、TikTok、Telegram、Instagram、Google (Gmail & YouTube)、X (Twitter)、Uber、Amazon、Discord、LinkedIn、Signal、Netflix、Microsoft & Outlook が含まれます。在庫は一日の中で入れ替わるため、API は固定のカタログではなく、ライブの提供状況を返します。
サポートや運用のスタッフ向けに、コード不要の方法はあるか？
メールアドレスと 6 桁のコード、または Google ログインでサインアップすれば、チームの誰でもダッシュボードから注文できます。グアテマラを選び、サービスを選択し、表示された価格を確認して、+502 の番号をアプリにコピーします。コードは届いたときに同じ画面に表示されます。共有のチームアクセスがあるなら、OTP Route アカウント自体に二要素認証（TOTP）を有効にしておくのが賢明です。
+502 のコードが表示されなかったのはなぜか。何を試すべきか？
番号は 20 分間有効で、課金されるのはコードが配信されたときだけです。期間が終了した場合、またはキャンセルした場合は、全額が自動的にウォレットに戻ります。
- 有効期間が終わるまで待ちます。配信にかかる時間はサービスとルートによります。
- 時間をおいて、または、提供されていれば別のサービスルートで再試行します。
- サービスが仮想番号を受け付けるか確認します。拒否するものもあります。
- 新しい注文を短い間隔で連発せず、試行の間にバックオフを入れます。
グアテマラの長期番号、請求、サンドボックスについては？
OTP Route には、セルフサービスで取得できるグアテマラの長期番号はありません。専用回線は米国とカナダのみで、月額 $1.95 からです。長期の +502 回線が必要な場合は、[email protected] にメールしてください。何か手配できるかどうかは現地の規則によるため、保証はできません。
支払いは、プランも月額料金もない、プリペイドの USD ウォレット 1 つで行い、カードまたは USDT/USDC でチャージして、チャージごとに PDF 請求書がメールで送られます。連携作業のために、開発用アカウントは依頼によりサンドボックスに切り替えられ、シミュレートされた番号とコードが、無料でコードに流れます。
よくある質問
現地の SIM なしで、グアテマラ向けのスペイン語のサインアップを確認できますか？
はい。OTP Gateway で gt の番号を注文してアプリに入力し、スペイン語のコードをダッシュボードまたは Webhook から読み取ります。
グアテマラの番号には先頭のゼロが必要ですか？
いいえ。グアテマラにはトランクプレフィックスがないため、番号は +502 に 8 桁を続けたものだけです。
+502 のコードの最低価格はいくらですか？
料金は 1 コード $0.20 からで、特定のサービスの金額は GET /api/v1/prices が返し、確定前に表示されます。
認証 SMS が届かなかった場合、課金されますか？
いいえ。20 分の有効期間内にコードが配信されなかった場合、またはキャンセルした後は、全額がウォレットに戻ります。
OTP Route は、チーム向けに同じ +502 番号を長期間保持できますか？
セルフサービスではできません。OTP Gateway の番号は 1 件のコード用で、長期回線は米国とカナダのみのため、グアテマラについては [email protected] にお問い合わせください。
これらの番号の使い方には、どんなルールが適用されますか？
各サービス自身の利用規約と、OTP Route の利用規定（Acceptable Use Policy）です。番号は、自社の正当なプロダクトとビジネスアカウントのテストや運用にのみ使ってください。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。