将UCCX与Office 365集成，用于代理电子邮件

简介

本文档介绍Unified Contact Center Express(UCCX)解决方案(从版本11.5开始，与SocialMiner(SM)配合使用)如何支持Office 365作为代理电子邮件功能的电子邮件服务器。这是第一个支持代理电子邮件功能的云电子邮件提供商。

设计和拓扑

UCCX服务器现在从11.5开始提供云电子邮件支持。此功能通过通过SOCKS 5代理集成到Office365电子邮件服务来实现。请务必注意，拥有代理服务器不是必需的，但大多数部署都阻止了外部网络访问，因此必须通过代理服务器建立连接。

除设置代理的额外步骤外，客户没有其他更改。消息传送流程如图所示：

配置

1. 不必使用代理服务器连接到Office 365。如果您的网络连接设置方式使得SM服务器可以在office365.com的Internet邮件访问协议(IMAP)和简单邮件传输协议(SMTP)端口上设置TCP连接，则不需要代理服务器。
   
   
2. 如果您希望在SM和Office 365之间使用代理，SOCKS 5是唯一受支持的协议。不支持SOCKS4、SSH隧道和其他协议。
   
   
3. 思科不建议使用哪个代理服务器。

设置代理

作为此技术说明的一部分，使用了适用于Linux的开源代理服务器Dante。请注意，这并不意味着这是思科推荐的代理服务器；它是本实验中用于创建此文档的服务器之一。只要使用SOCKS5协议，您就可以自由使用任何选择的服务器。

注意：配置为代理的服务器必须能够访问office365.com，无需使用其他代理。

在具有root权限的Linux服务器上：

步骤1.安装Dante服务器。

步骤2.通过将此信息添加到/etc/danted.conf文件来配置服务器。

步骤3.启动服务器，准备使用。

有关Dante服务器和下载安装软件包的详细信息，请访问以下网址：https://www.inet.no/dante/index.html

Office365帐户

登录门户：https://login.microsoftonline.com

要购买已付费的Office365帐户，请使用您的信用卡访问https://products.office.com/en/exchange/compare-microsoft-exchange-online-。（基本定价选项每个电邮帐户每月税前成本为4美元。）

注意：注册Office365服务时，请确保分配给您的服务来自SocialMiner服务器所在的国家/地区。这一点非常重要，否则您将会遇到连接问题。 

配置UCCX/SM

本节提供配置Unified CCX与Office 365集成的高级任务和相关信息，以供代理电子邮件使用。

配置任务	参考	详细步骤
1.配置Unified Communications Manager服务器。	请参阅Cisco Unified Communications Manager安装和升级指南
2.为Unified CCX配置Unified Communications Manager。	请参阅Cisco Unified Communications Manager配置指南
3.配置Unified CCX。	请参阅Cisco Unified Contact Center Express安装和升级指南
4.配置SocialMiner。	请参阅Cisco Unified CCX管理指南，版本11.5的SocialMiner配置一章	步骤1:  从Unified CCX Administration菜单栏导航到Subsystems > Chat and Email > SocialMiner Configuration。 系统将显示SocialMiner Configuration网页。 第 2 步：  为SocialMiner完成或修改以下字段： IP地址/主机名：SocialMiner服务器的IP地址或完全限定域名。例如，192.168.1.5或host.example.com。 SocialMiner管理员的用户名/密码。 注意：Unified CCX和SocialMiner服务器必须具有DNS条目。SocialMiner必须可通过主机名访问Unified CCX。如果条目无效，则会显示错误。 第 3 步：  单击Save保存更改。 如果看到错误消息，请单击Save以在SocialMiner中重新创建聊天和电子邮件的源、活动和通知。
5.配置Unified CCX邮件服务器。	请参阅Cisco Unified CCX管理指南，版本11.5的邮件服务器配置一章	步骤1.从Unified CCX Administration菜单栏导航到子系统 > 聊天和电子邮件 > 邮件服务器配置。将打开邮件服务器配置网页。 步骤2.填写Office 365邮件服务器的字段，如图所示：
6.配置Socks代理服务器		如果Office 365访问需要代理： 系统参数配置 在系统参数(System Parameters)页面的代理参数(proxy parameters)部分添加主机名、端口、用户名和密码(password)字段。（用户名/密码是可选的）
7.联系服务队列配置	请参阅Cisco Unified CCX管理指南，版本11.5的联系服务队列配置一章
8.预定义的响应配置	请参阅Cisco Unified CCX管理指南，版本11.5的预定义响应一章
9.信道参数配置	请参阅Cisco Unified CCX管理指南，版本11.5的通道参数一章

故障排除

相关日志

这些日志对于调试O365相关问题非常重要。

