Communications Mining ガイド

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

Exchange の統合

Note: You will be charged 1 AI Unit or 0.2 Platform Units per created comment, or per updated comment, based on the Message ID of the email, if its text was modified.

概要

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

Exchange 統合アーキテクチャ

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

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

注:

MICROSOFT 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'edされているため)は同じバケットに同期され、結果のコメントには、重複する電子メールの最後に同期されたメタデータが含まれます。

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

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

統合エラー

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

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

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

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

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

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

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

手記：[連携の表示] 権限がある場合は通知が自動サブスクライブされますが、通知サービスからセルフサブスクライブ (または配信停止) することもできます。統合構成を更新するには、 統合の変更 権限が必要です。

構成

Exchange Online

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

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

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

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

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

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

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