Integración de UCCX con Office 365 para correo electrónico de agentes

Introducción

Este documento describe cómo la solución Unified Contact Center Express (UCCX), a partir de la versión 11.5 junto con SocialMiner (SM), admite Office 365 como servidor de correo electrónico para la funcionalidad de correo electrónico de agentes. Se trata del primer proveedor de correo electrónico en la nube compatible con la funcionalidad de correo electrónico de agente.

Diseño y topología

El servidor UCCX ofrece ahora compatibilidad con correo electrónico en la nube a partir de la versión 11.5. Esta funcionalidad se logra mediante una integración con el servicio de correo electrónico Office 365 a través de un proxy SOCKS 5. Es importante tener en cuenta que disponer de un servidor proxy no es obligatorio, pero la mayoría de las implementaciones tienen bloqueado el acceso a la red externa y, por lo tanto, la conexión debe establecerse a través de un servidor proxy.

Aparte del paso adicional de configurar el proxy, no hay otro cambio para el cliente. El flujo de mensajes se muestra en la imagen:

Configuración

1. No es obligatorio disponer de un servidor proxy para conectarse a Office 365. Si la conectividad de red está configurada de tal forma que el servidor SM puede configurar una conexión TCP en los puertos de protocolo de acceso a mensajes de Internet (IMAP) y protocolo simple de transferencia de correo (SMTP) de office365.com, no es necesario un servidor proxy.
   
   
2. Si desea utilizar un proxy entre el SM y Office 365, SOCKS 5 es el único protocolo admitido. No se soportan SOCKS4, túneles SSH y otros protocolos.
   
   
3. Cisco no recomienda qué servidor proxy se debe utilizar.

Configuración del proxy

Como parte de esta nota técnica, se utiliza un servidor proxy de código abierto para Linux llamado Dante. Tenga en cuenta que esto no significa que este sea el servidor proxy recomendado por Cisco; es uno de los servidores utilizados en el laboratorio para crear este documento. Puede utilizar cualquier servidor de su elección siempre que utilice el protocolo SOCKS5.

Nota: El servidor que se está configurando como proxy debe tener acceso a office365.com, sin necesidad de tener más proxies.

En un servidor Linux con acceso raíz:

Paso 1. Instale el servidor Dante.

Paso 2. Configure el servidor agregando la siguiente información al archivo /etc/danted.conf.

Paso 3. Inicie el servidor, listo para usar.

Puede encontrar más información sobre el servidor Dante y la descarga de los paquetes de instalación aquí: https://www.inet.no/dante/index.html

Cuenta de Office365

Portal de inicio de sesión:https://login.microsoftonline.com

Para comprar una cuenta de Office365 de pago, vaya a https://products.office.com/en/exchange/compare-microsoft-exchange-online-planes con su tarjeta de crédito. (La opción de precio básica cuesta 4 $ antes de impuestos por cuenta de correo electrónico al mes.)

Nota: al suscribirse al servicio Office365, asegúrese de que el servicio que tiene asignado es del mismo país en el que se encuentra el servidor de SocialMiner. Esto es muy importante o tendrá problemas con la conectividad. 

Configuración de UCCX/SM

En esta sección se proporcionan las tareas de alto nivel y la información relacionada para configurar la integración de Unified CCX con office 365 for Agent Email.

Troubleshoot

Registros relevantes

Estos registros son importantes para depurar los problemas relacionados con O365.

• Registros de tiempo de ejecución: https://<IP/host del servidor de SocialMiner>/ccp-webapp/logs/runtime/
  Patrón de archivo: CCBU-runtime.*.startup.log, Error-runtime.*.startup.log
  
  
• Registros de API: https://<IP/host del servidor de SocialMiner>/ccp-webapp/logs/ccapi/
  Patrón de archivo: CCBU-ccpapi.*.startup.log, Error-ccpapi.*.startup.log

Lista de Verificación

Active estas opciones para asegurarse de que la funcionalidad de Office 365 funciona correctamente como se espera en un sistema SocialMiner:

