Soracom

「新しいチャネルを作成」画面でイベントソースとして「イベントハンドラー」を選択すると、SORACOM イベントハンドラー のルール (条件) を満たしたときに Flux アプリを起動できます。イベントハンドラーの「Flux アプリを実行する」アクションが、チャネルにイベントを送信します。

チャネルにイベントを送信するイベントを作成する

イベントは、ユーザーコンソールのイベントハンドラーのイベント一覧画面で作成および編集します。SORACOM Flux Studio から操作すると、「Flux アプリを実行する」アクションにチャネルが設定された状態で、イベントを作成する画面が表示されます。

• 新しいチャネルを作成する場合は、イベントソースに連結したチャネルを作成する の手順で、イベントソースに「イベントハンドラー」を選択します。チャネルが作成されると、イベントを作成する画面が表示されます。
• 既存のチャネルにイベントを追加する場合は、チャネルの [イベントソース] タブで [イベントソースを追加する] をクリックし、[イベントハンドラー] を選択して、[イベントハンドラーを作成する] をクリックします。

イベントを作成する画面では、[監視対象] と [ルール] を設定します。「Flux アプリを実行する」アクションの [Flux アプリ] と [チャネル] には、操作元のチャネルがあらかじめ設定されており、変更できません。[保存] をクリックすると、イベントが作成され、チャネルの画面に戻ります。監視対象とルールについては、イベント一覧画面で作成する を参照してください。

作成したイベントは、チャネルの [イベントソース] タブと SORACOM Flux Studio に表示されます。1 つのチャネルに複数のイベントを設定できます。イベントを追加するには、上記の操作を繰り返します。

チャネルに設定したイベントを管理する

チャネルの [イベントソース] タブには、チャネルにイベントを送信するイベントが、名前、ルールと監視対象の概要、およびステータス ([有効] または [無効]) とともに表示されます。

チャネルに送信されるデータ

以下では、イベントハンドラーイベントソースを設定したチャネルに送信される MESSAGE の内容を説明します。

MESSAGE

MESSAGE には、content フィールドが 1 つだけ含まれます。payload.content はオブジェクトではなく JSON 文字列として届くため、Flux アプリ側でパースしてから各フィールドを参照してください。

content の JSON には、ルールを満たしたリソースとイベントの情報が含まれます。含まれるフィールドは、ルールによって異なります。

例: IoT SIM の通信量のルールの場合に、content をパースした結果

{
  "imsi": "295050012345678",
  "simId": "8981100012345678901",
  "resourceId": "295050012345678",
  "operatorId": "OP0012345678",
  "date": "2026/10/19",
  "day": "19",
  "month": "10",
  "year": "2026",
  "coverage": "g",
  "tags": {
    "name": "sensor-01"
  },
  "handlerExecutionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}