UCS-integratie met Office 365 voor Agent-e-mail

Inleiding

Dit document beschrijft hoe Unified Contact Center Express (UCCX) oplossing, vanaf versie 11.5 samen met SocialMiner (SM) ondersteunt Office 365 als een e-mailserver voor agent e-mail functionaliteit. Dit is de eerste cloud e-mailprovider die wordt ondersteund voor de functionaliteit van de agent e-mail.

Ontwerp en topologie

De UCCX-server biedt nu ondersteuning voor cloud e-mail vanaf 11.5. Deze functionaliteit wordt bereikt door integratie met de Office365 e-mailservice via een SOCKS 5-proxy. Het is belangrijk om op te merken dat het hebben van een proxyserver niet verplicht is, maar de meeste implementaties hebben externe netwerktoegang geblokkeerd en daarom moet verbinding via een proxyserver tot stand worden gebracht.

Afgezien van de ene extra stap van het opzetten van de proxy, is er geen andere verandering voor de klant. De stroom van berichten wordt in de afbeelding weergegeven:

Configuratie

1. Een proxyserver hebben om verbinding te maken met Office 365 is niet verplicht. Als de netwerkverbinding zo is ingesteld dat de SM-server een TCP-verbinding kan instellen op de Internet Message Access Protocol (IMAP)- en Simple Mail Transfer Protocol (SMTP)-poorten van office365.com, is een proxyserver niet nodig.
   
   
2. Als u een proxy wilt gebruiken tussen de SM en Office 365, is SOCKS 5 het enige ondersteunde protocol. SOCKS4, SSH-tunnels en andere protocollen worden niet ondersteund.
   
   
3. Cisco raadt niet aan welke proxyserver moet worden gebruikt.

De proxy instellen

Als onderdeel van deze technologie wordt een opensource-proxyserver voor Linux, Dante genaamd, gebruikt. Houd er rekening mee dat dit niet de door Cisco aanbevolen proxyserver is; het is een van de servers die in het lab worden gebruikt voor het maken van dit document. U bent vrij om elke server van keuze te gebruiken zolang het SOCKS5 protocol wordt gebruikt.

Opmerking: de server die als proxy wordt geconfigureerd, moet toegang hebben tot office365.com, zonder dat er verdere proxy’s nodig zijn.

Op een Linux server met root toegang:

Stap 1. Installeer de Dante server.

Stap 2. Configureer de server door de volgende informatie aan het /etc/danted.conf bestand toe te voegen.

Stap 3. Start de server, klaar voor gebruik.

Meer informatie over de Dante-server en het downloaden van de installatiepakketten vindt u hier: https://www.inet.no/dante/index.html

Office 365-account

Aanmelden portal:https://login.microsoftonline.com

Als u een betaald Office365-account wilt kopen, gaat u naar https://products.office.com/en/exchange/compare-microsoft-exchange-online-plansmet uw creditcard. (De standaardprijsoptie kost $4 vóór belasting per e-mailaccount per maand.)

Opmerking: wanneer u zich aanmeldt voor de Office365-service, zorg er dan voor dat de service die u krijgt uit het land komt waar de SocialMiner-server zich bevindt. Dit is erg belangrijk, anders heb je problemen met connectiviteit. 

De UCCX/SM configureren

Deze sectie verschaft de overkoepelende taken en bijbehorende informatie voor het configureren van Unified CCX-integratie met Office 365 voor Agent Email.

Problemen oplossen

Relevante logs

Deze logboeken zijn belangrijk om de O365 gerelateerde problemen te debuggen.

• Runtime-logbestanden: https://<SocialMiner-server voor IP/host>/ccp-webapp/logs/runtime/
  Bestandspatroon: CCBU-runtime.*.startup.log, Error-runtime.*.startup.log
  
  
• API-logbestanden: https://<SocialMiner-server voor IP/host>/ccp-webapp/logs/ccapi/
  Bestandspatroon: CCBU-ccpapi.*.startup.log, Error-ccpapi.*.startup.log

Checklist

Controleer deze om er zeker van te zijn dat de Office365-functionaliteit werkt zoals verwacht in een SocialMiner-systeem:

