SORACOM Developers

SORACOM Air for セルラー

Air SIM(plan01s)の SMS 機能を使用する

はじめに

グローバル向け SIM(plan01s, plan01s - Low Data Volume)では、API を使用して SMS を送ることができます。これにより、携帯電話通信網外のサーバーからも Air SIM を使用している IoT 機器に対して SMS を送信したり、プログラムに組み込んで送信を自動化することが可能になります。

また、IoT デバイスから外部サーバーへの SMS 送信も可能です。送信されたデータはデータ転送支援サービスSORACOM BeamやクラウドリソースアダプタSORACOM Funnelデータ収集・蓄積サービスSORACOM Harvestなどのサービスと組み合わせてご利用いただくことで、簡単にお客様のサーバーへ送信、蓄積することができます。

このドキュメントでは、当SMS機能を使用して、APIを使用したSMS送信とSMSを使用して Harvest にデータ送信を行います。

ステップ 1: デバイスの準備

SORACOM SIMはグローバルカバレッジです。以下のデバイスをご用意ください。

接続されない場合、デバイスで3Gを優先するように設定をご確認ください。

ステップ 2: APIを使用したSMSの送信

APIを使用したSMSの送信は、コンソールからも実施できますが、ここでは、APIを利用してSMSを送信します。API Endpointは、以下となります。

https://g.api.soracom.io/

ここからの API の実行は、API Referenceからも実行できますので、合わせてご確認ください。

Auth API で API key と API Tokenを取得

ターミナルから以下のコマンドを実行します。

$ curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"email": "<ログインID>","password": "<パスワード>"}' 'https://g.api.soracom.io/v1/auth'

apiKeyとtokenが取得できます。これ以降のAPIの実行で使用します。

Send_sms APIの実行

$ curl -X POST  -H 'content-type:application/json' -H 'X-Soracom-API-Key: <apiKey>' -H 'X-Soracom-Token: <token>'  -d '{"body":"<メッセージ>"}' https://g.api.soracom.io/v1/subscribers/<imsi>/send_sms

デバイスにSMSが送信できたことをご確認ください。 SMS API は、当該のOperatorがもつIMSIのみに送信可能です。APIの実行で呼び出すことができるため、業務システムなどに組み込んで、なんらかのトリガーでSMSを送信するなど、自動化が容易に行なえます。

なお、ASCII以外のメッセージを送信するには、上記APIで 「-d ’{“body”:“<メッセージ>”}‘」 の部分を以下のように変更してください。

ステップ 3: SMS を使用した Harvest へのデータ送信

グループの作成とSIMのグループ所属

グローバルカバレッジのコンソールにログインして、グループを作成します。

https://console.soracom.io/#/?coverage_type=g

「Menu」→「SIMグループ」→「追加」から、グループを選択してください。

グループIDをコピーしておいてください。

plan01s SMS 次に、「SIM管理」画面からSIMを選択して、「所属グループ変更」から作成したグループに所属させてください。

plan01s SMS

グループコンフィグを設定する

作成したグループで、HarvestをONにして、保存します。 plan01s SMS

SMSを使用して、Harvestにデータを送信する

デバイスから、以下の番号宛にSMSメッセージを送信してください。以下は Harvest 用の宛先番号となります。

送信したSIMで、「データを確認」から、送信されたデータを確認します。

plan01s SMS

以下のように送信されたデータを確認してください。

plan01s SMS

その他のサービスの利用

利用するサービスによって、宛先番号が異なります。各サービスの宛先番号は以下のとおりです。

なお、NAI, NPI については、以下をご使用下さい。

ログの確認

SMS to Beam/Funnel/Harvest、SMS APIともにログを確認することができます。

plan01s SMS plan01s SMS

Getting Started

SORACOM Air for セルラー

SORACOM Air for LoRaWAN

SORACOM Air for Sigfox

SORACOM Beam

SORACOM Canal/Direct/Door

SORACOM Endorse

SORACOM Funnel

SORACOM Gate

SORACOM Harvest

SORACOM Inventory

SORACOM Junction

サービス機能詳細

Developer Tools

pagetop