- Startseite
- /
- Artikel
Erstellen und authentifizieren Sie ein digitales E-Mail-Asset in Control Hub und weisen Sie es dann einem Webex-Dienst wie Webex Connect oder Webex Contact Center zu.
Übersicht
Verwenden Sie Digital Assets in Control Hub, um das Postfach und die OAuth 2.0-Authentifizierung zu konfigurieren, die Webex-Dienste für E-Mail-Interaktionen verwenden. Sie verwalten das Asset in Control Hub und genehmigte Webex-Workloads greifen über den Shared Digital Asset Service darauf zu.
Wenn Sie das Asset erstellen, weisen Sie es dem Webex-Dienst zu, der es verwenden wird. Nach erfolgreicher Authentifizierung generiert Control Hub eine Weiterleitungsadresse für eingehende E-Mails. Für Webex Contact Center können Sie das Asset dann mit einem E-Mail-Einstiegspunkt verknüpfen. Für einen anderen Webex-Workload fahren Sie mit der Einrichtung in diesem Workload fort, nachdem Sie das Asset erstellt haben.
Vorbereitungen
- Melden Sie sich bei Control Hub als Volladministrator, Kundenadministrator oder Partneradministrator an, der digitale Ressourcen für Ihr Unternehmen verwalten kann.
- Verwenden Sie einen unterstützten E-Mail-Anbieter. Für die Webex Contact Center-Integration mit Webex Connect Gmail und Microsoft 365 sind die unterstützten Anbieter. Für anbieterspezifische Informationen siehe E-Mail — WXCC.
- Bereiten Sie das Postfach vor, das Sie konfigurieren möchten. Wenn Sie ein Dienstkonto verwenden, stellen Sie sicher, dass es E-Mails senden und auf dieses Postfach zugreifen kann.
- Arbeiten Sie mit Ihrem Identity-Provider-Administrator zusammen, um eine OAuth-Anwendung zu registrieren, Ihre Zustimmung zu erteilen und Anbietereinstellungen wie SMTP AUTH oder externe Weiterleitung zu aktivieren.
- Seien Sie bereit, die Rückruf-URL von Control Hub in die Weiterleitungs-URL der OAuth-Anwendung zu kopieren und die automatische Weiterleitung an die für das E-Mail-Asset generierte Adresse zu konfigurieren.
Gmail für OAuth 2.0 vorbereiten
Um ein Gmail-Konto für das E-Mail-Asset vorzubereiten:
| 1 |
Melden Sie sich bei der Google Cloud-Konsole an und erstellen Sie ein Projekt oder wählen Sie ein vorhandenes Projekt aus. |
| 2 |
Gehen Sie zu APIs & Services > OAuth-Zustimmungsbildschirm, wählen Sie Extern aus und geben Sie den Namen der App, die E-Mail-Adresse des Benutzersupports und die Kontaktinformationen des Entwicklers ein. |
| 3 |
Wenn die App im Testmodus bleibt, fügen Sie das Postfach oder die Identität zur Token-Generierung als Testbenutzer hinzu. Ein Projekt kann bis zu 100 Testbenutzer haben. |
| 4 |
Gehen Sie zu APIs & Services > Credentials, erstellen Sie eine OAuth-Client-ID für eine Webanwendung und kopieren Sie die Client-ID und das Client-Geheimnis. |
| 5 |
Wenn Control Hub die Rückruf-URL anzeigt, kehren Sie zum OAuth-Client zurück und fügen Sie diesen Wert als autorisierte Weiterleitungs-URI hinzu. |
| 6 |
Für den Einsatz in der Produktion veröffentlichen Sie die OAuth-App und führen Sie alle für den angeforderten Umfang erforderlichen Google-Bestätigungen durch. |
| 7 |
Notieren Sie die folgenden Anbieterwerte für die Control Hub-Konfiguration:
Für eine externe Google OAuth-App in Testing laufen Testbenutzerautorisierungen und Aktualisierungstoken sieben Tage nach der Zustimmung ab. Veröffentlichen Sie die App für den Produktionsgebrauch. Wenn Google kein Aktualisierungstoken zurückgibt, führen Sie den Zustimmungsablauf erneut aus und wählen Sie Ich möchte es ausdrücklich überprüfen, bevor ich die Zustimmung zur Authentifizierung erteile, wenn diese Option verfügbar ist. In der SMTP-OAuth-Dokumentation von Google wird der SMTP-OAuth-Bereich von Gmail erklärt. Googles OAuth-Zielgruppenleitfaden erklärt interne und externe Zielgruppen sowie das Verhalten beim Veröffentlichungsstatus. |
Bereiten Sie Microsoft 365 für OAuth 2.0 vor
Um ein Microsoft 365-Postfach für das E-Mail-Asset vorzubereiten:
| 1 |
Gehen Sie im Microsoft Entra Admin Center zu App-Registrierungen, wählen Sie Neue Registrierung aus und registrieren Sie die Anwendung für die Kontotypen, die Ihre Organisation zulässt. |
| 2 |
Notieren Sie die Anwendungs- (Client-) ID und die Verzeichnis-ID (Mandant). |
| 3 |
Fügen Sie unter Authentifizierung eine Webplattform hinzu. Wenn Control Hub die Rückruf-URL anzeigt, fügen Sie diesen Wert als Umleitungs-URI hinzu. |
| 4 |
Erstellen Sie in Certificates & Secrets ein Client-Geheimnis und kopieren Sie seinen Wert, bevor Sie die Seite verlassen. |
| 5 |
Für den interaktiven Autorisierungscode-Flow, der verwendet wird, wenn Sie Tokens generieren auswählen, fügen Sie die delegierte Office 365 Exchange Online SMTP.Send Permission (https://outlook.office.com/SMTP.Send) hinzu und fordern Sie den Bereich offline_access an. Erteilen Sie die Zustimmung des Administrators, wenn die Zustimmungsrichtlinie Ihrer Organisation dies erfordert. |
| 6 |
Gehen Sie im Microsoft 365 Admin Center zu Benutzer > Aktive Benutzer, wählen Sie den Postfachbenutzer aus, wählen Sie Mail > E-Mail-Apps verwalten, aktivieren Sie authentifiziertes SMTP für dieses Postfach und speichern Sie Ihre Änderungen. |
| 7 |
Notieren Sie die folgenden Anbieterwerte. Ersetzen Sie {tenant-id} durch die Verzeichnis-ID (Mandant) aus der App-Registrierung:
Verwenden Sie den delegierten Bereich https://outlook.office.com/SMTP.Send mit offline_access für diesen interaktiven Token-Flow. Aktivieren Sie SMTP AUTH nur für das Postfach , das es benötigt. Wenn Ihre Organisation kürzlich die Microsoft Entra-Zustimmungseinstellungen geändert hat, warten Sie, bis die Änderungen wirksam werden, bevor Sie Token generieren. Die SMTP-OAuth-Anleitung von Microsoft deckt delegiertes SMTP.Send und offline_access ab. Die SMTP AUTH-Konfiguration von Microsoft erklärt, wie SMTP AUTH für ein bestimmtes Postfach aktiviert wird. |
Konfigurieren Sie das E-Mail-Asset in Control Hub
Um ein E-Mail-Asset zu konfigurieren:
| 1 | |
| 2 |
Gehen Sie zu Dienste > Digitale Vermögenswerte. |
| 3 |
Wählen Sie Asset erstellen aus. |
| 4 |
Geben Sie im Abschnitt „Asset-Details konfigurieren“ Werte in die folgenden Felder ein:
|
| 5 |
Geben Sie unter E-Mail-Anbieter > Postfach die E-Mail-Adresse des Postfachs ein, das das Asset verwendet. |
| 6 |
Geben Sie im Abschnitt OAuth 2.0-Authentifizierung Werte in die folgenden Felder ein:
|
| 7 |
Fügen Sie in Ihrem Identitätsanbieter die Rückruf-URL von Control Hub zur OAuth-Anwendung hinzu, speichern Sie die Provider-Konfiguration und stellen Sie sicher, dass die Umleitungs-URI exakt übereinstimmt. |
| 8 |
Wenn die Person, die die Einwilligung erteilt, eine andere E-Mail-Adresse als das Postfach verwendet, wählen Sie Token mit einer anderen E-Mail-Adresse als der Postfachadresse generieren aus und geben Sie diese Identität ein. Geteiltes Postfach: Ein geteiltes Postfach hat keine eigenen Anmeldeinformationen. Generieren Sie Tokens mit einem Benutzer, der auf das gemeinsame Postfach zugreifen kann und über die Berechtigung Senden als verfügt; der Benutzer benötigt keinen Administratorzugriff. Wählen Sie Token mit einer anderen E-Mail-Adresse als der Postfachadresse generieren aus, wenn sich die Adresse dieses Benutzers von der des Postfachs unterscheidet. |
| 9 |
Wählen Sie Tokens generieren aus, schließen Sie den Anmelde- und Zustimmungsvorgang für den Identitätsanbieter ab und kehren Sie zu Control Hub zurück. Nach erfolgreicher Token-Generierung werden die Felder Zugriffstoken, Aktualisierungstoken und Gültigkeit automatisch ausgefüllt. Einwilligungsbeschränkung: Wenn Ihr Anbieter die Zustimmung des Benutzers blockiert, löschen Sie, dass ich das ausdrücklich überprüfen möchte, bevor ich die Zustimmung zur Authentifizierung erteile. Die Option kann dazu führen, dass die Authentifizierung fehlschlägt, weil der Benutzer die angeforderte Zustimmung nicht erteilen kann. Bitten Sie stattdessen den Administrator des Anbieters, die erforderliche Zustimmung zu erteilen. Falls die Token-Generierung nicht funktioniert: Stellen Sie für Gmail sicher, dass der Nutzer die App autorisieren kann und dass die App den richtigen Veröffentlichungsstatus hat. Für Microsoft 365 überprüfen Sie den Bereich offline_access, die Einwilligungsrichtlinie, die Umleitungs-URI und die SMTP-AUTH-Einstellung. Korrigieren Sie die Provider-Konfiguration und generieren Sie dann die Tokens erneut. Token-Verlängerung: Der Service aktualisiert Tokens, bevor sie ablaufen. Wenn ein Mandantenbesitzer eine automatische E-Mail mit der Aufforderung zur Token-Regenerierung erhält, öffnen Sie das Asset und wählen Sie erneut Tokens generieren aus. |
| 10 |
Nachdem die Token-Generierung erfolgreich war, wählen Sie Erstellen aus. Wenn das Asset Webex Contact Center zugewiesen ist, wählen Sie Gehe zu Entry Points und fahren Sie mit der Contact Center-Konfiguration fort. Für einen anderen Webex-Workload schließen Sie die Bestätigungsseite und fahren Sie mit der Einrichtung in diesem Workload fort. |
Weiterleitung eingehender E-Mails konfigurieren
Kopieren Sie zunächst die für das Asset generierte Weiterleitungsadresse:
| 1 |
Öffnen Sie in Digital Assets das E-Mail-Asset und wählen Sie Einstellungen aus. |
| 2 |
Kopieren Sie unter E-Mail-Anbieter > Postfach die Weiterleitungsadresse, die mit der E-Mail-Adresse des Postfachs verknüpft ist. |
Weiterleitung in Gmail konfigurieren
Um eingehende Gmail-Nachrichten an das E-Mail-Asset weiterzuleiten:
| 1 |
Wenn Sie Google Workspace verwenden, stellen Sie sicher, dass Ihr Administrator die automatische Weiterleitung für die Organisationseinheit des Postfachs unter Apps > Google Workspace > Gmail > Endbenutzerzugriff aktiviert. |
| 2 |
Melden Sie sich im Support-Postfach in Gmail an und gehen Sie zu Einstellungen > Alle Einstellungen anzeigen > Weiterleitung und POP/IMAP. |
| 3 |
Wählen Sie Weiterleitungsadresse hinzufügen, fügen Sie die Weiterleitungsadresse von Control Hub ein und vervollständigen Sie dann die Bestätigungsaufforderungen. Gmail sendet einen Bestätigungslink oder Code an die generierte Adresse. |
| 4 |
Rufen Sie den Bestätigungslink oder Code aus der Outbound-Webhook-Payload für eingehende E-Mails in Webex Connect oder aus dem vollständigen E-Mail-Text in den entschlüsselten Debug-Protokollen des E-Mail-Assets ab. Dann schließen Sie die Gmail-Bestätigung ab. |
| 5 |
Kehren Sie zu den Gmail-Weiterleitungseinstellungen zurück, aktualisieren Sie die Seite, wählen Sie Eine Kopie eingehender E-Mails weiterleiten an aus, wählen Sie aus, was Gmail mit der Kopie machen soll, und wählen Sie Änderungen speichern. |
Weiterleitung in Microsoft 365 konfigurieren
Um eingehende Microsoft 365-Nachrichten an das E-Mail-Asset weiterzuleiten:
| 1 |
Konfigurieren Sie die Postfachweiterleitung oder eine Posteingangsregel für das Support-Postfach, sodass neue Nachrichten von Control Hub an die Weiterleitungsadresse gesendet werden. |
| 2 |
Überprüfen Sie im Microsoft Defender-Portal die Richtlinie für ausgehenden Spam, die für das Postfach gilt. Stellen Sie automatische Weiterleitungsregeln auf Ein — die Weiterleitung ist in einer eng umrissenen Richtlinie aktiviert, die Ihr Sicherheitsadministrator genehmigt hat. |
| 3 |
Stellen Sie in Exchange Online sicher, dass die entsprechende Remote-Domain-Einstellung die automatische Weiterleitung an die Weiterleitungsadress-Domain zulässt. |
| 4 |
Prüfen Sie die Exchange-Nachrichtenflussregeln und stellen Sie sicher, dass keine Regel automatisch weitergeleitete Nachrichten blockiert. Wenn Sie eine Ausnahme benötigen, beschränken Sie sie auf das Support-Postfach und das genehmigte Ziel. |
| 5 |
Speichern Sie die Weiterleitungskonfiguration und warten Sie, bis die Änderungen der Microsoft 365-Richtlinie wirksam werden. Erforderlich: Eingehende E-Mails erreichen den zugewiesenen Webex-Workload erst, wenn die Weiterleitung aktiviert ist. In Microsoft 365 hat eine Richtlinie zum Blockieren von ausgehendem Spam, eine Remote-Domain-Einstellung oder eine Nachrichtenflussregel Vorrang vor einer Einstellung, die eine Weiterleitung zulässt. Limit für Anhänge: Eingehende E-Mail-Anhänge sind auf 25 MB begrenzt. Wenn eine Nachricht fehlschlägt, weil ihre Anlagen zu groß sind, erhält der Absender eine Nachricht über einen Fehler bei der Zustellung und muss sie mit kleineren Anhängen erneut senden. Inline-Bilder: Inline-Bilder kommen als Anlagen auf dem Agenten-Desktop an. Wenn PCI-Scannen aktiviert ist, werden diese Bilder blockiert. Microsoft OutlookAnlagen: Eine eingehende E-Mail mit einem MSG-Anhang könnte aufgrund einer Einschränkung ohne die in dieser .msg eingebetteten Dateien ankommen. Microsoft Outlook |
Testen Sie das E-Mail-Asset
Um den vollständigen E-Mail-Pfad zu überprüfen:
| 1 |
Senden Sie von einem externen E-Mail-Konto aus eine Nachricht an das konfigurierte Support-Postfach und stellen Sie sicher, dass die Nachricht den zugewiesenen Webex-Workload erreicht. |
| 2 |
Senden Sie vom zugewiesenen Webex-Workload aus eine neue Nachricht oder antworten Sie auf die eingehende Nachricht und stellen Sie sicher, dass der externe Empfänger sie erhält. Lieferstatus: E-Mails, die über den SMTP-Kanal gesendet werden, beinhalten keine Sendungsverfolgung, und der Service erhält keine Benachrichtigungen über Lieferfehler. Bestätigen Sie die Zustellung aus dem Empfängerpostfach während des Tests. |
| 3 |
Wenn die eingehende Lieferung nicht funktioniert, überprüfen Sie die Bestätigung der Weiterleitungsadresse, die Weiterleitungsregel und die Weiterleitungsrichtlinien des Unternehmens des Unternehmens. |
| 4 |
Wenn das ausgehende Senden nicht funktioniert, überprüfen Sie den SMTP-Server und -Port, die Anbieterberechtigungen, die Client-Anmeldeinformationen, die Zustimmung, die Microsoft 365-SMTP-AUTH-Einstellung und den Token-Status. Beheben Sie das Problem und generieren Sie bei Bedarf erneut Tokens. |