- Start
- /
- Artikel
Hartelijk dank voor uw feedback
In dit artikel
Feedback?Creëer en verifieer een digitaal e-mailelement in Control Hub en wijs het vervolgens toe aan een Webex-service zoals Webex Connect of Webex Contact Center.
Overzicht
Gebruik Digital Assets in Control Hub om de mailbox en OAuth 2.0-verificatie te configureren die Webex-services gebruiken voor e-mailinteracties. U beheert het bedrijfsmiddel in Control Hub en goedgekeurde Webex-workloads hebben er toegang toe via de shared digital asset-service.
Wanneer u het item maakt, wijst u het toe aan de Webex-service die het zal gebruiken. Nadat de authenticatie is geslaagd, genereert Control Hub een doorstuuradres voor binnenkomende e-mail. Voor Webex Contact Center kunt u het item vervolgens koppelen aan een invoerpunt voor e-mail. Voor een andere Webex-workload moet u doorgaan met de installatie van die workload nadat u de asset hebt aangemaakt.
Voordat u begint
- Meld u aan bij Control Hub als volledige beheerder, klantbeheerder of partnerbeheerder die digitale activa voor uw organisatie kan beheren.
- Gebruik een ondersteunde e-mailprovider. Voor de Webex Contact Center-integratie met Webex Connect Gmail en Microsoft 365 zijn de ondersteunde providers. Voor specifieke informatie over de provider, zie E-mail - WXCC.
- Bereid de mailbox voor die u wilt configureren. Als u een serviceaccount gebruikt, zorg er dan voor dat dat e-mailadres kan verzenden en toegang heeft tot dat postvak.
- Werk samen met de beheerder van uw identiteitsprovider om een OAuth-aanvraag te registreren, toestemming te verlenen en providerinstellingen zoals SMTP AUTH of extern doorsturen in te schakelen.
- Wees klaar om de terugbel-URL van de Control Hub naar de omleidings-URL van de OAuth-toepassing te kopiëren en om automatische doorschakeling naar het adres te configureren dat voor het e-mailitem is gegenereerd.
Gmail klaarmaken voor OAuth 2.0
Om een Gmail-account voor te bereiden voor het e-mailitem:
| 1 |
Meld u aan bij de Google Cloud-console en maak een project aan of selecteer een bestaand project. |
| 2 |
Ga naar API's en services > OAuth-toestemmingsscherm, selecteer Extern en voer de naam van de app, het e-mailadres voor de gebruikersondersteuning en de contactgegevens van de ontwikkelaar in. |
| 3 |
Als de app in de testmodus blijft, voeg dan de mailbox of de identiteit voor het genereren van tokens toe als testgebruiker. Een project kan maximaal 100 testgebruikers hebben. |
| 4 |
Ga naar API's en services > Credentials, maak een OAuth-client-ID voor een webtoepassing en kopieer de client-ID en het klantgeheim. |
| 5 |
Wanneer Control Hub de URL voor terugbellen toont, ga dan terug naar de OAuth-client en voeg die waarde toe als een geautoriseerde doorleidings-URI. |
| 6 |
Publiceer voor productiegebruik de OAuth-app en voer eventuele Google-verificatie uit die nodig is voor het gevraagde bereik. |
| 7 |
Noteer de volgende providerwaarden voor de Control Hub-configuratie:
Voor een externe Google OAuth-app in Testing vervallen autorisaties van testgebruikers en vernieuwingstokens zeven dagen na toestemming. Publiceer de app voor productiegebruik. Als Google geen vernieuwingstoken retourneert, voer dan opnieuw de toestemmingsprocedure uit en selecteer Ik wil dit expliciet controleren voordat u toestemming geeft voor authenticatie, wanneer die optie beschikbaar is. In de SMTP OAuth-documentatie van Google wordt het bereik van Gmail SMTP OAuth uitgelegd. De OAuth-doelgroepbegeleiding van Google geeft uitleg over interne en externe doelgroepen en het gedrag in de publicatiestatus. |
Microsoft 365 klaarmaken voor OAuth 2.0
Om een Microsoft 365-mailbox klaar te maken voor het e-mailitem:
| 1 |
Ga in het Microsoft Entra-beheercentrum naar App-registraties, selecteer Nieuwe registratie en registreer de applicatie voor de accounttypen die uw organisatie toestaat. |
| 2 |
Noteer de applicatie-ID (client) en de Directory-ID (tenant). |
| 3 |
Voeg bij Authenticatie een webplatform toe. Wanneer Control Hub de URL voor terugbellen toont, voegt u die waarde toe als omleidings-URI. |
| 4 |
Maak in Certificaten en geheimen een klantgeheim en kopieer de waarde ervan voordat u de pagina verlaat. |
| 5 |
Voor de interactieve autorisatiecodestroom die wordt gebruikt wanneer u Tokens genereren selecteert, voegt u de gedelegeerde machtiging voor Office 365 Exchange Online SMTP.send toe (https://outlook.office.com/SMTP.Send) en vraagt u de offline_access-scope aan. Verleen toestemming van de beheerder als het toestemmingsbeleid van uw organisatie dat vereist. |
| 6 |
Ga in het Microsoft 365-beheercentrum naar Gebruikers > Actieve gebruikers, selecteer de mailboxgebruiker, selecteer Mail > E-mailapps beheren, schakel geverifieerde SMTP in voor dat postvak en sla uw wijzigingen op. |
| 7 |
Noteer de volgende waarden van de provider. Vervang {tenant-id} door de Directory-id (tenant) uit de registratie van de app:
Gebruik de gedelegeerde scope https://outlook.office.com/SMTP.Send met offline_access voor deze interactieve tokenstroom. Schakel SMTP AUTH alleen in voor de mailbox die dat nodig heeft. Als uw organisatie onlangs de toestemmingsinstellingen van Microsoft Entra heeft gewijzigd, wacht dan tot de wijzigingen van kracht zijn voordat u tokens genereert. De richtlijnen voor SMTP OAuth van Microsoft hebben betrekking op gedelegeerde SMTP.send en offline_access. In de SMTP AUTH-configuratie van Microsoft wordt uitgelegd hoe u SMTP AUTH kunt inschakelen voor een specifieke mailbox. |
Configureer het e-mailitem in Control Hub
Om een e-mailitem te configureren:
| 1 |
Meld u aan bij Control Hub. |
| 2 |
Ga naar Services > Digital Assets. |
| 3 |
Selecteer Create asset. |
| 4 |
Voer in de sectie Assetgegevens configureren waarden in de volgende velden in:
|
| 5 |
Voer in E-mailprovider > Mailbox het e-mailadres in van de mailbox die het item gebruikt. |
| 6 |
Voer in de sectie OAuth 2.0-authenticatie waarden in de volgende velden in:
|
| 7 |
Voeg in uw identiteitsprovider de callback-URL van Control Hub toe aan de OAuth-toepassing, sla de configuratie van de provider op en controleer of de doorleidings-URI exact overeenkomt. |
| 8 |
Als de persoon die toestemming geeft een ander e-mailadres gebruikt dan het postvak, selecteer dan Tokens genereren met een ander e-mailadres dan het postbusadres en voer die identiteit in. Gedeelde postbus: Een gedeeld postvak heeft geen eigen inloggegevens. Genereer tokens met een gebruiker die toegang heeft tot de gedeelde mailbox en de machtiging Verzenden als heeft; de gebruiker heeft geen beheerderstoegang nodig. Selecteer Tokens genereren met een ander e-mailadres dan het postbusadres als het adres van die gebruiker verschilt van het postvak. |
| 9 |
Selecteer Tokens genereren, voltooi de aanmeldings- en toestemmingsprocedure van de identiteitsprovider en keer terug naar Control Hub. Nadat het genereren van tokens is gelukt, worden de velden Access-token, Refresh-token en Validity automatisch ingevuld. Toestemmingsbeperking: Als uw provider de toestemming van de gebruiker blokkeert, is dit duidelijk dat ik dit expliciet wil bekijken voordat u toestemming geeft voor authenticatie. De optie kan ertoe leiden dat de authenticatie mislukt omdat de gebruiker de gevraagde toestemming niet kan verlenen. Vraag de beheerder van de provider om in plaats daarvan de vereiste toestemming te verlenen. Als het genereren van tokens niet werkt: zorg er bij Gmail voor dat de gebruiker de app kan autoriseren en dat de app de juiste publicatiestatus heeft. Controleer voor Microsoft 365 het bereik van offline_access, het toestemmingsbeleid, de omleidings-URI en de SMTP-AUTH-instelling. Corrigeer de configuratie van de provider en genereer de tokens opnieuw. Verlenging van tokens: De service vernieuwt tokens voordat ze verlopen. Als de eigenaar van een huurder een automatische e-mail ontvangt waarin wordt gevraagd om een token te regenereren, open dan het item en selecteer opnieuw Tokens genereren. |
| 10 |
Nadat het genereren van tokens is gelukt, selecteert u Create. Als het item is toegewezen aan Webex Contact Center, selecteert u Ga naar toegangspunten en gaat u verder met de configuratie van het Contact Center. Voor een andere Webex-workload sluit u de bevestigingspagina en gaat u verder met de configuratie van die workload. |
Doorsturen van inkomende e-mail configureren
Kopieer eerst het verzendadres dat voor het item is gegenereerd:
| 1 |
Open in Digital Assets het e-mailitem en selecteer Instellingen. |
| 2 |
Kopieer in E-mailprovider > Mailbox het doorstuuradres dat is gekoppeld aan het e-mailadres van de mailbox. |
Doorsturen configureren in Gmail
Om binnenkomende Gmail-berichten door te sturen naar het e-mailitem:
| 1 |
Als u Google Workspace gebruikt, zorg er dan voor dat uw beheerder automatisch doorsturen toestaat voor de organisatie-eenheid van de mailbox onder Apps > Google Workspace > Gmail > Toegang voor eindgebruikers. |
| 2 |
Meld u aan bij de ondersteuningsmailbox in Gmail en ga naar Instellingen > Alle instellingen bekijken > Doorsturen en POP/IMAP. |
| 3 |
Selecteer Voeg een doorstuuradres toe, plak het doorstuuradres in de Control Hub en voltooi vervolgens de bevestigingsinstructies. Gmail stuurt een verificatielink of -code naar het gegenereerde adres. |
| 4 |
De verificatielink of -code ophalen uit de Outbound Webhook-payload voor binnenkomende e-mail in Webex Connect of uit de volledige hoofdtekst van het e-mailadres in de gedecodeerde debuglogboeken van het e-mailitem. Voltooi vervolgens de Gmail-verificatie. |
| 5 |
Ga terug naar de instellingen voor doorsturen van Gmail, vernieuw de pagina, selecteer Een kopie van inkomende e-mail doorsturen naar, kies wat Gmail met de kopie moet doen en selecteer Wijzigingen opslaan. |
Doorsturen configureren in Microsoft 365
Om binnenkomende Microsoft 365-berichten door te sturen naar het e-mailitem:
| 1 |
Configureer het doorsturen van postvakken of een Inbox-regel voor het ondersteuningspostvak zodat nieuwe berichten vanuit de Control Hub naar het doorstuuradres worden gestuurd. |
| 2 |
Bekijk in het Microsoft Defender-portaal het beleid voor uitgaande spam dat van toepassing is op de mailbox. Stel de regels voor automatisch doorsturen in op Aan - Doorsturen is ingeschakeld in het kader van een beleid dat beperkt is en dat uw beveiligingsbeheerder heeft goedgekeurd. |
| 3 |
Controleer in Exchange Online of de toepasselijke instelling voor extern domein automatisch doorsturen naar het domein met het doorstuuradres toestaat. |
| 4 |
Controleer de Exchange-poststroomregels en zorg ervoor dat geen enkele regel automatisch doorgestuurde berichten blokkeert. Als u een uitzondering nodig hebt, beperk die dan tot de mailbox voor ondersteuning en de goedgekeurde bestemming. |
| 5 |
Sla de verzendconfiguratie op en geef de beleidswijzigingen van Microsoft 365 tijd om van kracht te worden. Vereist: Inkomende e-mail bereikt de toegewezen Webex-workload pas als doorsturen is ingeschakeld. In Microsoft 365 heeft een blokkeringsbeleid voor uitgaande spam, een instelling voor een extern domein of een regel voor de e-mailstroom voorrang op een instelling die doorsturen mogelijk maakt. Limiet voor bijlagen: Inkomende e-mailbijlagen zijn beperkt tot 25 MB. Als een bericht mislukt omdat de bijlagen te groot zijn, ontvangt de afzender een bericht dat de bezorging mislukt is en moet hij het bericht opnieuw verzenden met kleinere bijlagen. Inline-afbeeldingen: Inline-afbeeldingen worden als bijlagen op de desktop van de agent geplaatst. Als PCI-scannen is ingeschakeld, worden die beelden geblokkeerd. Microsoft Outlookbijlagen: vanwege een beperking kan een binnenkomende e-mail met een .msg-bijlage binnenkomen zonder dat de bestanden in dat .msg zijn ingevoegd. Microsoft Outlook |
Test het e-mailitem
Om het volledige e-mailpad te verifiëren:
| 1 |
Stuur vanaf een extern e-mailaccount een bericht naar de geconfigureerde ondersteuningsmailbox en zorg ervoor dat het bericht de toegewezen Webex-workload bereikt. |
| 2 |
Stuur vanuit de toegewezen Webex-workload een nieuw bericht of beantwoord het binnenkomende bericht en zorg ervoor dat de externe ontvanger het ontvangt. Bezorgingsstatus: e-mail die via het SMTP-kanaal wordt verzonden, bevat geen tracering van de bezorging, en de service ontvangt geen meldingen van mislukte bezorging. Bevestig de bezorging uit de brievenbus van de ontvanger tijdens het testen. |
| 3 |
Als binnenkomende bezorging niet werkt, controleer dan de bevestiging van het verzendadres, de verzendregel en het verzendbeleid van de organisatie. |
| 4 |
Als uitgaande verzending niet werkt, controleer dan de SMTP-server en -poort, de machtigingen van de provider, de inloggegevens van de client, de toestemming, de Microsoft 365 SMTP AUTH-instelling en de tokenstatus. Los het probleem op en genereer indien nodig opnieuw tokens. |
