受信メールの処理

メールを受信して重要なフィールドを抽出し、コンテンツに基づいて各メッセージを適切な下流のシステムにルーティングするワークフローを構築します。

構築する内容: 新しいメールを受信すると自動的に起動し、メッセージからキー フィールドを抽出し、その内容に基づいて適切な下流のアクションにルーティングするワークフロー (たとえば、サポート リクエストをチケット システムに記録する、緊急メッセージを Slack チャンネルにエスカレーションするなど)。

必要なもの

• Maestro Flow へのアクセス権を持つ UiPath Automation Cloud アカウント。
• Integration Service (UiPath のコネクタ プラットフォーム) を介して接続されたメールボックスサポートされているプロバイダーには、Microsoft 365 と Gmail があります。コネクションを設定するには、UiPath Platform の Integration Service に移動し、メール プロバイダーのコネクタを設定します。

使用されるノード

• メール連携トリガー — 接続されているメールボックスに新しいメールが届いたときに起動します
• データ変換 — メール ペイロードから送信者、件名、本文を抽出します
• 判断 — 内容に基づいてメールをルーティングします
• 強制終了 — ペイロードの形式が正しくない場合、ワークフローを正常に終了します

手順

1. 新しいフローを作成し、メール トリガーを追加する

1. Open Maestro Flow and create a new workflow.
2. [ノード] パネルで [統合ノード ] を開き、メール コネクタ (Microsoft 365 または Gmail) を見つけます。
3. [ メールの受信時 ] トリガーをキャンバスにドラッグします。
4. 設定パネルで、使用する コネクション を選択し、フィルター (特定の受信トレイ フォルダーなど) を設定します。

2. メールからフィールドを抽出する

1. データ変換ノードをキャンバスにドラッグし、トリガーに接続します。
2. 必要なフィールドをトリガーの出力ペイロードからマッピングします。
   • trigger.body.from → senderEmail
   • trigger.body.subject → emailSubject
   • trigger.body.body.content → emailBody

正確なフィールド名はコネクタによって異なります。設定パネルでトリガーの出力スキーマを確認します。

3. コンテンツに基づくルート

1. [ 判断 ] ノードをキャンバスにドラッグし、[データ変換] ノードに接続します。
2. メールの内容を評価する条件を設定します。たとえば、緊急メッセージをキャッチするには $vars.emailSubject.toLowerCase().includes("urgent")のようになります。
3. True の分岐を優先度の高いアクション (Slack 通知ノードなど) に接続します。
4. False 分岐を標準アクション (サポート システムでチケットを作成するなど) に接続します。

4. 不正な形式のペイロードを処理する

すべてのメールに期待どおりのフィールドがあるわけではありません。正しくない形式のペイロードによってワークフローが中断される前に保護します。

1. データ変換の後に [判断 ] ノードを追加し、必須フィールドが存在することを確認します (例: $vars.senderEmail != null)。
2. 有効な分岐を手順 3 のルーティング Decision に接続します。
3. 問題をログに記録する スクリプト ノードに無効なブランチを接続します。
4. スクリプト ノードを に設定した [強制終了 ] ノードに接続 Failed。

エラー ハンドルを公開するノードについては、同じエラー パスに接続することもできます。詳しくは、「 エラー処理」をご覧ください。

5. テストとデバッグ

実際のメールを待たずにテストするには、次の手順を実行します。

1. メール トリガーと共に [ 手動トリガー ] を一時的に追加します。
2. メール ペイロードの形状に一致するサンプル入力スキーマを使用して設定します。
3. サンプル値を使用してテストを実行し、実行トレースでルーティング ロジックを検証します。
4. パブリッシュする前に [手動トリガー] を削除します。

結果

ワークフローは新しいメールを受信すると自動的に起動され、送信者、件名、本文が抽出されて、メッセージを正しい下流のアクションにルーティングされます。形式が正しくないペイロードは、ワークフローを中断するのではなく、エラー パスできれいに終了します。

このワークフローを拡張する

• AI エージェントを呼び出し — [判断] ノードの前に [自律型エージェント ] ノードを追加し、キーワードの一致ではなく AI を使用してメールを分類します。
• 添付ファイルをループ 処理 — メールに添付ファイルがある場合、各添付ファイルを処理する ループ ノードを追加します。
• 送信者に返信 — ルーティング後、確認の返信を送信するためのメール連携アクション ノードを追加します{{ $vars.senderEmail }}。