Email packageでの Connect actionの使用

Email package のConnect actionを使用して、Eメール サーバーとの接続を確立します。 これは、E メール関連のタスクを自動化するときに使用する最初のactionです。

前提条件

OAuth 2.0 を使用して、E メール オートメーションのために E メール サーバーで認証することができます。 お使いの E メール サービス プロバイダーに基づいて、適切な手順を実行してください。
  • Outlook/Office 365
    • クライアント資格情報フロー認証モードを使用する場合は、次の手順を実行します。
      1. Microsoft Azure portal にログインします。
      2. アプリケーションを Microsoft ID プラットフォームに登録して、クライアント ID とテナント ID を取得します。 [Register an application]を参照してください。
      3. クライアント シークレットを追加します。

        [Add a client secret]をご覧ください。

      4. 接続するメールサーバーに基づいて、適切な手順を実行してください。
    • PKCE を使用した認証コード認証モードを使用する場合は、次の手順を実行します。
      1. Microsoft Azure portal にログインします。
      2. アプリケーションを Microsoft ID プラットフォームに登録して、クライアント ID とテナント ID を取得します。 [Register an application]を参照してください。
      3. アプリケーションの登録時に、リダイレクト URI を http://localhost:9999/callback に設定します。
      4. IMAP、POP3、SMTP に対して委任タイプの権限を追加し、アプリケーションに Microsoft Graph の必要な権限を付与します。
    • Control Room管理 認証モードを使用する場合は、[Configure Control Room managed OAuth for Outlook/Office365 (A-people login required)]を参照してください。

    次のプレイリストのビデオではEmail Connect actionでの OAuth 2.0 認証の設定と使用に関する情報を提供しています。

    注: メールボックスが [ループ] action内で使用される場合、オートメーションを実行するために割り当てられているユーザーを確実に登録してください。詳細については、「Manage users and groups assignment to an application」を参照してください。
  • Gmail
    • PKCE を使用した認証コード認証モードを使用する場合は、次の手順を実行します。
      1. Google Cloud Platform (GCP) で OAuth2.0 設定を構成し、Automation 360 を Google Workspace アプリケーションに接続するために必要な資格情報を取得します。
      2. プロジェクトを作成したことを確認します。

        [プロジェクトの作成]を参照してください。

      3. クライアント ID とクライアント シークレットを生成します。
        [OAuth 2.0 の設定]をご覧ください。
        注:
        • Web アプリケーション オプションを選択します。
        • 許可されたリダイレクト URI: http://localhost:8888/Callback を追加します。
      4. 次の手順を実行して、ユーザー同意を設定し、Automation 360への接続に使用するユーザー名を設定します。
    • Control Room管理 認証モードを使用する場合は、次の手順を実行します。
      重要: 現在、Email packageは、認証コード フローに基づくOAuth 接続のみControl Room管理 Oauthをサポートしています。
      1. Google Cloud Platform (GCP) で OAuth2.0 設定を構成し、Automation 360 を Google Workspace アプリケーションに接続するために必要な資格情報を取得します。
      2. プロジェクトを作成したことを確認します。

        [プロジェクトの作成]を参照してください。

      3. クライアント ID とクライアント シークレットを生成します。
        [OAuth 2.0 の設定]をご覧ください。
        注:
        • Web アプリケーション オプションを選択します。
        • 承認済みのリダイレクト URI を追加するには、以下の手順を実行します。
          1. 管理者または接続の管理および閲覧権限を持つユーザーとして Control Room にログインし、管理 > OAuth 接続 に移動します。
          2. 接続の作成 タブをクリックし、カスタム オプションをプロバイダー タイプ フィールドから選択します。
          3. コールバック URL をコピーし、Google Cloud コンソールの [Client アプリケーション] ページに戻ります。
          4. 承認済みのリダイレクト URI の下にある + URI を追加 ボタンをクリックし、[URI] フィールドに URI を貼り付けます。
          5. 作成をクリックします。

          Control Room で OAuth 接続を作成する方法については、[OAuth 接続を作成する]を参照してください。

      4. 次の手順を実行して、ユーザー同意を設定し、Automation 360への接続に使用するユーザー名を設定します。
注:
  • クライアント資格情報フローは Gmail をサポートしていません。
  • クライアント資格情報および PKCE を使用した認証コード認証モードは、Yahoo と MSN の E メール サーバーをサポートしていません。