• Compruebe si SocialMiner puede comunicarse directamente con Office365.
  
  
• Si SocialMiner no puede acceder a Office365, configure Socks Proxy en SocialMiner y habilítelo.
  
  
• Sólo se admite Socks 5 Protocol.
  
  
• Asegúrese de que el servidor proxy Socks puede alcanzar Office365.
  
  
• Compruebe las credenciales de Office 365 en CCX.
  
  
• Comprobar el estado de la fuente de correo electrónico de Office365 en SocialMiner

  • Si la fuente se está recuperando normalmente, sería verde y no rojo con la marca de la cruz (X), como se muestra en la imagen.

  • Si la fuente está rota, puede pasar el cursor por encima de la marca de la cruz roja (X) para saber el motivo.

Nota: tras la reconfiguración de Socks Proxy, todas las fuentes de correo electrónico existentes se actualizarán automáticamente para utilizar la última configuración de Socks Proxy.

Escenarios de ejemplo

Problema: los agentes no pueden recibir correos electrónicos.

Posible causa 1: el proxy de sockets no está configurado/habilitado

En los registros de tiempo de ejecución, se muestra el siguiente error:

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

Acción Recomendada:

• Configure el servidor proxy Socks y habilítelo.
  
  
• Asegúrese de que Socks Proxy es accesible desde SocialMiner y Socks Proxy Server puede alcanzar el O365.

Posible: si se usa el proxy de sockets autenticado, las credenciales proporcionadas son incorrectas

En los registros de tiempo de ejecución, se muestra el siguiente error:

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

Acción Recomendada:

• Resuelva el problema de autenticación proporcionando las credenciales correctas.
  
  

• Asegúrese de que el proxy Socks es accesible desde SocialMiner y de que el servidor proxy Socks puede alcanzar el O365.

Problema: retraso en el envío de correos electrónicos con Office365.

Acción Recomendada: 

• Si el envío de un correo electrónico tarda > 10 segundos, busque si la conexión SMTP a Office365 está causando el retraso.
  
  
• Configure Office365 mediante Thunderbird o el cliente de Outlook mediante IMAP. Si el envío de un correo electrónico tarda mucho tiempo con una conexión SMTP autenticada, también indica el mismo problema de lentitud en SocialMiner.
  
  
• El problema es de Office365. Póngase en contacto con el soporte técnico de Office365.

Herramienta de diagnóstico de Microsoft

Si tiene problemas con la conectividad con el servicio Office365 y desea comprobar el estado de su servicio, hay una herramienta de Microsoft que se puede utilizar. La herramienta se denomina Support and Recovery Assistant y se puede descargar desde aquí: https://diagnostics.outlook.com/#/

Más detalles sobre el mismo: https://blogs.office.com/2016/05/11/new-tool-for-helping-resolve-office-365-issues/

Obtención de documentación y envío de una solicitud de servicio

Para obtener información sobre cómo obtener documentación, utilizar la herramienta de búsqueda de errores de Cisco (BST), enviar una solicitud de servicio y recopilar información adicional, consulte Novedades de la documentación de productos de Cisco en: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.

Suscríbase a What’s New in Cisco Product Documentation (Novedades de la documentación de productos de Cisco), que enumera toda la documentación técnica de Cisco nueva y revisada, como una fuente RSS y envíe contenido directamente a su escritorio mediante una aplicación de lectura. Las fuentes RSS son un servicio gratuito.

LAS ESPECIFICACIONES E INFORMACIONES SOBRE LOS PRODUCTOS EN ESTE MANUAL ESTÁN SUJETAS A CAMBIO SIN AVISO PREVIO. TODAS LAS DECLARACIONES, INFORMACIÓN Y RECOMENDACIONES DE ESTE MANUAL SE CONSIDERAN EXACTAS, PERO SE PRESENTAN SIN GARANTÍA DE NINGÚN TIPO, EXPLÍCITA O IMPLÍCITA. USUARIOS DEBEN SER RESPONSABLES POR SUS APLICACIONES DE CUALQUIER PRODUCTO

