申し込む 資料ダウンロード

ULTIQUE SMS›SMS送信API

SMS送信API

お使いのシステムから、SMSを自動で送れます。API連携費用は0円です。
顧客管理・EC・予約システムなどとつなぎ、送信から「届いたかどうか」の確認まで自動化できます。

仕組み

御社のシステム御社
システム
送信リクエスト
（HTTPS／JSON）送信
リクエスト配信結果を自動で通知
（コールバック）配信結果
を通知
ULTIQUE SMS当社
SMSを配信
（国内回線）SMSを
配信 
受信者の
スマートフォン受信者

主な仕様

提供APISMS送信API：御社のシステムから、SMSの送信を依頼します。
配信結果通知（コールバック）：配信結果を、御社指定のURLへ自動で通知します。
接続方式HTTPS（POST）／JSON形式
通信の暗号化HTTPS（TLS 1.2以上）で暗号化しています。
認証API ID・パスワード、接続元IPアドレス
※セキュリティのため、API連携では接続元のIPアドレスを登録していただいています。
文字コードUTF-8
1回の依頼1つの電話番号に1通です。宛先の数だけ依頼を繰り返せば、まとめて送れます。
送信のタイミング受け付けたSMSは、すぐに送信します。送りたい時刻に御社のシステムから依頼すれば、予約配信と同じことができます。
本文の長さ最大660文字
※絵文字・機種依存文字は使用できません。一部の機種では、70文字程度までしか受信できない場合があります。
宛先日本国内の携帯電話番号（数字のみ。0から始まる11桁、または81から始まる12桁）
送信元事前に登録した送信元電話番号で送信します。
ひも付け項目管理ID（64文字）＋自由項目3つ（各255文字）。配信結果の通知にも、同じ値が返ります。
結果通知の内容配信結果・キャリア・分割通数・課金通数など
※キャリアは返却されない場合があります。
結果通知の時期通常は配信後、数秒〜数分（キャリアの状況により、最大48時間程度）
結果通知の再送御社のシステムが通知を受け取れなかった場合は、60秒間隔で、合計5回まで自動で送り直します。
管理画面との併用APIで送ったSMSの送信履歴と配信結果は、管理画面でも確認できます。管理画面からの送信と併用することもできます。

セキュリティ対策の詳細は、セキュリティのページをご覧ください。

リクエストとレスポンスの例

接続先のURLとAPI ID・パスワードは、ご契約時にお知らせします。下の例の値は見本です。

SMS送信のリクエスト（POST／application/json）

apiId必須API ID
apiPassword必須APIパスワード
phoneNumber必須宛先の携帯電話番号（数字のみ）
message必須本文（UTF-8・最大660文字）
clientOrderId任意管理ID（64文字まで）。配信結果の通知にも同じ値が返ります。
other1〜other3任意自由項目（各255文字まで）。配信結果の通知にも同じ値が返ります。
{
  "apiId": "sampleapiid",
  "apiPassword": "sampleapipassword",
  "phoneNumber": "09011112222",
  "message": "【〇〇クリニック】明日10:00のご予約をお待ちしております。",
  "clientOrderId": "reserve-20261015-0012",
  "other1": "会員番号A001",
  "other2": "",
  "other3": ""
}

受付のレスポンス

受け付けると、本システムが発行するIDと受付結果がすぐに返ります。この時点では、まだ届いていません。

{
  "orderId": "91a985c2125f4d8db9f660f9a8d5b46a",
  "phoneNumber": "09011112222",
  "clientOrderId": "reserve-20261015-0012",
  "responseCode": "100",
  "responseStatus": "received",
  "responseMessage": "SMS message accepted.",
  "other1": "会員番号A001",
  "other2": "",
  "other3": "",
  "hasError": false,
  "errorMessages": {}
}

配信結果の通知（コールバック）

配信が終わると、御社指定のコールバックURLへ、配信結果がPOSTで届きます。