• Controleer of SocialMiner Office365 rechtstreeks kan bereiken.
  
  
• Als SocialMiner niet in staat is om Office365 te bereiken, configureren Socks Proxy in SocialMiner en inschakelen.
  
  
• Alleen SOCKS 5-protocol wordt ondersteund.
  
  
• Zorg ervoor dat de Socks Proxy server Office365 kan bereiken.
  
  
• Controleer Office 365-referenties in CCX.
  
  
• Controleer Office365 e-mail feed status in SocailMiner

  • Als de feed normaal wordt ontvangen, is deze groen en niet rood met kruismarkering (X), zoals in het beeld wordt weergegeven.

  • Als het voer kapot is, kunt u over de rode kruis markering (X) zweven om de reden te kennen.

Opmerking: bij herconfiguratie van Socks Proxy zouden alle bestaande e-mailfeeds automatisch worden bijgewerkt om de nieuwste Socks Proxy Configuration te gebruiken.

Gemeenschappelijke scenario’s

Probleem: Agenten kunnen geen e-mails ontvangen.

Mogelijke Oorzaak 1: Socks Proxy is niet geconfigureerd/ingeschakeld

In de runtime logs wordt de volgende fout weergegeven:

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

Aanbevolen actie:

• Configureer de Socks Proxy Server en schakel deze in.
  
  
• Zorg ervoor dat Socks Proxy bereikbaar is vanuit SocialMiner en Socks Proxy Server is in staat om de O365 te bereiken.

Mogelijk: Als het gebruiken van geverifieerde Socks Proxy, zijn de opgegeven referenties onjuist

In de runtime logs wordt de volgende fout weergegeven:

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

Aanbevolen actie:

• Los het verificatieprobleem op door de juiste referenties in te voeren.
  
  

• Zorg ervoor dat de Socks Proxy bereikbaar is vanuit SocialMiner en Socks Proxy Server kan de O365 bereiken.

Probleem: Vertraging bij het verzenden van e-mails met Office365.

Aanbevolen actie: 

• Als het versturen van een e-mail meer dan 10 seconden in beslag neemt, moet u uitzoeken of de SMTP-verbinding met Office365 de vertraging veroorzaakt.
  
  
• Office365 configureren met Thunderbird of outlook client via IMAP. Als het verzenden van een e-mail lang duurt met een geverifieerde SMTP-verbinding, dan geeft het hetzelfde traagheidsprobleem aan in SocialMiner.
  
  
• De kwestie is van Office365. Contact Office365 ondersteuning.

Microsoft Diagnostics-tool

Als u problemen hebt met de verbinding met de Office365-service en de status van uw service wilt controleren, is er een tool van Microsoft dat kan worden gebruikt. De tool heet Support and Recovery Assistant en kan hier worden gedownload: https://diagnostics.outlook.com/#/

Voor meer informatie zie: https://blogs.office.com/2016/05/11/new-tool-for-helping-resolve-office-365-issues/

Documentatie verkrijgen en een serviceaanvraag indienen

Zie Wat is er nieuw in Cisco-productdocumentatie op http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html voor informatie over het verkrijgen van documentatie, het gebruik van de Cisco Bug Search Tool (BST), het indienen van een serviceverzoek en het verzamelen van aanvullende informatie.

Abonneren op wat er nieuw is in Cisco-productdocumentatie, waarin alle nieuwe en herziene technische documentatie van Cisco wordt vermeld, als een RSS-feed en inhoud rechtstreeks op uw desktop leveren met een leestoepassing. De RSS-feeds zijn een gratis service.

DE SPECIFICATIES EN INFORMATIE BETREFFENDE DE PRODUCTEN IN DEZE HANDLEIDING KUNNEN ZONDER KENNISGEVING WORDEN GEWIJZIGD. ALLE VERKLARINGEN, INFORMATIE EN AANBEVELINGEN IN DEZE HANDLEIDING WORDEN GEACHT NAUWKEURIG TE ZIJN, MAAR WORDEN ZONDER ENIGE GARANTIE WEERGEGEVEN, EXPLICIET OF IMPLICIET. GEBRUIKERS MOETEN DE VOLLEDIGE VERANTWOORDELIJKHEID NEMEN VOOR HUN TOEPASSING VAN ALLE PRODUCTEN.

