ガイド · SMS API

チャットボット・AI エージェント向けSMS API認証

要点

あなたの AI エージェントが Cash App、Coinbase、Tinder、銀行アプリ、その他の2要素認証（2FA）フロー用の SMS 認証コードをリアルな米国キャリア番号で受信する必要があります。Twilio などの VoIP ではこれらの認証が拒否されてしまいます。ここでは、MeiSIM の Webhook API を使用してチャットボットやエージェントをリアル SMS 受信に接続する方法を説明します。

API キーを取得

無料で5つの番号。Webhook 配信は3秒以下。

API を見る →

フローの概要

あなたのエージェントが Webhook URL を指定して POST /v1/numbers/provision を呼び出します。
約60秒後、あなたのエージェントはリアルな米国電話番号を取得します（eSIM QR、ICCID、LPA がレスポンスに含まれます）。
エージェントがこの番号を使用して Cash App、Coinbase などにサインアップします。
サインアップサービスがこの番号に確認用 SMS を送信します。
MeiSIM がキャリアネットワーク経由で SMS を受信します（約1秒）。
MeiSIM があなたの Webhook URL にメッセージを POST します（さらに約1～2秒）。
あなたのエージェントが本文を読み、認証コードを抽出して、サインアップを完了します。

Webhook コントラクト

JSON ボディを URL に POST します。10秒以内に HTTP 200 で確認応答してください。失敗またはタイムアウト時は、指数バックオフでリトライします（即時、+15秒、+60秒、+300秒 — 6分間に合計4回試行）。メッセージは 30 日間 messages エンドポイント経由でクエリ可能です。

POST https://your-agent.com/sms Content-Type: application/json X-MeiSIM-Signature: t=1716...,v1=hmac-sha256-of-body { "event": "sms.received", "number_id": "num_01HXY3...", "phone": "+14155551234", "from": "245-78", "text": "Your Cash App code is 583921. Don't share.", "received_at": "2026-05-19T14:23:01Z" }

Polling フォールバック

Webhook エンドポイントを維持する代わりに polling を選択することもできます（ステートレスなエージェントでよく使われます）。以下を呼び出します：

GET /v1/numbers/{id}/messages?since=2026-05-19T14:22:00Z Authorization: Bearer YOUR_API_KEY → { "messages": [{ "from": "245-78", "text": "Your Cash App code is 583921", "received_at": "..." }, ...] }

ほとんどのエージェントは認証待ち中に2～3秒ごとに polling します。認証 SMS は通常30秒以内に到着します。失敗した試行は再試行前に最大5分かかる場合があります。

OTP コードの抽出

SMS本文はサービスごとに異なりますが、認証コードは常に4～8桁の数字です。ほとんどのエージェントは正規表現 /\b\d{4,8}\b/ を使用して抽出します。より高い信頼性のために、LLM（Claude または GPT-4o）に SMS テキストを読ませてコードのみを返すようにしてください — ミリ秒単位で処理完了します。

認証とセキュリティ

すべての Webhook POST は HMAC-SHA256 で署名されています。あなたの API シークレットを使用して X-MeiSIM-Signature を検証し、本当に私たちからのリクエストであることを確認し、スプーファーではないことを確認してください。コードサンプルは API ドキュメントを参照してください。

今夜構築

API キー + 最初の5つの番号は無料。メールでお気軽にお問い合わせください。

メール →

よくある質問

SMS が Webhook に届くまでどのくらい時間がかかりますか？

中央値で3秒以下です。失敗時は指数バックオフでリトライします。メッセージは 30 日間保存され、polling フォールバックで取得できます。

Webhook ではなく polling だけで受信できますか？

はい。GET /v1/numbers/{id}/messages でクエリできます。since_iso で特定時刻以降のみ取得できます。ほとんどのエージェントは認証待ち中に 2～3秒ごとに polling しています。

ショートコード（5桁）からの SMS も受信できますか？

はい — これが VoIP からリアルキャリア番号への切り替えの主な理由です。ほとんどの銀行・暗号資産・出会い系アプリの認証 SMS はショートコード経由で送信されており、VoIP ではブロックされます。

MMS（画像付き）にも対応していますか？

現在は SMS のみです。MMS はロードマップに含まれています。

1つの番号に複数の Webhook を設定できますか？

いいえ。番号ごとに1つの Webhook です。複数配信の場合は自分のディスパッチャーを使用してください。

API レート制限はありますか？

API キーごとに毎分100回の provisioning 呼び出し、毎秒10回の messages API 呼び出し。ほとんどのエージェントはこの範囲内で快適に動作します。

複数のエージェントで同じ電話番号を使用できますか？

はい。複数エージェントが同じ番号を共有する場合、メッセージは全エージェントの Webhook に配信されます。相互干渉はありません。

認証コード抽出の精度は？

ほとんどのサービスは4～8桁です。正規表現 /\b\d{4,8}\b/ で95%以上の精度です。Claude や GPT-4o に読ませると99%以上の精度が得られます。

SMS が全く届かない場合はどうなりますか？

ダッシュボードで SMS 受信履歴を確認できます。受信ログがない場合は、サービス側の配信制限または番号の問題の可能性があります。サポートに問い合わせてください。

複数国の認証 SMS に対応していますか？

現在は米国の電話番号のみ提供しています。米国からの認証 SMS は全サービスで受信可能です。

何個まで API キーを作成できますか？

アカウントごとに無制限です。本番・テスト環境で分けることをお勧めします。

Webhook のセキュリティはどのように担保されていますか？

すべての Webhook POST は HMAC-SHA256 署名付きです。X-MeiSIM-Signature を API シークレットで検証してください。

SMS の保存期間は？

30 日間保存。polling で過去のメッセージを取得可能です。

Webhook がタイムアウトしたらメッセージは失われますか？

いいえ。30 日間保存され、polling で後から取得できます。

複数アカウント作成に使用できますか？

当社のサービスは正規の 2FA 認証と業務オートメーション用途を想定しています。利用規約違反の使用はお断りしています。