SMS8

SMS8 API 開発者の皆様へ。

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

SMS8: キーをコピーし、1回のリクエストで送信、Webhookで配信状況を追跡。
コマンド1つで始める
npm install sms8-sdk

Claude Desktop:設定、コネクタ、カスタムコネクタを追加

APIのしくみ

すべてのリクエストはapp.sms8.ioに送られます。APIキーと必要な項目をシンプルなフォームのPOSTで送信すると、成功フラグとメッセージの詳細を含むJSONが返されます。

その裏で、メッセージはペアリングしたAndroidスマートフォンに届き、そのスマートフォンが自身のSIMから送信します。返信と配信レポートも同じ経路でお客様に戻ります。

APIに人為的なレート制限はありません。実際の処理量はSIMによって決まります。より多く送るには、スマートフォンを追加するか、デュアルSIMのスマートフォンをお使いください。

できること

用途ごとにエンドポイントが1つあります。すべての項目は完全なリファレンスに記載しています。

01

SMSとMMSの送信

1通のメッセージ、多数の宛先へのバッチ、保存済みの連絡先リストへの一斉配信を送れます。画像のリンクを加えればMMSになります。予約送信や、待機列の先頭に割り込む設定もできます。

02

送信元の選択

1台のスマートフォンとSIMから送るか、すべてのスマートフォンで順番に送るか、メッセージごとにランダムに選んで負荷を分散できます。

03

確認と再送

IDでメッセージを検索して状況を確認できます。失敗したメッセージは1回の呼び出しで待機列に戻せます。

04

OTPコード

ワンタイムコードを送信し、ユーザーが入力した内容を確認します。受信者を守るため、コードは電話番号ごとに1日の上限があります。

05

デバイスと連絡先

ペアリングしたスマートフォンとそのSIMを一覧表示します。名前、タグ、カスタム項目付きで連絡先を作成または更新できます。

06

USSD

残高確認などのキャリアのUSSDコードを、ペアリングしたスマートフォンから送信し、その応答を読み取れます。

認証とレスポンス

アカウントごとにキーは1つ。どの呼び出しでもレスポンスの形は同じです。

01

キーの場所

キーはSMS8ダッシュボードのAPIページに表示されます。キーはパスワードと同じように扱い、公開のWebページではなくサーバーに保管してください。

02

キーの送り方

OpenAPIファイルにあるとおり、X-Api-Keyヘッダーに入れます。AuthorizationヘッダーのBearerトークンや、keyという名前のフォーム項目でも使えます。

03

返ってくる内容

成功フラグ付きのJSONです。成功時はメッセージやレコードが、失敗時はコードと短いメッセージ付きのエラーが返されます。

04

フラグを確認

項目の誤りやクレジット不足など、一部のエラーは通常のレスポンスの中で返されます。結果を信頼する前に成功フラグを確認してください。

05

キーが誤っている場合

キーがない、または無効な場合は401が返されます。項目の不足や形式の誤りには400が返されます。

エンドポイント一覧

すべてapp.sms8.io配下にあります。各エンドポイントの正確な項目はOpenAPIファイルに記載しています。

パスメソッド内容
/api/v1/messagesPOST1人またはバッチでSMSやMMSを送信
/api/v1/messages/readPOST送受信したメッセージを番号、方向、日付で絞り込んで一覧表示
/api/v1/messages/resendPOST失敗したメッセージをIDで再送
/api/v1/devicesGETペアリングしたスマートフォンをバッテリー、電波、SIM、最終接続時刻とともに一覧表示
/api/v1/contactsPOSTタグとカスタム項目付きで連絡先を作成または更新
/api/v1/ussd/sendPOSTペアリングしたSIMからUSSDコードを実行し、キャリアの応答を取得
/api/v1/ussd/listPOST最近のUSSDセッションを一覧表示

メッセージ送信の項目

必須なのは番号と本文だけです。そのほかの項目には初期値があります。

01

番号と本文

番号は+14155550100のような国際形式で指定します。本文は1,000文字まで書け、{first_name}などの差し込みタグを使えます。

02

SMSまたはMMS

種類の初期値はsmsです。MMSの場合は、公開されたHTTPSの画像リンクを加えます。SMS8は送信前に各画像を1,280ピクセルにリサイズします。

03

送信するスマートフォン

1つ以上のデバイスIDとSIMスロットを指定します。0がSIM 1、1がSIM 2です。指定しない場合は既定のスマートフォンが送信します。

04

ローテーション

すべてのスマートフォン、またはすべてのスマートフォンのすべてのSIMで順番に送る設定ができます。メッセージごとにランダムなスマートフォンを使うこともできます。

05

待機列に割り込む

メッセージを優先に設定すると、そのスマートフォンで待機中のほかのメッセージより先に送られます。通知やコードに便利です。

06

返ってくる内容

あとで検索するためのメッセージID、受け付けたスマートフォンとSIM、待機列に入った時刻です。状況はその後、待機中、送信中、送信済み、配信済み、失敗と進みます。

Webhook

URLを登録すると、SMS8がイベントの発生に合わせてそこへPOSTします。Webhookごとにイベントを選べ、専用の署名シークレットが付くため、すべてのリクエストが本当にSMS8からのものか確認できます。

01

受信

いずれかのスマートフォンに返信や新しいメッセージが届きました。ほとんどのCRM連携で必要になるイベントです。

02

送信済み

スマートフォンがメッセージを受け取り、SIMの待機列に入れました。監査ログに便利です。

03

配信済み

受信者のキャリアが配信を確認しました。

04

失敗

番号の誤りや圏外などで、再試行してもメッセージを送信できませんでした。

05

USSDの応答

送信したUSSDコードにキャリアが応答しました。

06

スマートフォンのペアリング

新しいスマートフォンがアカウントに追加されました。

署名、再試行、記録

すべてのWebhookリクエストにはX-Signatureヘッダーが付きます。これはリクエスト本文をそのまま使い、APIキーではなくそのWebhook専用のシークレットで作ったHMAC-SHA256のハッシュです。サーバー側で同じハッシュを計算し、定数時間の比較で照合して、一致しないものは破棄してください。

受信側はHTTPSを使い、10秒以内に2xxのステータスで応答してください。応答がない場合、SMS8は数分から最大30日まで間隔を広げながら再試行します。各試行はステータスとレスポンスとともに配信ログに表示され、どの行も手動で再試行できます。

まず応答し、CRMの検索やAIによる分類などの時間のかかる処理はあとで行ってください。メッセージIDを一意のキーとして使えば、再試行されたイベントを二重に処理することはありません。

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を順番に使わせて負荷を分散できます。

最初のAPI呼び出しを送信

アカウントを作成し、スマートフォンをペアリングして、APIキーをコピーしてください。数分でご自身のコードから送信できます。