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 統合は、特定の暗号を使用して構成できます。
• It is enough to give the Exchange integration read-only access to your mailboxes.

メールの同期方法

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

The integration will set the message_id of the comment to the hex-encoded comment ID of the synced email. If multiple mailboxes containing the same email, for example, due to being added to the CC field of the same email, are synced into the same bucket, the resulting comment will have the metadata of the last synced of the duplicate emails.

The integration will update the Folder user property of a comment when the corresponding email is moved to a different folder. The integration will not update the comment subject or body if either is updated in the email after it has been sent or received.

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

The following image contains an example of a mailbox configuration with the values:

• Bucket: Mailbox (org2/example-2b2f8982)
• Content Filter Rules:
  • Explicitly allowed folders: root/Top of Information Store/Inbox
  • Explicitly denied folders: None
  • From February 1, 2023 12:00 AM UTC

統合エラー

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

You will be notified to address one or more issues, and once resolved, you can re-enable the integration.

This happens when the mailbox cannot be found, in case it was deleted, the service account does not have access to the Inbox, or the credentials expired and need to be updated.

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

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

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

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

Note: You will be auto-subscribed to notifications if you have the View integrations permission, but can also self-subscribe or unsubscribe through the Notification Service. To update integration configurations, the Modify integrations permission is required.

構成

Exchange Online

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

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

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

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

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

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

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

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