E メール トリガーの追加

あらかじめ設定されたメール サービスから新しいメールを受信したときに Bot を起動します。

システムのいずれかの E メール サービスに Control Room を接続し、新しい E メールを受信したときに Bot をトリガーします。

E メール オートメーションの場合は、OAuth 2.0 を使用して E メール サーバーと認証できます。アプリケーションを Microsoft ID プラットフォームに登録するには、「でのアクションConnectE メールのパッケージ使用」を参照してください。

手順

  1. 左側のペインで [オートメーション] をクリックします。
    使用可能な Bots とフォームのリストが表示されます。
  2. [新規作成] > [Bot] をクリックします。
  3. Bot の名前を入力します。
    すべての Bots は \Bots フォルダーに保存されます。(任意) フォルダーを変更するには、[参照] をクリックします。
  4. [作成と編集] をクリックします。
  5. Bot ビルダー ページで、[トリガー] > [E メール トリガー] をクリックします。
  6. [E メール] を [ここにトリガーをドラッグ] にドラッグします。
  7. 右側の [E メール トリガー] ウィンドウを使用して、受信メールのトリガーとして次のいずれかのサーバー タイプを選択します。
    サーバータイプステップ
    Microsoft Outlook [Outlook] をクリックします。

    Microsoft Outlook が E メール サービスとして設定され、新しい E メールを受信すると Bot がトリガーされます。
    E メール サーバー [E メール サーバー] をクリックします。
    1. E メール サービスの [ホスト] 情報を入力します。

      たとえば、E メール サービスとして Office 365 を使用している場合は、「Outlook.office365.com」と入力します。

    2. [IMAP] または [POP3] を選択します。
      IMAP および POP3 は、E メール クライアントを介して E メールを読むことができるようにするメール サーバーへの接続に使用されるプロトコルです。
      注: POP3 プロトコルには既知の制限があり、新しいカレンダーの招待によっても Bot がトリガーされます。
    3. 安全な接続 (SSL/TLS) を使用: E メール サーバーとの安全な接続を使用する場合は、このオプションを選択します。
    4. E メール サーバーの構成済みポート番号を入力します。
    5. 次のいずれかのユーザー認証方法を選択して、E メール サーバーにサインインします。
      • 基本
      • クライアント資格情報
        • Microsoft Azure Portal にアプリケーションを登録したときに生成された一意のクライアント ID とテナント ID を指定します。
        • E メール サーバーへのアクセスに使用するユーザー名を指定します。
        • アプリ登録ポータルで、アプリ用に生成したクライアント シークレットを指定します。
          [クライアント ID]、[テナント ID]、[ユーザー名] および [クライアント シークレット] フィールドについては、次の [資格情報] または [安全でない文字列] タブから選択します。
          • 資格情報: 資格情報 Vault で利用可能な値を使用します。
          • 安全でない文字列: 値を手動で入力します。
          注: クライアント資格情報フローは Gmail をサポートしていません。
      • Control Room マネージ

        Gmail を自動化するために Control Room マネージド OAuth2 認証モードを使用するには、Control Room で OAuth 接続を設定する必要があります。「OAuth 接続を作成する」を参照してください。

        以下のフィールドで情報を更新します。

        • 接続: [選択] ボタンをクリックして接続タイプを選択します。
        • [プロバイダー タイプ] フィールドで [カスタム] を選択します。

        • Google Workspace アプリ用に Control Room で設定した接続名を選択します。

        • [トークン タイプ] フィールドを使用して、次のいずれかのオプションを選択します。

          Google Workspace アプリケーションのアクセス トークンおよび更新トークンについては、「エンタープライズ アプリケーションを構成する」を参照してください。

          • [共有しました]: オートメーションを実行するすべてのユーザーで OAuth2 アクセス トークンを共有する場合は、このオプションを選択します。
            注: このオプションは、Control Room 管理者または任意のユーザー ([OAUTH 接続] で [接続をマネージ] および [接続を表示] オプションが有効になっている) が Control Room で OAuth 接続を設定する必要があります。オートメーションを実行しているすべてのユーザーが使用できる共有アクセス トークンを生成するために、ログイン資格情報を 1 回保存します。
          • ユーザー固有: OAuth2 アクセス トークンがオートメーションを実行するユーザーごとに固有である場合は、このオプションを選択します。
            注: このオプションは、Control Room 管理者または任意のユーザー ([OAUTH 接続] で [接続をマネージ] および [接続を表示] オプションが有効になっている) が Control Room で OAuth 接続を設定する必要があります。ログイン資格情報は保存しないようにしてください。オートメーションを実行する各ユーザーがログイン資格情報を指定し、その特定のユーザーのみが使用可能なアクセス トークンを生成できるようにするためです。
          • [確認] をクリックします。
        注: [ユーザー固有] オプションを使用する場合は、Google アカウントにログインして認証し、ユーザー固有のトークンを生成する必要があります。このオプションを使用するには、次の手順を実行します。
        1. Control Room で、プロファイルの [マイ設定] > [OAuth 接続] に移動します。
        2. [ログインして認証] をクリックします。
        3. Google アカウントにログインし、[続行] を選択します。
        4. アクセスできるサービスを確認し、[続行] をクリックします。

          正常に接続されると、ステータスが [アクティブ] と表示されます。

      注: [E メール サーバー] のプロトコルを [POP3] に設定した場合、[フォルダー内の E メール] は、サブフォルダーをサポートしません。
    EWS サーバー [EWS サーバー] をクリックします。
    1. [Microsoft Exchange バージョン] ドロップダウン メニューから、現在のバージョンを選択します。

      たとえば、Microsoft Exchange Service Pack 2 を使用している場合は、E メール サービスとして [Exchange2010_SP2] を選択します。

    2. ドメイン名 (smtp.office365.com など) を入力します。
    3. 次のいずれかのユーザー認証方法を選択して、E メール サーバーにサインインします。
      • 基本
      • OAuth 2.0 - クライアント資格情報
        • Microsoft Azure Portal にアプリケーションを登録したときに生成された一意のクライアント ID とテナント ID を指定します。
        • E メール サーバーへのアクセスに使用するユーザー名を指定します。
        • アプリ登録ポータルで、アプリ用に生成したクライアント シークレットを指定します。
          [クライアント ID]、[テナント ID]、[ユーザー名] および [クライアント シークレット] フィールドについては、次の [資格情報] または [安全でない文字列] タブから選択します。
          • 資格情報: 資格情報 Vault で利用可能な値を使用します。
          • 安全でない文字列: 値を手動で入力します。
          注: Microsoft Outlook の共有メールボックスはサポートされていませんが、回避策として、共有メールを持つ EWS サーバーの資格情報フローをユーザー名文字列として使用することができます。
  8. オプション: すべてのサーバー タイプで利用可能な [次の間隔で確認] ドロップダウン メニューを使用して、トリガー間隔を設定します。

    Bot のトリガー間隔は、デフォルトで 120 秒に設定されています。

    注: [次の間隔で確認] ドロップダウン メニューを使用して設定したトリガー間隔は、スケジュールされた間隔中に受信した E メールの数には依存しません。

    たとえば、[次の間隔で確認] を [1] 秒に設定した場合、同時に 3 通の E メールを受信しても、タスクは 1 回しかトリガーされません。ポーリングの実行時間フィルターは、最後にトリガーが実行された E メールの送信日時に更新されます。

  9. オプション: [条件を選択] を使用して、選択したサーバー タイプの E メール イベントを指定します。
    [Outlook] を選択し、特定の送信者から E メールを受信したときに Bot をトリガーするシナリオを考慮します。[条件を選択] で [E メール送信元] チェックボックスを選択し、送信者の E メール アドレスを指定します。
    [メールの件名の内容] チェックボックスを選択すると、以下の件名条件に応じて E メール トリガーが実行されます。
    • 件名が二重引用符 ("") で囲まれて入力されている場合 (例: "ABC スプレッドシート")、E メールの件名が引用符で囲まれた文字列と完全に一致する場合にのみ、トリガーが実行されます。
    • 複数の件名がセミコロンで区切られている場合 (例: ABC スプレッドシート; ABC プロジェクト ログ)、E メールの件名が記載された件名のいずれかに一致すると、トリガーが実行されます。
  10. オプション: 変数を作成するには、[割り当て先] > [レコード] タブで次をクリックします: 変数選択アイコン。

    この変数を使用して Bot をトリガーした E メールに関するさまざまな詳細 (送信者、受信者、件名、E メールの内容、日付、アクション情報、E メール サーバーのホスト、ポート データなど) を取得できます。

  11. [適用] をクリックします。
  12. [実行] > [トリガーで実行] をクリックします。
新しい E メールの Bot を起動するトリガーとして、Microsoft Outlook、E メール サーバー、または EWS サーバーが設定されています。
注: E メール トリガーを実行すると、emailTo キーは、送信先アドレスのリストを返します。送信先アドレスのリストを文字列に変換するには、リスト パッケージ から [代入] アクション を使用し、リスト パッケージ から [項目を結合] アクションを使用します。アドレスを区切る区切り文字としてコンマを使用します。