エージェント電子メール用の UCCX と Office 365 の統合

概要

この文書では、バージョン 11.5 以降の Unified Contact Center Express（UCCX）ソリューションが SocialMiner（SM）とともにエージェント電子メール機能用の電子メール サーバとして Office 365 をどのようにサポートするかについて説明します。 これは、エージェントの電子メール機能用としてサポートされる最初のクラウド電子メール プロバイダーです。

設計とトポロジ

11.5 以降の UCCX サーバでは、クラウド電子メール サポートを提供するようになりました。 この機能は、SOCKS 5 プロキシ経由で Office 365 電子メール サービスに統合することによって使用できるようになります。 プロキシ サーバを持つことは必須ではありませんが、ほとんどの導入において外部ネットワーク アクセスがブロックされているため、プロキシ サーバ経由で接続を確立する必要があることを認識しておくことが重要です。

プロキシを設定するための追加の手順以外に顧客にとっての変更はありません。 次のイメージにメッセージ フローを示します。

設定

1. Office 365 に接続するためにプロキシ サーバを持つことは必須ではありません。 SM サーバが office365.com の Internet Message Access Protocol (IMAP) ポートと Simple Mail Transfer Protocol（SMTP）ポート上で TCP 接続を設定できるようにネットワークの接続性を設定すれば、プロキシ サーバは必要ありません。
   
   
2. SM と Office 365 間でプロキシを使用する場合は、SOCKS 5 のみがサポートされるプロトコルになります。 SOCKS4、SSH トンネル、他のプロトコルはサポートされません。
   
   
3. どのプロキシ サーバを使用する必要があるかについては推奨していません。

プロキシの設定

このテクニカルノートの一部として、Dante と呼ばれる Linux 用のオープン ソース プロキシ サーバを使用します。 ですが、これがシスコが推奨するプロキシ サーバということではありません。 このドキュメントを作成するためにラボで使用されるサーバの 1 つです。 SOCKS5 プロトコルが使用されている限り、どのサーバも自由に使用できます。

注: プロキシとして設定されているサーバは、さらなるプロキシを持つことなしに office365.com にアクセスできなければなりません。

ルートへのアクセス権を持つ Linux サーバの場合：

手順 1：Dante サーバをインストールします。

手順 2：/Etc/danted.conf ファイルに次の情報を追加してサーバを設定します。

手順 3：使用可能な状態となったサーバを起動します。

Dante サーバとインストール パッケージのダウンロードに関する詳細については、次を参照してください。 https://www.inet.no/dante/index.html

Office 365 アカウント

ログイン ポータル： https://login.microsoftonline.com

支払済 Office365 アカウントを買うために、クレジットカードとの https://products.office.com/en/exchange/compare-microsoft-exchange-online-plans に行って下さい。 （基本価格オプションは 1ヵ月あたり電子メール アカウントごとに税抜きで 4 ドルです。）

注: Office 365 サービスに登録する際、お客様に割り当てられたサービスが、SocialMiner サーバがある国と同じ国から提供されていることを確認してください。 これは非常に重要です。相違がある場合は、接続の問題が発生します。 

UCCX/SM の設定

このセクションでは、エージェント電子メール用に Unified CCX と Office 365 の統合を設定するための高レベルのタスクと関連情報について説明します。

トラブルシューティング

関連ログ

これらのログは、Office 365 に関連した問題をデバッグするのに重要です。

• ランタイム ログ： https://<SocialMiner サーバ IP/ホスト>/ccp-webapp/logs/runtime/
  ファイル パターン： CCBU-runtime。*.startup.log、Error-runtime。*.startup.log
  
  
• API ログ： https://<SocialMiner Server IP/Host>/ccp-webapp/logs/ccapi/
  ファイル パターン： CCBU-ccpapi。*.startup.log、Error-ccpapi。*.startup.log

チェックリスト

Office 365 の機能が SocialMiner システム内で想定どおりに正常に機能するように、次の事項を確認します。

• SocialMiner が Office 365 に直接到達できるかどうか確認します。
  
  
• SocialMiner が Office 365 に到達できない場合は、SocialMiner 内で Socks プロキシを設定して有効にします。
  
  
• Socks 5 プロトコルのみがサポートされます。
  
  
• Socks プロキシ サーバが Office 365 に到達できることを確認します。
  
  
• CCX 内で Office 365 のクレデンシャルにチェック マークを付けます。
  
  
• SocailMiner 内で Office 365 の電子メール フィード ステータスにチェック マークを付けます。

  • フィードを正常に取得している場合は、次のイメージに示すとおり緑色になり、× マーク（x）付きの赤色にはなりません。

  • フィードが破損している場合は、赤い × マーク（x）の上にカーソルを合わせると理由を確認することができます。

注: Socks プロキシを再設定すると、最新の Socks プロキシ設定を使用するために、既存のすべての電子メール フィードが自動更新されます。

一般的なシナリオ

問題： エージェントが電子メールを受信できません。

考えられる原因 1： Socks プロキシが設定されていない/有効になっていない

ランタイム ログに次のエラーが表示されます。

exception=javax.mail.MessagingException: connect timed out;

推奨処置：

