結果メール設定
結果メール設定は、フローの実行結果をメールで通知する設定です。フローごとに宛先を登録しておくと、実行が完了したとき・失敗したときに、指定した宛先へ自動でメールが届きます。
定期実行のバッチが失敗したことに気づけるようにしたい、処理結果を担当者に知らせたい、といった用途に使います。
設定する場所
Section titled “設定する場所”結果メール設定は、次の2か所から同じものを操作できます。
| 場所 | 内容 |
|---|---|
| 「設定 > 結果メール設定」 | 組織内のすべてのフローの設定を一覧・追加・編集・削除できます |
| フローエディタ下部の「メール設定」タブ | そのフローの設定だけを一覧・追加・編集・削除できます → フローとは |
| 項目 | 内容 |
|---|---|
| フロー | 通知の対象になるフロー |
| 通知タイミング | 成功時 / 警告時 / 失敗時 から複数選べます（既定はすべて） |
| 宛先種別 | TO（既定） / CC / BCC |
| 対象種別 | メンバー（組織のメンバーから選ぶ） / 直接指定（メールアドレスを入力する） |
| 対象メンバー / メールアドレス | 対象種別に応じて、通知先のメンバーかメールアドレスを指定します |
1つの設定が1つの宛先に対応します。複数の宛先に送りたい場合は、宛先ごとに設定を追加してください。
警告時 は、スクリプトが synqlet:warning の addWarning で警告を記録したまま完了した実行のことです。警告があった実行は「成功時」ではなく「警告時」として通知されるので、警告も受け取りたい場合は両方を選んでください。→ スクリプトを書く
送信されるメール
Section titled “送信されるメール”| 通知 | 件名 | 本文の内容 |
|---|---|---|
| 成功時 | 成功 | フロー「<フロー名>」実行完了のお知らせ |
ノードごとのログと結果、フロージョブ詳細画面へのリンク |
| 警告時 | 成功(警告N件) | フロー「<フロー名>」実行完了のお知らせ |
本文の先頭に警告メッセージの一覧。以降は成功時と同じ |
| 失敗時 | 失敗 | フロー「<フロー名>」実行失敗のお知らせ（警告があるときは 失敗(警告N件) | …） |
失敗したノード名・試行回数・エラー内容・標準エラー出力、フロージョブ詳細画面へのリンク。警告があるときは本文の先頭にその一覧 |
件名には警告の件数だけが入ります。警告の内容は本文の先頭に全件表示されるほか、1件目のメッセージはメールソフトの一覧に出るプレビュー（件名の続きに表示される文）にも入ります。
結果やログが大きいときは一部だけが載ります
Section titled “結果やログが大きいときは一部だけが載ります”メールに載るのは一部だけで、残りは省略されます。全体はフロージョブの詳細画面で確認してください。
| 項目 | 載る範囲 | 表示されるメッセージ |
|---|---|---|
| 結果 | 先頭 | 結果が大きいため先頭のみを載せています |
| ログ・標準エラー出力 | 末尾 | ログが大きいため末尾のみを載せています |
ログを末尾から載せるのは、エラーメッセージや処理の締めくくりが末尾に出るためです。
送信されたメールは「設定 > メール履歴」から確認できます。
通知されないケース
Section titled “通知されないケース”設定したのにメールが届かないときは、次の点を確認してください。
- TO の宛先が1件もない — CC / BCC だけを登録しても送信されません。フローごとに、少なくとも1件は宛先種別が TO の設定が必要です。
- テスト実行だった — プレイグラウンドでの試し実行や、トリガーのテスト実行では通知されません。通知されるのは本番の実行（スケジュール・Webフック・フォーム送信による実行）だけです。
- リトライ中 — 失敗の通知は、スクリプトノードの 最大試行回数 を使い切って最終的に失敗が確定してから送信されます。1回目の失敗では送信されません。→ スクリプトを書く
- 通知タイミングが合っていない — 「成功時」だけの設定では、失敗した実行にも警告があった実行にもメールは届きません。受け取りたいタイミングをすべて選んでください。
結果メール設定の追加・変更・削除ができるのは、「管理者」 または 「フロー・ファンクション・環境変数・テーブル・認証情報の作成」 を許可されたメンバーです。どちらも許可されていないメンバーは一覧の閲覧のみできます。→ メンバー管理
API / MCP から設定する
Section titled “API / MCP から設定する”REST API のエンドポイントは /api/result-mail-settings です。作成時は flowId と、memberId または email のどちらか一方を指定します（recipientType の既定は To、notificationTypes の既定は ["Success", "Warning", "Error"]）。→ API の使い方
ローカルMCP からは list_result_mail_settings / create_result_mail_setting / delete_result_mail_setting で操作でき、list_mails で送信結果を確認できます。