SMS8 API 開発者の皆様へ。
SMS8 APIで送信したSMSとMMSは、お客様ご自身のスマートフォンから送られます。すべてのエンドポイントで使えるAPIキー1つ、返信と配信レポートのWebhook、Node向けSDK、すぐに使えるPHPとC#のクラス、AIエージェント向けのMCPサーバーをご用意しています。

npm install sms8-sdkclaude mcp add --transport http sms8 https://mcp.sms8.ioSMS8_API_KEY=your_api_key npx -y sms8-sdk mcphttps://mcp.sms8.ioClaude Desktop:設定、コネクタ、カスタムコネクタを追加
APIのしくみ
すべてのリクエストはapp.sms8.ioに送られます。APIキーと必要な項目をシンプルなフォームのPOSTで送信すると、成功フラグとメッセージの詳細を含むJSONが返されます。
その裏で、メッセージはペアリングしたAndroidスマートフォンに届き、そのスマートフォンが自身のSIMから送信します。返信と配信レポートも同じ経路でお客様に戻ります。
APIに人為的なレート制限はありません。実際の処理量はSIMによって決まります。より多く送るには、スマートフォンを追加するか、デュアルSIMのスマートフォンをお使いください。
できること
用途ごとにエンドポイントが1つあります。すべての項目は完全なリファレンスに記載しています。
SMSとMMSの送信
1通のメッセージ、多数の宛先へのバッチ、保存済みの連絡先リストへの一斉配信を送れます。画像のリンクを加えればMMSになります。予約送信や、待機列の先頭に割り込む設定もできます。
送信元の選択
1台のスマートフォンとSIMから送るか、すべてのスマートフォンで順番に送るか、メッセージごとにランダムに選んで負荷を分散できます。
確認と再送
IDでメッセージを検索して状況を確認できます。失敗したメッセージは1回の呼び出しで待機列に戻せます。
OTPコード
ワンタイムコードを送信し、ユーザーが入力した内容を確認します。受信者を守るため、コードは電話番号ごとに1日の上限があります。
デバイスと連絡先
ペアリングしたスマートフォンとそのSIMを一覧表示します。名前、タグ、カスタム項目付きで連絡先を作成または更新できます。
USSD
残高確認などのキャリアのUSSDコードを、ペアリングしたスマートフォンから送信し、その応答を読み取れます。
認証とレスポンス
アカウントごとにキーは1つ。どの呼び出しでもレスポンスの形は同じです。
キーの場所
キーはSMS8ダッシュボードのAPIページに表示されます。キーはパスワードと同じように扱い、公開のWebページではなくサーバーに保管してください。
キーの送り方
OpenAPIファイルにあるとおり、X-Api-Keyヘッダーに入れます。AuthorizationヘッダーのBearerトークンや、keyという名前のフォーム項目でも使えます。
返ってくる内容
成功フラグ付きのJSONです。成功時はメッセージやレコードが、失敗時はコードと短いメッセージ付きのエラーが返されます。
フラグを確認
項目の誤りやクレジット不足など、一部のエラーは通常のレスポンスの中で返されます。結果を信頼する前に成功フラグを確認してください。
キーが誤っている場合
キーがない、または無効な場合は401が返されます。項目の不足や形式の誤りには400が返されます。
エンドポイント一覧
すべてapp.sms8.io配下にあります。各エンドポイントの正確な項目はOpenAPIファイルに記載しています。
| パス | メソッド | 内容 |
|---|---|---|
| /api/v1/messages | POST | 1人またはバッチでSMSやMMSを送信 |
| /api/v1/messages/read | POST | 送受信したメッセージを番号、方向、日付で絞り込んで一覧表示 |
| /api/v1/messages/resend | POST | 失敗したメッセージをIDで再送 |
| /api/v1/devices | GET | ペアリングしたスマートフォンをバッテリー、電波、SIM、最終接続時刻とともに一覧表示 |
| /api/v1/contacts | POST | タグとカスタム項目付きで連絡先を作成または更新 |
| /api/v1/ussd/send | POST | ペアリングしたSIMからUSSDコードを実行し、キャリアの応答を取得 |
| /api/v1/ussd/list | POST | 最近のUSSDセッションを一覧表示 |
メッセージ送信の項目
必須なのは番号と本文だけです。そのほかの項目には初期値があります。
番号と本文
番号は+14155550100のような国際形式で指定します。本文は1,000文字まで書け、{first_name}などの差し込みタグを使えます。
SMSまたはMMS
種類の初期値はsmsです。MMSの場合は、公開されたHTTPSの画像リンクを加えます。SMS8は送信前に各画像を1,280ピクセルにリサイズします。
送信するスマートフォン
1つ以上のデバイスIDとSIMスロットを指定します。0がSIM 1、1がSIM 2です。指定しない場合は既定のスマートフォンが送信します。
ローテーション
すべてのスマートフォン、またはすべてのスマートフォンのすべてのSIMで順番に送る設定ができます。メッセージごとにランダムなスマートフォンを使うこともできます。
待機列に割り込む
メッセージを優先に設定すると、そのスマートフォンで待機中のほかのメッセージより先に送られます。通知やコードに便利です。
返ってくる内容
あとで検索するためのメッセージID、受け付けたスマートフォンとSIM、待機列に入った時刻です。状況はその後、待機中、送信中、送信済み、配信済み、失敗と進みます。
Webhook
URLを登録すると、SMS8がイベントの発生に合わせてそこへPOSTします。Webhookごとにイベントを選べ、専用の署名シークレットが付くため、すべてのリクエストが本当にSMS8からのものか確認できます。
受信
いずれかのスマートフォンに返信や新しいメッセージが届きました。ほとんどのCRM連携で必要になるイベントです。
送信済み
スマートフォンがメッセージを受け取り、SIMの待機列に入れました。監査ログに便利です。
配信済み
受信者のキャリアが配信を確認しました。
失敗
番号の誤りや圏外などで、再試行してもメッセージを送信できませんでした。
USSDの応答
送信したUSSDコードにキャリアが応答しました。
スマートフォンのペアリング
新しいスマートフォンがアカウントに追加されました。
署名、再試行、記録
すべてのWebhookリクエストにはX-Signatureヘッダーが付きます。これはリクエスト本文をそのまま使い、APIキーではなくそのWebhook専用のシークレットで作ったHMAC-SHA256のハッシュです。サーバー側で同じハッシュを計算し、定数時間の比較で照合して、一致しないものは破棄してください。
受信側はHTTPSを使い、10秒以内に2xxのステータスで応答してください。応答がない場合、SMS8は数分から最大30日まで間隔を広げながら再試行します。各試行はステータスとレスポンスとともに配信ログに表示され、どの行も手動で再試行できます。
まず応答し、CRMの検索やAIによる分類などの時間のかかる処理はあとで行ってください。メッセージIDを一意のキーとして使えば、再試行されたイベントを二重に処理することはありません。
SDKと言語
Webリクエストを送れる言語なら、どれでも使えます。以下を使えば準備の手間が省けます。
NodeとTypeScript
npmからsms8-sdkをインストールします。SDK、コマンドラインツール、Reactヘルパー、MCPブリッジが1つのパッケージにまとまっています。
02PHP
すべてのエンドポイントに対応するメソッドを持つPHPクラス1つです。ファイルを保存してrequireすれば送信できます。PHP 7.4以降で動作し、必要なのはcurl拡張だけなので、Laravel、WordPress、Symfony、シンプルなスクリプトに組み込めます。
03C#と.NET
HttpClientをベースにした非同期メソッドのクラス1つです。最新の.NET、.NET Framework 4.6.2以降、Unity、Xamarin、MAUIで動作します。
04Pythonなどの言語
リファレンスには、各リクエストがお使いの言語ですぐにコピーできる形で載っています。ダッシュボードのビルダーで、実際のアカウントに対してリクエストを試せます。
AIエージェント向け
mcp.sms8.ioのSMS8 MCPサーバーを使うと、Claude、CursorなどのAIツールが、SMSの送信、OTPコードの送信と確認、メッセージの読み取り、スマートフォンの一覧表示、Webhookの設定を行えます。
同じAPIキーをBearerトークンとして使います。AIツールに一度追加すれば、エージェントがあなたの番号からSMSを送れます。
すべてのリクエストにAPIキーを付けて送ります。キーはダッシュボードのAPIページにあります。MCPサーバーでは同じキーをBearerトークンとして使います。
APIに人為的な制限はありません。実際のペースはSIMによって決まります。大量に送る場合は、スマートフォンを追加するか、設定でメッセージ間の間隔を指定してください。
Webhookで配信済みと失敗のイベントを購読するか、IDでメッセージを検索してください。
はい。種類をMMSにして、公開された画像リンクを加えてください。SMS8は送信前に画像をリサイズします。
はい。現在のエンドポイントは/api/v1配下にありますが、既存のアプリのために以前のURLも引き続き動作します。
使いません。各Webhookには作成時に設定する専用の署名シークレットがあります。APIキーはSMS8へのリクエスト以外に送られることはありません。
イベントは再試行の待機列で待ち、SMS8が最大30日まで再試行を続けます。復旧後に、ログからどの配信でも再送できます。
はい。OpenAPIファイルをPostman、Insomnia、コード生成ツールにインポートすれば、すべてのエンドポイントと項目を取得できます。
はい。デバイスIDとSIMスロットを指定するか、SMS8にスマートフォンとSIMを順番に使わせて負荷を分散できます。