Exchange の統合

Automation Cloud 上の IXP の Exchange との連携により、請求の詳細や設定の概要などのメール データを Communications Mining に同期できます。

警告:

Microsoft は、2026 年 10 月 1 日に Exchange Online の Exchange Web サービス (EWS) を廃止します (Microsoft の発表)。Exchange との連携をできるだけ早く Microsoft Graph API に切り替えることをお勧めします。移行手順については、「 EWS から Microsoft Graph API への移行ガイド」をご覧ください。

概要

Exchange との連携を使用すると、開発用と運用用のメール データを Communications Mining™ にリアルタイムで同期できます。

注:

メールのテキスト ID に基づいて、作成されたコメント 1 件につき、または 更新されたコメント 1 件につき、1 AI ユニットまたは 0.2 プラットフォーム ユニットが請求されます。

Exchange 連携は、Exchange サーバーを継続的にポーリングして、構成されたメールボックスに新しいメールがないかどうかを確認します。 メールはクリーニングされ、エンリッチされて、Communications Mining のコメント オブジェクトに変換され、Communications Mining Web プラットフォームのユーザーや、Communications Mining API を介したアプリケーションやボットがアクセスできます。 Exchange との連携は、Communications Mining Cloud で実行されます。

ポーリングするメールボックスは Communications Mining UI で簡単に構成できます。このUI には、統合を開始または停止したり、Exchange サーバーへの接続に使用する構成パラメーターを更新したりする機能もあります。

注:

• Exchange との連携は、Exchange Online および Exchange Web Services (EWS) を使用する Microsoft Exchange 2010-2019 サーバーと互換性があります。
• Exchange 統合は、HTTPS 経由で認証された GET 要求を行うことによって、Exchange サーバーをポーリングします。 Exchange 統合は、開始した GET 要求を介してデータを受信し、他の場所で開始された受信接続は受け付けません。 Exchange 統合は、特定の暗号を使用して構成できます。
• Exchange 統合にメールボックスへの読み取り専用アクセス権を付与するだけで十分です。

メールの同期方法

統合は、構成された各メールボックスからの電子メールを継続的に同期します。 開始時刻を指定しない場合、すべてのメールが同期されます。

この連携により、コメントの message_id が、同期されたメールの 16 進数エンコード comment ID に設定されます。同じメールを含む複数のメールボックスが (たとえば、同じメールの [CC] フィールドに追加されたために) 同じバケットに同期された場合、結果のコメントには、重複するメールのうち最後に同期されたメールのメタデータが含まれます。

この連携により、対応するメールが別のフォルダーに移動されると、コメントの フォルダー ユーザー プロパティが更新されます。コメントの件名または本文が送信または受信後にメール内で更新されても、連携によって更新されることはありません。

Exchange との連携では、添付ファイルの同期をメールボックス レベルで有効化することもできます。その後、ストリーム API によって、添付ファイルの参照を介して添付ファイルを取得できるようになります。添付ファイルの同期について詳しくは、「 添付ファイル 」および 「Exchange との連携を使用する 」をご覧ください。

次の図に、次の値を使用したメールボックス構成の例を示します。

• バケット: メールボックス (org2/example-2b2f8982)

• コンテンツ フィルター ルール:

  • 明示的に許可されるフォルダー: ルート/インフォメーション ストアの上部/受信トレイ
  • 明示的に拒否されたフォルダー: なし
  • 2023 年 2 月 1 日 12:00 AM UTC から
  注:

  インフォメーション ストアの上部/は、ユーザーの言語ではなく、Exchange サーバーの言語で表す必要があります。

  フォルダー フィルターを適用する際は、以下の点を考慮してください。

  • 入れ子になったフォルダーはスラッシュ /で区切られます。
  • Outlook に表示されるフォルダーには、通常、プレフィックスとして root/Top of Information Storeが付きます。
  • フォルダーを許可すると、明示的に許可されていないフォルダーは拒否されます。
  • 許可されているフォルダー内のフォルダーを拒否できます。
  • 拒否されたフォルダー内のフォルダーを許可することはできません。
  ヒント:

  フォルダー フィルターの対象範囲を、ユース ケースで必要最小限の範囲に制限します。許可されたフォルダを空のままにしておくと、アーカイブや回復可能なアイテム(消去)を含むメールボックス内のすべてのフォルダから同期が継続的に行われるため、同期が大幅に遅くなります。ほとんどの BAU 処理では、以下のみを許可します。

  • root/Top of Information Store/Inbox
  • root/Top of Information Store/Sent Items

  