• 运行时日志:https://<SocialMiner Server IP/Host>/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

核对清单

检查以下各项以确保Office365功能在SocialMiner系统中按预期正常工作：

• 检查SocialMiner是否可以直接访问Office365。
  
  
• 如果SocialMiner无法访问Office365，请在SocialMiner中配置Socks代理并启用它。
  
  
• 仅支持Socks 5协议。
  
  
• 确保Socks代理服务器能够访问Office365。
  
  
• 检查CCX中的Office365凭据。
  
  
• 检查SocailMiner中的Office365电子邮件馈送状态

  • 如果进纸正常取出，绿色而不是红色的十字标记(X)，如图所示。

  • 如果源文件已损坏，可以将鼠标悬停在红十字标记(X)上以了解原因。

注意：在Socks代理重新配置后，所有现有邮件源将自动更新为使用最新的Socks代理配置。

常见情况

问题：座席无法接收电子邮件。

可能的原因1：未配置/启用Socks代理

在运行时日志中，显示此错误：

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

建议操作:

• 配置Socks代理服务器并启用它。
  
  
• 确保可以从Socks代理访问Socks代理，并且Socks代理服务器可以访问O365。

可能：如果使用经过身份验证的Socks代理，则提供的凭证不正确

在运行时日志中，显示此错误：

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

建议操作:

• 通过提供正确的凭证解决身份验证问题。
  
  

• 确保可以从Socks代理访问Socks代理，并且Socks代理服务器可以访问O365。

问题：使用Office365发送电子邮件延迟。

建议操作: 

• 如果发送电子邮件的时间超过10秒，请查找是否是由与Office365的SMTP连接导致延迟的原因。
  
  
• 通过IMAP使用Thunderbird或outlook客户端配置Office365。如果通过身份验证的SMTP连接发送电子邮件花费较长时间，则表明在SocialMiner中也存在同样缓慢的问题。
  
  
• 问题出自Office365。请与Office365支持部门联系。

Microsoft诊断工具

如果您在使用Office365服务的连接时遇到问题，并想要检查服务的状态，可以使用Microsoft提供的工具。此工具称为支持和恢复助手，可从此处下载：https://diagnostics.outlook.com/#/

有关同一内容的更多详细信息：https://blogs.office.com/2016/05/11/new-tool-for-helping-resolve-office-365-issues/

获取文件并提交服务请求

有关获取文档、使用思科漏洞搜索工具(BST)、提交服务请求和收集其他信息的信息，请参阅思科产品文档更新，网址为： http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html。

订阅思科产品文档的新增内容，其中列出所有新的和修订的思科技术文档，这些文档作为RSS源，并使用阅读器应用程序将内容直接传送到您的桌面。RSS源是一项免费服务。

本手册中有关产品的规格和信息如有更改，恕不另行通知。我们尽力确保本手册提供的所有声明、信息和建议均准确可靠，但不对其作任何明示或暗示的保证。用户必须对其任何产品的使用承担全部责任。

相伴产品的软件许可证和有限保证书在产品随带的信息包中进行了阐述，在此一并纳入本参考资料。如果您无法找到软件许可证或有限保证书，请向您的 CISCO 代表联系索取一份。

Cisco 实现的 TCP 报头压缩改编自 University of California, Berkeley (UCB) 开发的、作为 UNIX 操作系统的 UCB 公用域版本组成部分的程序。保留所有权利。版权所有 ©1981，University of California 董事。

不管本文其他地方列出了何种保证，这些供应商的所有文档和软件均“按现状”提供并可能带有各种缺陷。CISCO 和上面所提及的提供商拒绝所有明示或暗示的保证，包括但不限于特定用途的适销性、适合性保证和非违背性保证，或者因卖买或使用以及商业惯例所引发的保证。

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

本文档中使用的任何Internet协议(IP)地址和电话号码都不是实际地址和电话号码。本文档中包含的任何示例、命令显示输出、网络拓扑图和其他图仅作说明之用。在说明性内容中使用实际IP地址或电话号码是无意的，而且纯属巧合。

所有打印副本和重复软副本被视为不受控制的副本，必须参考原始在线版本才能获得最新版本。

Cisco 在全球设有超过 200 个办事处。思科网站www.cisco.com/go/offices上列出了地址、电话号码和传真号码。

Cisco 和 Cisco 徽标是思科和/或其附属公司在美国和其他国家/地区的商标或注册商标。要查看思科商标列表，请访问此URL:www.cisco.com/go/trademarks。文中提及的第三方商标为其相应所有者的财产。使用文字“合作伙伴”并不暗示 Cisco 与任何其它公司存在合作关系。(1110R)

© 2016 Cisco Systems， Inc.版权所有。