推奨: 両方の認証モード (クライアント資格情報および PKCE を使用した認証コード) を使用する場合は、2 つの個別のアプリケーションに登録する必要があります。
注: Exchange Web Services サーバーに接続するときに、多要素認証 (MFA) を無効にする必要があります。これは、MFA が有効になっている可能性があるすべての組織レベルのセキュリティポリシーも対象となります。 MFA が完全に無効になっていない場合は、接続エラーまたは承認エラーが発生する可能性があります。 ただし、それでも MFA を使用する場合は、次の記事の情報を確認してください (接続への成功が保証されないことに注意してください:

Multi-factor authentication for Azure EWS (A-people login required)

この action により、E メール サーバーの資格情報と詳細を指定し、この情報をセッション名に関連付けることができます。 サーバー情報の入力が 1 回で済むように、他の Email actions にもこの同じセッション名を使用します。

手順

E メール サーバーと接続を確立するには、以下の手順に従ってください。

注: macOS プラットフォームで自動化を作成し、メールサーバーとの接続を確立すると、Outlook は macOS ではサポートされていません。 Microsoft Outlook (macOS) packageを使用して、Microsoft Outlook クライアント アプリケーションでメール関連のタスクを自動化できます。

Microsoft Outlook (macOS) package

  1. Actions パレットで、 Email packageの [接続] actionをダブルクリックまたはドラッグします。
  2. セッション名を入力してください。
  3. Outlook、E メール サーバー、EWS からオプションを選択し、Microsoft Outlook または E メール サーバーと接続するかどうかを指定します。
    注:
    • EWS サーバーに接続し、ループ actionを使用して E メール サーバーからすべての E メールを取得する場合、E メールの件名に次の文字が含まれていると、botは実行に失敗し、エラー メッセージが表示されます。
      • 制御文字
        • 範囲: 0x00 - 0x08 (except 0x09 - Horizontal Tab) and 0x0B - 0x0C (except 0x0A - Line Feed and 0x0D - Carriage Return)
        • 16進数の値: 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F
      • 上位サロゲートと下位サロゲートのペア
        • 範囲: 0xD800 - 0xDFFF
        • 16進数の値: 0xD800 - 0xDFFF
      • 文字以外のコードポイント
        • 範囲: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
        • 16進数の値: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
      • 制限された範囲
        • 範囲: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF
        • 16進数の値: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF

          回避策: Microsoft Outlook または E メール サーバーを使用して、この操作を行うことができます。 ただし、マイクロソフト社は Exchange Online への接続に使用される EWS API の EOL を発表したため、Microsoft 365 Outlook package を使用することをお勧めします。 [Exchange Online の EWS API の非推奨について]を参照してください

    • Microsoft Outlook との接続を確立すると、E メール メッセージは共有メールボックスから処理されます。 Outlook アプリケーションで共有メールボックスが設定されていることを確認します。
      • この機能は、Outlook の場合のみサポートされます。
      • 共有メールボックスのメールボックス一覧から 1 つだけ選択することができます。
      • bot がカレンダーの招待状をメール オブジェクトとして選択しないため、Outlook で会議の招待状が読み込まれません。 この機能は現在サポートされていません。
    • Outlook オプションを選択した場合は、追加の詳細を指定する必要はありません。

      接続したいメールアドレスを指定するために、変数オプションを使用できます。

      注: 新しい Outlook クライアントに接続できません。 しかし、メール関連のタスクを自動化するためにクラシック Outlook クライアントに切り替えることができます。
    • E メール サーバー オプションを選択した場合は、次のフィールドに入力します。
      注: さまざまな E メール サーバーに使用するホストおよびポートについては、[E メール サーバーの設定]をご覧ください。
      • 安全な接続 (SSL/TLS) を使用: E メール サーバーとの安全な接続を使用する場合は、このオプションを選択します。
      • ホスト: メール サーバーの名前を入力します。
        注: このフィールドでは大文字と小文字が区別されません。
      • ポート: サーバーのポート番号を入力します。
      • プロトコル: IMAP または POP3 プロトコルのどちらかを選択します。
        注: Regex は IMAP プロトコルに対応しており、受信トレイのすべてのサブフォルダから E メールを読み取ります。
      • 認証モード: 次の認証モードから選択します。
        • ベーシック: ユーザー名とパスワードを使用します。
        • OAuth2 - PKCE を使用した認証コード: [Microsoft identity platform and OAuth 2.0 authorization code flow]を参照してください。

          メール サーバー用 PKCE フローで OAuth 認証コードを使用するための Azure でのアプリケーションの設定方法については、[How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required)]を参照してください。

        • OAuth2 - クライアント資格情報: [Microsoft identity platform and the OAuth 2.0 client credentials flow]を参照してください。

          IMAP/POP3 メール サーバー用 OAuth 2.0 クライアント資格情報フローを使用するための Azure でのアプリケーションの設定方法については、「How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required)」を参照してください。

        • Control Room管理
          Gmail を自動化するために Control Room 管理OAuth2 認証モードを使用するには、Control Room で OAuth 接続を設定する必要があります。 [OAuth 接続を作成する]を参照してください。
          注: Control Room OAuth ManagedはGmailのみをサポートし、Outlookクライアントはサポートしていません。

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

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

          • 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 メール サーバーへのアクセスに使用するユーザー名を入力します。

          例: john.smith@myCompanyName.com

        • パスワード: 指定したユーザー名のパスワードを入力します。
        • クライアント ID、テナント ID、リダイレクト URI、および クライアント シークレット フィールドには、Azure portalのアカウントに提供されている情報を入力します。
        • E メール プロバイダー: ドロップダウン リストから E メール サービス プロバイダーを選択します。
          • Outlook/Office365

            このオプションを選択した場合、テナント ID を入力してください。

          • Gmail
        ユーザー名、パスワード、テナント ID、クライアント ID および クライアント シークレット フィールドについては、次の 資格情報、変数 または 安全でない文字列 タブから選択します。
        • 資格情報: 資格情報コンテナーで利用可能な値を使用します。
        • 変数: 値を格納するユーザー定義変数を使用します。
        • 安全でない文字列: 値を手動で入力します。
    • EWS オプションを選択した場合は、以下のフィールドに入力します。
      • Exchange のバージョン: 組織で使用しているバージョンを選択します。
        • Exchange Server 2013
        • Exchange2010_SP2
        • Exchange2010_SP1
        • Exchange2010
        • Exchange2007_SP1
      • Azure クラウド: 組織で使用している製品を選択します。
        • Azure Global: Microsoft 365 Commercial バージョン (login.microsoftonline.com) のユーザー向け
        • Azure US GCC High: Microsoft 365 Government バージョン (login.microsoftonline.us) のユーザー向け
      • 任意: ドメイン名:
        • Microsoft 365 のユーザーがこのフィールドを空白のままにすると、Automation Workspace は smtp.office365.com を使用してサーバーに接続します。
        • Microsoft 365 のユーザーユーザー名フィールドにドメイン名を入力した場合は、必ずこのフィールドに smtp.office365.com を入力する必要があります。
        • Microsoft 365 のユーザーでない場合は、組織のドメイン名を入力してください。 それ以外の場合、Automation Workspace では ユーザー名 フィールドに入力したドメイン名が使用されます。
      • 認証モード: 次の認証モードから選択します。
        注: Automation 360 v.27 以降では、認証タイプ OAuth2-Silent 認証モード は OAuth2-ROPC に、OAuth2-Interactive 認証モード は OAuth2-Implicit に名称が変更されます。

        EWS を使用した共有メールボックスへの接続に問題がある場合は、[Unable to connect to shared mailbox using EWS error (A-People login required)]を参照してください。

        選択した認証モードに応じて、以下のフィールドの詳細を適宜指定する必要があります。
        • ユーザー名: E メール サーバーへのアクセスに使用するユーザー名を入力します。

          例: john.smith@myCompanyName.com

        • パスワード: 指定したユーザー名のパスワードを入力します。
        • [クライアント ID]、[テナント ID]、[リダイレクト URI]、および [クライアント シークレット] フィールドには、Azure portalのアカウントに提供されている情報を入力します。
        • テスト接続: テスト接続 をクリックしてアカウントにサインインし、認証に要求された許可を受け入れ、サーバーとの接続を確立します。
          注:
          • デスクトップ操作を行い、テスト接続 をクリックしても、変数 (Credential、Credential 変数、Sting 変数など) については、現在サポートされていません。
          • デスクトップ操作を実行し、テスト接続 をクリックしてアカウントにサインインする場合、次のリダイレクト URI を追加します: https://outlook.office365.com
        [ユーザー名]、[パスワード]、[テナント ID]、[クライアント ID] および [クライアント シークレット] フィールドについては、次の [資格情報]、[変数] または [安全でない文字列] タブから選択します。
        • 資格情報: 資格情報コンテナーで利用可能な値を使用します。
        • 変数: 値を格納するユーザー定義変数を使用します。
        • 安全でない文字列: 値を手動で入力します。
      • 接続タイムアウト時間 (秒) (任意) このフィールドでは、EWSサーバーへの接続を確立するために必要な時間を指定します。 タイムアウト値を10秒から60秒の間で設定できます。 デフォルトでは、接続タイムアウト時間 (秒) (任意) フィールドは10秒に設定されています。
  4. 保存 をクリックします。