統合エラー

永続的な問題が発生している統合は、統合が正しく構成されていない場合は統合レベルで自動的に無効になり、メールボックスが正しく構成されていない場合はメールボックスレベルで自動的に無効になります。

1 つまたは複数の問題に対処するように通知され、解決したら連携を再度有効化できます。

これは、メールボックスが見つからない場合、メールボックスが削除された場合、サービス アカウントが受信トレイにアクセスできない場合、または資格情報の有効期限が切れて更新が必要な場合に発生します。問題が 1 つのメールボックス (メールボックスなど) にのみ影響する場合、アプリケーションはアクセスを許可されず、そのメールボックスのみが無効化され、連携の残りの部分は同期が続行されます。

連携を無効にするエラーの例を次に示します。

• 資格情報が正しくない
• 期限切れの資格情報
• データのアップロードのクォータ制限に達した
• Exchange サーバーの詳細の設定ミス

メールボックスを無効にするエラーの例を次に示します。

• サービス アカウントまたはアプリ認証の権限が無効です
• メールボックス アドレスのスペルが間違っている
• メールボックスが削除されました

ほとんどのメールボックス エラーには、Microsoft によって返される未修正のエラー「 Error details: (エラーの詳細: )」という行が含まれており、ここには根本的な原因が示されます。発生する可能性が高いエラー、その原因、および解決方法については、「 Exchange との連携のトラブルシューティング」をご覧ください。

通知に登録する

以下のいずれかのロールを持っている場合、アラートと連携エラーの通知は自動サブスクライブされます。

• IXP プロジェクト管理者
• IXP モデル トレーナー
• IXP 開発者
• IXP ビューアー
• IXP アナリスト

通知サービスを使用して自己登録または登録解除することもできます。通知の設定を管理するには、「 通知を管理する」をご覧ください。

連携の設定を更新するには、 IXP プロジェクト管理者 または IXP 開発者 のロールが必要です。

構成

Exchange Online

新しい連携については、「Microsoft Graph API ガイド」をご覧ください。

• Exchange と Azure Application Authentication and Graph の統合

以下のガイドでは、Microsoft が 2026 年 10 月 1 日に Exchange Online で廃止する EWS API について説明します。これらの連携は、既存の EWS 連携を維持する場合にのみ使用し、Graph への移行については「 EWS から Microsoft Graph API への移行ガイド 」をご覧ください。

• Exchange と Azure アプリケーション認証の統合
• Exchange と Azure サービス ユーザーとの連携

セルフホスト型 Exchange サーバー

セルフホスト Exchange サーバーは、NTLM 認証のみを使用して EWS API 経由でサポートされます。クライアント シークレットまたは秘密キーのいずれかを使用する OAuth 認証は、Exchange Online でのみ使用できます。

NTLM サービス アカウントを設定し、同期するメールボックスへの読み取りアクセス権をサービス ユーザーの代理人に付与します。

注:

Exchange との連携は UiPath Automation Cloud™ で実行されるため、EWS エンドポイントはインターネットからアクセス可能で、パブリック IP アドレスに解決できる必要があります。

以下の詳細情報を収集します。

• EWS エンドポイント - Exchange サーバー上の EWS サービスの完全な URL です。パスは /EWS/Exchange.asmxで終わる必要があります (例: https://mail.example.com/EWS/Exchange.asmx)。
• サービス ユーザーのユーザー名とパスワード。
• サービス ユーザーがアクセスできるテスト メールボックスです。保存時に資格情報を確認するために使用されます。
• 任意で、Exchange サーバーのビルド番号を入力します。
• 同期するメールボックスのリスト。

Communications Mining で連携を設定するには、以下の手順を実行します。™

1. [ 管理 ] ページに移動し、[ 連携 ] タブを選択します。
2. [新しい連携] を選択します。
3. [ アプリケーションに接続する] で [ EWS API] を選択します。
4. [ NTLM を使用] を選択し、EWS エンドポイント、ビルド番号 (ある場合)、およびテスト メールボックスを入力します。
5. [ サービス ユーザー アクセス] を選択し、サービス ユーザーのユーザー名とパスワードを入力します。
6. [資格情報の検証と保存] を選択します。
7. 「 Exchange との連携を使用する」の説明に従って、同期するメールボックスを追加します。

重要:

[時刻フィルター] セクションで [全期間] を選択した場合、予想よりも多くのデータが同期される可能性があります。この場合、アップロード時にメッセージに課金されます。