{
  "orderId": "91a985c2125f4d8db9f660f9a8d5b46a",
  "phoneNumber": "09011112222",
  "clientOrderId": "reserve-20261015-0012",
  "responseCode": "200",
  "responseStatus": "success",
  "responseMessage": "It was processed without any problems.",
  "other1": "会員番号A001",
  "other2": "",
  "other3": "",
  "hasError": false,
  "errorMessages": {},
  "messageCount": "1",
  "billingCount": "1",
  "carrierCode": "00010"
}

受け取ったら、次の応答を返してください。

{ "result": "OK" }

messageCountは分割通数、billingCountは課金通数、carrierCodeはキャリア（00010：docomo／00020：au／00030：SoftBank／00040：楽天モバイル／00000：不明）です。応答コードの一覧などの詳細は、API仕様書に記載しています。

送信から結果通知までの流れ

1送信を依頼御社のシステムから、宛先・本文・管理IDなどをJSON形式で送ります。
2受付結果が返るULTIQUE SMSが内容を確認し、受付結果をすぐに返します。内容に誤りがある場合は、エラーの内容が返ります。
※「受け付けた」は、依頼を受け取ったという意味です。届いたかどうかは、手順4の通知で確認します。
3SMSを配信国内回線で、受信者の携帯電話に届けます。
4配信結果を通知御社指定のコールバックURLへ、配信結果をJSON形式で通知します。
5受け取りを応答通知を受け取ったら、{ "result": "OK" } を返してください。

料金

初期費用・月額固定費・API連携費用0円
配信単価1通5円〜（その月の送信通数に応じて自動で決まります）
課金の対象お客様（送信先の方）に届いたSMSのみ

表示価格はすべて税抜です。最低利用料金（1,000円／月）など、料金の詳細を見る →

ご利用開始までの流れ

流れお申込み → 審査・送信元番号の登録申請 → 契約書の締結 → アカウント発行・API情報のご連絡 → システム連携の開発 → ご利用開始
※送信元電話番号の登録は、最短1週間〜10日です。
御社でご用意いただくもの送信元として利用する電話番号／接続元のIPアドレス（複数可）／コールバックURL（配信結果の通知先）／APIを呼び出すための、システム側の開発
当社でご用意するものアカウントの発行／送信元電話番号の登録／APIアカウント情報（ID・パスワード）／API提供URL

よくある質問

API仕様書はもらえますか？はい。お問い合わせいただければ、詳しい仕様書をお送りします。
API連携に費用はかかりますか？かかりません。API連携費用は0円です。
「受け付けました」と返ってきたら、届いたということですか？いいえ。受付は、依頼を受け取ったという意味です。届いたかどうかは、配信結果の通知か管理画面で確認します。
配信状況はどう確認しますか？配信結果はコールバックで自動通知されるので、御社のシステムで保存しておけば、いつでも確認できます。管理画面でも確認できます。
予約配信はできますか？API自体に日時指定の項目はありません。送りたい時刻に御社のシステムから依頼すれば、予約配信と同じことができます。管理画面の一括配信では、送信日時を予約できます。
受信者からの返信を受け取れますか？受け取れません。ULTIQUE SMSは送信専用（片方向）です。
絵文字は送れますか？送れません。絵文字・機種依存文字は使用できません。
配信結果の通知が届かないときは？通常は配信後、数秒〜数分で届きます。キャリアの状況により、最大48時間程度かかることがあります。48時間たっても届かない場合は、サポートまでご連絡ください。
自社サービスとして再販できますか？はい。再販パートナーとして、APIでご利用いただけます。販売代理店・パートナー募集

関連情報

お問い合わせ

API仕様書をご希望の方は、お問い合わせフォームで「API仕様書を希望」を選んで送信してください。
sms@f-i-d.jp ／ 03-6747-1911（平日 10:00〜18:00）

申し込む打ち合わせを予約するAPI仕様書を請求する

← ULTIQUE SMSのトップへ戻る