Communications Mining ガイド

最終更新日時 2025年11月10日

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 から

統合エラー

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

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

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

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

資格情報が正しくない
期限切れの資格情報
データのアップロードのクォータ制限に達した
Exchange サーバーの詳細の構成の誤り

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

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

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

構成

Exchange Online

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

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

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

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

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

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

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