LA LICENCIA DE SOFTWARE Y LA GARANTÍA LIMITADA PARA EL PRODUCTO ACOMPAÑANTE SE ESTABLECEN EN EL PAQUETE DE INFORMACIÓN QUE SE ENVÍA CON EL PRODUCTO Y SE INCORPORAN AL PRESENTE DOCUMENTO MEDIANTE ESTA REFERENCIA. SI NO PUEDE ENCONTRAR LA LICENCIA DE SOFTWARE O LA GARANTÍA LIMITADA, PÓNGASE EN CONTACTO CON SU REPRESENTANTE DE CISCO PARA OBTENER UNA COPIA.

La implementación de Cisco de la compresión de encabezados TCP es una adaptación de un programa desarrollado por la Universidad de California, Berkeley (UCB) como parte de la versión de dominio público del sistema operativo UNIX de UCB. Todos los derechos reservados. Copyright © 1981, Regentes de la Universidad de California.

SIN PERJUICIO DE CUALQUIER OTRA GARANTÍA CONTENIDA EN EL PRESENTE DOCUMENTO, TODOS LOS ARCHIVOS DE DOCUMENTO Y EL SOFTWARE DE ESTOS PROVEEDORES SE PROPORCIONAN "TAL CUAL" CON TODOS LOS FALLOS. CISCO Y LOS PROVEEDORES MENCIONADOS ANTERIORMENTE RECHAZAN TODAS LAS GARANTÍAS, EXPRESAS O IMPLÍCITAS, INCLUIDAS, ENTRE OTRAS, LAS DE COMERCIABILIDAD, ADECUACIÓN A UN FIN DETERMINADO E INCUMPLIMIENTO O QUE SURJAN DE UN PROCESO DE NEGOCIACIÓN, USO O PRÁCTICA COMERCIAL.

BAJO NINGUNA CIRCUNSTANCIA CISCO O SUS PROVEEDORES SERÁN RESPONSABLES POR CUALQUIER TIPO DE DAÑO DIRECTO, INDIRECTO, ESPECIAL, INCIDENTAL O CONSECUENTE, INCLUYENDO SIN LIMITACIÓN, PÉRDIDA DE GANANCIAS O DAÑOS Y PÉRDIDAS DE DATOS COMO CONSECUENCIA DEL MAL USO O DE LA INCAPACIDAD DE USO DE ESTE MANUAL, A PESAR DE QUE CISCO Y SUS PROVEEDORES HAYAN SIDO ADVERTIDOS DE LA POSIBILIDAD DE DICHOS DAÑOS.

Las direcciones IP (Internet Protocol) y los números de teléfono utilizados en este documento no son direcciones y números de teléfono reales. Cualesquiera ejemplos, muestra de la salida de comandos, diagramas de topología de red y otras figuras incluidos en el documento se muestran solamente con fines ilustrativos. El uso de direcciones IP o números de teléfono reales en contenido ilustrativo es involuntario y fortuito.

Todas las copias impresas y las copias de software duplicadas se consideran copias no controladas y la versión original en línea debe consultarse para la última versión.

Cisco cuenta con más de 200 oficinas en todo el mundo. Las direcciones, números de teléfono y números de fax se encuentran en el sitio web de Cisco en www.cisco.com/go/offices.

Cisco y el logotipo de Cisco son marcas registradas o marcas comerciales de Cisco y/o de sus filiales en los Estados Unidos y otros países. Para ver una lista de las marcas comerciales de Cisco, visite esta URL: www.cisco.com/go/trademarks. Las marcas comerciales de terceros mencionadas pertenecen a sus respectivos propietarios. El uso de la palabra Partner no implica en una relación de sociedad entre Cisco y ninguna otra compañía. (1110R)

© 2016 Cisco Systems, Inc. Todos los derechos reservados.