Soracom

Users

ドキュメント

SORACOM プラットフォームと SMS を送受信する

デバイスと SMS を送受信できる対象は、IoT SIM の サブスクリプション によって異なります。SMS の観点でサブスクリプションを分類すると、以下のグループに分類できます。

グループ主な特徴サブスクリプション
グループ ASORACOM プラットフォームと SMS を送受信できるplan01s、plan01s - Low Data Volume、planP1、planX1、planX2、planX3、plan-K2 K2-300MB
グループ B他社の SIM と SMS を送受信できるplan-D (SMS あり)、plan-K
グループ CSMS を送信できないplan-D (データ通信のみ)、plan-KM1、plan-DU、plan-US-max

このページでは、グループ A の IoT SIM で利用できる機能を説明します。

IoT SIM とデバイスの両方が SMS の送受信に対応する必要があります

これ以降の説明では、説明を簡単にするために、IoT SIM が単体で SMS を送受信するかのように説明しているところがあります。しかし、実際は IoT SIM を利用しているデバイスが SMS を送受信します。たとえば、SMS の送受信に対応している IoT SIM を利用しても、デバイスが SMS の送受信に対応していない場合は、SMS は送受信できません。

グループ A の IoT SIM で利用できる機能

グループ A の IoT SIM を利用するデバイスでは、SORACOM プラットフォームと SMS を送受信できます。具体的には、以下のように SMS を送受信できます。

送信元受信先
SORACOM ユーザーコンソールグループ A の IoT SIM
任意のサーバー (SORACOM CLI / API を利用)グループ A の IoT SIM
グループ A の IoT SIM (*1)SORACOM Beam / Funnel / Funk / Harvest Data の各サービス
グループ A の IoT SIM (*1)グループ A の IoT SIM (*2)
  • (*1) planP1 では、SMS の受信 (SMS MT) のみをサポートしています。SMS 送信 (SMS MO) はサポートしていません。
  • (*2) 同一のオペレーターが保有する グループ A の IoT SIM 間でのみ SMS を送受信できます。

グループ A の IoT SIM とグループ B の IoT SIM の間では、SMS を送受信できません。

デバイスに SMS を送信する

通信キャリアの通信網の外にある任意のサーバーから、グループ A の IoT SIM に SMS を送信できます。

  • グループ B の IoT SIM には SMS を送信できません。
  • 同一のオペレーターが保有する IoT SIM にのみ SMS を送信できます。

送信元の番号は 901001 です。

  1. ユーザーコンソール にログインし、SMS 送信先の IoT SIM にあわせてカバレッジタイプを変更します。

    たとえば、plan01s の IoT SIM に送信する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  2. [メニュー][SORACOM AIR FOR セルラー][SIM 管理] の順にクリックします。

    SIM 管理画面が表示されます。

  3. SMS 送信先の IoT SIM にチェックを入れ、[操作][SMS を送信] の順にクリックします。

  4. [エンコーディング] を選択し、[SMS 本文] にメッセージを入力して、[SMS を送信] をクリックします。

    [エンコーディング] では、送信するメッセージに合わせて以下のいずれかを選択します。

    項目説明
    [UCS-2 (default)]漢字やキリル文字、アラビア文字などを送信できます。最大 70 文字。
    [GSM-7]GSM 7 ビット標準アルファベットを送信できます。漢字やキリル文字、アラビア文字などは送信できません。最大 160 文字 (最大 140 バイト)。

SMS の送信に失敗したときは

SMS を送信する場合、送信先のデバイスや接続している通信キャリアの状態など、様々な要因で失敗する可能性があります。SORACOM プラットフォームでは、以下の時間間隔で再送を試みます。なお、この時間間隔は予告なく変更される可能性があります。

  1. 2 分間隔で 20 回 (40 分間) 再送を試みます。
  2. 15 分間隔で 20 回 (300 分間) 再送を試みます。
  3. 1 時間間隔で 20 回 (20 時間) 再送を試みます。
エラーログが出力されます

送信および再送が失敗するごとに、送信先の IoT SIM にエラーログが出力されます。エラーログを確認する操作については、IoT SIM のエラーログを確認する を参照してください。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、デバイスに SMS を送信できます。

  • SORACOM CLI を利用するには、あらかじめ SORACOM CLI をインストールし、認証情報を保存してください。詳しくは、SORACOM CLI をインストールする を参照してください。
  • SIM ID は、soracom sims list (Sim:listSims API) で取得できます。

soracom sims send-sms (Sim:sendSmsToSim API) を使用します。

$ soracom sims send-sms --coverage-type g --sim-id ${sim_id}\
--encoding-type 2 --payload "テスト送信"

Sim:sendSmsToSim API を使用します。

$ curl -v -X POST "https://g.api.soracom.io/v1/sims/${sim_id}/send_sms" \
-H "X-Soracom-API-Key: ${X_SORACOM_API_KEY}" \
-H "X-Soracom-Token: ${X_SORACOM_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
  "encodingType": 2,
  "payload": "テスト送信"
}'

デバイスから SMS を送信する

グループ A の IoT SIM を利用するデバイスから、SORACOM プラットフォームに SMS でデータを送信します。

グループ B の IoT SIM を利用するデバイスからは、SORACOM プラットフォームに SMS を送信することはできません。

SORACOM Harvest Data にデータを送信する

グループ A の IoT SIM を利用するデバイスから、901031 宛てに SMS を送信すると、SORACOM Harvest Data (以下、Harvest Data) にデータを送信できます。

Harvest Data を有効化してください

あらかじめグループの Harvest Data を有効化し、そのグループに IoT SIM を所属させてください。詳しくは、Harvest Data を有効化する を参照してください。

  1. グループ A の IoT SIM を利用するデバイスから、901031 (Harvest Data) に SMS を送信します。

  2. Harvest Data に送信されたデータを確認します。

    詳しくは、Harvest Data に保存したデータを確認する を参照してください。

    plan01s SMS plan01s SMS

任意のサーバーにデータを送信する

グループ A の IoT SIM を利用するデバイスから、SORACOM Beam / Funnel / Funk の各サービスに対応する宛先番号宛てに SMS を送信すると、各サービスを経由して任意のサーバーにデータを送信できます。

宛先番号、NAI、NPI、メッセージペイロードに指定する値は、以下のとおりです。

項目
宛先番号

利用するサービスによって、宛先番号が異なります。

NAI (Nature of Address Indicator)、TON (Type of Number)0 (Unknown)
NPI (Numbering Plan Indicator)9 (Private)
メッセージペイロード最大 140 バイトの任意のデータを指定できます。
ログの確認

送信ログを確認できます。詳しくは、IoT SIM のエラーログを確認する を参照してください。

plan01s SMS plan01s SMS