• Socks プロキシ サーバを設定して有効にします。
  
  
• SocialMiner から Socks プロキシが到達可能であり、Socks プロキシ サーバが Office 365 に到達できることを確認します。

考えられる原因： 認証済みの Socks プロキシ サーバを使用している場合は、入力したクレデンシャルが正しくない

ランタイム ログに次のエラーが表示されます。

exception=javax.mail.MessagingException: SOCKS : authentication failed;

推奨処置：

• 正しいクレデンシャルを入力することにより、認証の問題が解決します。
  
  

• SocialMiner から Socks プロキシが到達可能であり、Socks プロキシ サーバが Office 365 に到達できることを確認します。

問題： Office 365 を使用して電子メールを送信する際に遅延が発生します。

推奨処置： 

• 電子メールの送信に 10 秒以上かかる場合は、Office 365 への SMTP 接続が遅延を引き起こしているかどうかを確認します。
  
  
• IMAP 経由で Thunderbird または Outlook クライアントを使用して Office 365 を設定します。 認証済みの SMTP 接続で電子メールの送信に時間がかかる場合は、SocialMiner においても同じ遅延問題が発生しているサインです。
  
  
• 問題は Office 365 に起因します。 Office 365 サポートに連絡してください。

Microsoft 診断ツール

Office 365 サービスとの接続に問題があるため、サービスのステータスをチェックしたい場合は、このために使用できる Microsoft ツールがあります。 ツールは、Office 365 サポート/回復アシスタントと呼ばれるもので、ここからダウンロードできます。 https://diagnostics.outlook.com/#/

このツールに関する詳細については、次を参照してください。 https://blogs.office.com/2016/05/11/new-tool-for-helping-resolve-office-365-issues/

マニュアルの入手方法およびテクニカル サポート

資料の入手方法、Cisco Bug Search Tool（BST）の使用法、サービス要求の送信方法、および追加情報の収集方法については、『What’s New in Cisco Product Documentation（Cisco 製品資料の更新情報）』を参照してください。このドキュメントは次から入手できます。  http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

『What’s New in Cisco Product Documentation（Cisco 製品資料の更新情報）』に配信登録すると、新しい（または改訂された）シスコ技術情報のリストが RSS フィードとして提供され、リーダー アプリケーションを使ってコンテンツがデスクトップに直接配信されるようにすることができます。 RSS フィードは無料のサービスです。

このマニュアルに記載されている製品に関する仕様および情報は予告なしに変更されることがあります。 このマニュアルに記載されている表現、情報および推奨事項は、すべて正確なものだと考えられていますが、明示的であれ黙示的であれ、一切の保証を負うものではありません。 製品の使用にあたってのすべての責任は、ユーザー側にあります。

対象製品のソフトウェア ライセンスおよび限定保証は、製品に添付された『INFOMRATION PACKET』に記載されており、これが証明書となります。 このソフトウェアライセンスまたは限定保証を見つけられない場合は、CISCO の代理店に連絡しコピーを入手してください。

シスコによる TCP ヘッダー圧縮の実装には、カリフォルニア大学バークレー校（UCB）が UNIX オペレーティング システムの UCB パブリック ドメイン バージョンの一部として開発したプログラムを使用しています。 All rights reserved. Copyright © 1981, Regents of the University of California.

ここに記載されているその他のあらゆる保証にもかかわらず、すべてのマニュアルおよび上記各社のソフトウェアは、障害も含めて「現状のまま」として提供されます。 シスコシステムズおよびこれら各社は、商品性の保証、特定目的への準拠の保証、および権利を侵害しないことに関する保証、あるいは取引過程、使用、取引慣行によって発生する保証をはじめとする、明示されたまたは黙示された一切の保証の責任を負わないものとします。

いかなる場合においても、シスコシステムズおよびその供給者は、このマニュアルの使用またはこのマニュアルを使用できないことによって発生する利益の損失やデータの損失または損傷をはじめとする、間接的、特殊、結果的、あるいは偶発的なあらゆる損害について、一切の責任を負うものではありません。シスコシステムズおよびその供給者がそうした損害の可能性について知らされている場合でも例外ではありません。

このマニュアルで使用している IP アドレスおよび電話番号は、実際のアドレスおよび電話番号を示すものではありません。 マニュアル内の例、コマンド出力、ネットワーク トポロジ図、およびその他の図は、説明のみを目的として使用されています。 説明の中に実際のアドレスおよび電話番号が使用されていたとしても、それは意図的なものではなく、偶然の一致によるものです。

印刷されたハード コピーおよび複製されたソフト コピーは、すべて管理されていないコピーです。最新バージョンについては、オンライン版の原本を参照してください。

シスコは世界各国 200 箇所にオフィスを開設しています。 各オフィスの住所、電話番号、FAX 番号については当社の Web サイト（www.cisco.com/go/offices/）をご覧ください。

Cisco およびシスコ ロゴは、シスコまたはその関連会社の米国およびその他の国における商標または登録商標です。 シスコの登録商標は、次の URL でご確認ください。 www.cisco.com/go/trademarks 記載されているサードパーティの商標は、それぞれの所有者に帰属します。 「パートナー」または「partner」という用語の使用はシスコと他社との間のパートナーシップ関係を意味するものではありません。 （1110R）。

© 2016 Cisco Systems, Inc. All rights reserved.