DE SOFTWARELICENTIE EN BEPERKTE GARANTIE VOOR HET BEGELEIDENDE PRODUCT WORDEN BESCHREVEN IN HET INFORMATIEPAKKET DAT BIJ HET PRODUCT IS MEEGELEVERD EN WORDEN BIJ DEZE VERWIJZING OPGENOMEN. ALS U DE SOFTWARELICENTIE OF BEPERKTE GARANTIE NIET KUNT VINDEN, NEEMT U CONTACT OP MET UW CISCO-VERTEGENWOORDIGER VOOR EEN EXEMPLAAR.

De implementatie van Cisco van TCP-headercompressie is een aanpassing van een programma dat door de Universiteit van Californië, Berkeley (UCB) is ontwikkeld als deel van de public domain versie van UCB van het UNIX-besturingssysteem. Alle rechten voorbehouden. Copyright © 1981, Regenten van de Universiteit van Californië.

NIETTEGENSTAANDE ENIGE ANDERE GARANTIE HIERIN, WORDEN ALLE DOCUMENTBESTANDEN EN SOFTWARE VAN DEZE LEVERANCIERS MEEGELEVERD MET ALLE FOUTEN IN DE HUIDIGE STAAT. CISCO EN DE HIERBOVEN GENOEMDE LEVERANCIERS WIJZEN ALLE GARANTIES AF, UITGEDRUKT OF IMPLICIET, INCLUSIEF, ZONDER BEPERKING, DIE VAN DE VERKOOPBAARHEID, GESCHIKTHEID VOOR EEN BEPAALD DOEL EN NIET-INBREUK OF HET GEVOLG VAN EEN HANDELSPRAKTIJK, GEBRUIK OF HANDELSPRAKTIJK.

IN GEEN GEVAL ZULLEN CISCO OF ZIJN LEVERANCIERS AANSPRAKELIJK ZIJN VOOR ENIGE INDIRECTE, SPECIALE, GEVOLGSCHADE OF INCIDENTELE SCHADE, INCLUSIEF, ZONDER BEPERKING, VERLOREN WINST OF VERLIES OF SCHADE AAN GEGEVENS DIE VOORTVLOEIT UIT HET GEBRUIK OF DE ONMOGELIJKHEID OM DEZE HANDLEIDING TE GEBRUIKEN, ZELFS ALS CISCO OF ZIJN LEVERANCIERS OP DE HOOGTE ZIJN GESTELD VAN DE MOGELIJKHEID VAN DERGELIJKE SCHADE.

De in dit document gebruikte IP-adressen en telefoonnummers van het Internet Protocol zijn niet bedoeld als werkelijke adressen of telefoonnummers. Om het even welke voorbeelden, de output van de bevelvertoning, de diagrammen van de netwerktopologie, en andere cijfers inbegrepen in het document worden getoond voor illustratieve slechts doeleinden. Elk gebruik van actuele IP-adressen of telefoonnummers in illustratieve inhoud is onbedoeld en toevallig.

Alle gedrukte en gedupliceerde zachte kopieën worden beschouwd als ongecontroleerde kopieën en de originele online versie moet worden vermeld voor de laatste versie.

Cisco heeft wereldwijd meer dan 200 vestigingen. Adressen, telefoonnummers en faxnummers worden vermeld op de Cisco-website op www.cisco.com/go/offices.

Cisco en het Cisco-logo zijn handelsmerken of geregistreerde handelsmerken van Cisco en/of zijn filialen in de Verenigde Staten en andere landen. U kunt een lijst met Cisco-handelsmerken bekijken op deze URL: www.cisco.com/go/trademarks. De genoemde handelsmerken van derden zijn het eigendom van hun respectievelijke eigenaren. Het gebruik van het woord partner impliceert geen partnerschapsrelatie tussen Cisco en een ander bedrijf. (1110R)

© 2016 Cisco Systems, Inc. Alle rechten voorbehouden.