Exchange の統合

注:

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

概要

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

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が付きます。
  • フォルダーを許可すると、明示的に許可されていないフォルダーは拒否されます。
  • 許可されているフォルダー内のフォルダーを拒否できます。
  • 拒否されたフォルダー内のフォルダーを許可することはできません。

  

統合エラー

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

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

この問題は、メールボックスが削除された場合、サービス アカウントが受信トレイにアクセスできない場合、または資格情報の有効期限が切れて更新する必要がある場合に、メールボックスが見つからない場合に発生します。

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

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

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

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

  [連携の表示] 権限を持っている場合は通知に自動的に登録されますが、通知サービスを通じて自己登録または配信停止することもできます。連携の設定を更新するには、[ 連携の変更 ] 権限が必要です。

構成

Exchange Online

ステップバイステップガイドのいずれかに従ってください。

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

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

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

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

• Exchange サーバーの URL
• サービスユーザーのユーザー名とパスワード
• アクセスの種類 (代理人または偽装)
• 同期するメールボックスのリスト。

チュートリアルの「Communications Mining™ で新しい連携を作成する」の説明に従って、Exchange との連携を構成します。NTLM オプションを選択し、収集した詳細情報 (Exchange サーバーの URL、サービス ユーザーのユーザー名とパスワード、アクセスの種類、同期するメールボックスのリスト) を入力します。

重要:

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