Soracom

Users

ドキュメント
Home ドキュメント SORACOM Flux アクションリファレンス

Email 通知アクション

Email 通知アクションは、指定されたメールアドレスにメールを送信します。

オペレーターごとに 1 時間あたり 10 通まで送信できます。この制限は Email 通知アクション (高機能版) と合算されます。 また、1 か月あたり 100 通まで送信できます。 これらの制限を超えた場合、エラーが返されます。

チャネルにアクションを追加する手順については、チャネルにアクションを追加する (処理を分岐する) を参照してください。

Email 通知アクションの設定

ここでは、Email 通知アクションの CONFIG について説明します。そのほかの項目については、アクションリファレンスの 「新しいアクションを作成」画面 を参照してください。

CONFIG

メールの内容を設定します。

項目説明
[TO]TO に設定するメールアドレスを選択します。
[CC]CC に設定するメールアドレスを選択します。
[BCC]BCC に設定するメールアドレスを選択します。
[件名]

メールの件名を入力します。

  • この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.temp}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。
[本文]

メールの本文を入力します。

  • この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.temp}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。
  • メール送信先アドレスは ルートユーザー だけが設定できます。SAM ユーザーでは設定できません。
  • オペレーターに追加済みのメールアドレスだけを選択できます。オペレーターにメールアドレスを追加する操作について詳しくは、メールアドレスを追加する を参照してください。

Email 通知アクションの出力データ

Email 通知アクションでメールが送信されると、送信先のメールアドレスとレート制限の使用状況が出力されます。

{
  "sent": {
    "to": [
      "user@example.com"
    ]
  },
  "usage": [
    {
      "curr": 4,
      "limit": 10,
      "resetAt": "2026-03-02T10:20:37Z"
    },
    {
      "curr": 30,
      "limit": 100,
      "resetAt": "2026-03-12T09:10:53Z"
    }
  ]
}

CC や BCC を指定した場合は、sentccbcc が追加されます。

{
  "sent": {
    "to": [
      "user@example.com"
    ],
    "cc": [
      "user2@example.com"
    ]
  },
  "usage": [
    {
      "curr": 4,
      "limit": 10,
      "resetAt": "2026-03-02T10:20:37Z"
    },
    {
      "curr": 30,
      "limit": 100,
      "resetAt": "2026-03-12T09:10:53Z"
    }
  ]
}

usage はレート制限の使用状況を表す配列です。1 時間単位のリミットを含み、プランによっては 1 か月単位のリミットも含まれます。各要素の内容は以下のとおりです。

  • curr: 現在の使用数
  • limit: 上限数
  • resetAt: リセット日時 (UTC)

出力データはメールの送信を表しますが、送信先へのメールの到達を保証するものではありません。

Email 通知アクションの実行可能数に制限があります (レート制限)
  • すべての Flux アプリを対象に、Email 通知アクション (高機能版) と合算して 1 時間あたり最大 10 通まで送信できます。制限を超えた場合、エラーが返されます。
  • プランによっては、さらに制限が設定される場合があります。詳しくは、SORACOM Flux のプラン を参照してください。