E-Mail-Kanal für OAuth mit Gmail konfigurieren

Auf dieser Seite wird beschrieben, wie Sie mit Google Cloud OAuth-Anmeldedaten zum Konfigurieren Ihres E-Mail-Kanals für die Contact Center AI Platform (CCAI Platform) erstellen.

Hinweise

Folgende Voraussetzungen müssen erfüllt sein:

• Ein Google Cloud -Konto. Weitere Informationen finden Sie unter Erste Schritte mit Google Cloud.

• Ein Google Cloud -Projekt. Weitere Informationen finden sich unter Projekte erstellen und verwalten.

Achten Sie außerdem darauf, dass die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist. Weitere Informationen finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen.

OAuth-Anmeldedaten erstellen

Sie können Google Cloud verwenden, um OAuth-Anmeldedaten zu erstellen, also die Client-ID und das Client-Secret. Wenn Sie noch keinen Zustimmungsbildschirm konfiguriert haben, müssen Sie dies tun, bevor Sie OAuth-Anmeldedaten erstellen können. Weitere Informationen zu OAuth finden Sie unter Mit OAuth 2.0 auf Google APIs zugreifen.

So erstellen Sie OAuth-Anmeldedaten und konfigurieren den Zustimmungsbildschirm:

1. Rufen Sie in der Google Cloud Console das Dashboard für die Projektauswahl auf und wählen Sie das Projekt aus, mit dem Sie OAuth-Anmeldedaten erstellen möchten.

   Dashboard für die Projektauswahl

2. Rufen Sie die Seite APIs und Dienste auf und klicken Sie im Navigationsmenü auf Anmeldedaten.

   Anmeldedaten

3. Wenn Sie den Zustimmungsbildschirm für dieses Google CloudProjekt noch nicht konfiguriert haben, wird die Schaltfläche Zustimmungsbildschirm konfigurieren angezeigt. Konfigurieren Sie in diesem Fall den Zustimmungsbildschirm mit der folgenden Anleitung. Fahren Sie andernfalls mit Schritt 4 fort.

   1. Klicken Sie auf Zustimmungsbildschirm konfigurieren. Die Seite OAuth-Zustimmungsbildschirm wird angezeigt.

   2. Wählen Sie je nach Anwendungsfall Intern oder Extern aus und klicken Sie dann auf Erstellen. Der Bereich OAuth-Zustimmungsbildschirm wird angezeigt.

   3. Geben Sie auf der Seite App-Informationen Informationen gemäß der Anleitung auf dem Bildschirm ein und klicken Sie dann auf Speichern und fortfahren. Der Bereich Bereiche wird angezeigt.

   4. Klicken Sie auf Bereiche hinzufügen oder entfernen. Der Bereich Ausgewählte Bereiche aktualisieren wird angezeigt.

   5. Wählen Sie den oder die für Ihren Anwendungsfall geeigneten Bereiche aus und klicken Sie dann auf Aktualisieren.

   6. Klicken Sie auf Speichern und fortfahren. Der Bereich Testnutzer wird angezeigt.

   7. Wenn Sie Nutzer hinzufügen möchten, um den Zugriff auf Ihre App zu testen, klicken Sie auf Nutzer hinzufügen. Der Bereich Nutzer hinzufügen wird angezeigt.

   8. Fügen Sie im leeren Feld eine oder mehrere E-Mail-Adressen von Google-Konten hinzu und klicken Sie dann auf Hinzufügen.

   9. Klicken Sie auf Speichern und fortfahren. Der Bereich Zusammenfassung wird angezeigt.

   10. Prüfen Sie die Informationen auf dem OAuth-Zustimmungsbildschirm und klicken Sie dann auf Zurück zum Dashboard.

   11. Wenn Sie Ihre App jetzt in der Produktion veröffentlichen möchten, klicken Sie auf App veröffentlichen und dann im Bestätigungsdialogfeld auf Bestätigen. Ihr Zustimmungsbildschirm ist konfiguriert.

4. Klicken Sie im Navigationsmenü auf Anmeldedaten.

5. Klicken Sie auf Anmeldedaten erstellen und dann auf OAuth-Client-ID.

6. Klicken Sie im Feld Anwendungstyp auf Webanwendung.

7. Geben Sie im Feld Name einen Namen für den Client ein.

8. Klicken Sie im Bereich Autorisierte JavaScript-Quellen auf IRI hinzufügen.

9. Geben Sie im Feld URIs https://TENANT_NAME.ccaiplatform.com ein und ersetzen Sie TENANT_NAME durch Ihren Mandantennamen.

10. Klicken Sie im Bereich Autorisierte Weiterleitungs-URIs auf URI hinzufügen.

11. Geben Sie im Feld URIs https://TENANT_NAME.ccaiplatform.com/v1/email_accounts/oauth_callback ein und ersetzen Sie TENANT_NAME durch den Namen Ihres Mandanten.

12. Klicken Sie auf Erstellen. Das Dialogfeld OAuth-Client erstellt wird angezeigt.

13. Klicken Sie auf JSON herunterladen, um eine JSON-Datei mit Ihrer Client-ID und Ihrem Client-Secret auf Ihren Computer herunterzuladen, und klicken Sie dann auf OK.

    Wichtig :Bewahren Sie diese JSON-Datei an einem sicheren Ort auf, da sie Ihre OAuth-Anmeldedaten enthält.

Client-ID und Clientschlüssel abrufen

Nachdem Sie OAuth-Anmeldedaten erstellt haben, können Sie Ihre Client-ID und Ihr Client-Secret jederzeit abrufen.

So rufen Sie Ihre Client-ID und Ihr Client-Secret ab:

1. Rufen Sie in der Google Cloud Console die Seite APIs und Dienste auf. Klicken Sie im Navigationsmenü auf Anmeldedaten.

   Anmeldedaten

2. Klicken Sie im Bereich OAuth 2.0-Client-IDs auf den Client, für den Sie die Client-ID und den Clientschlüssel benötigen. Ihre Client-ID und Ihr Clientschlüssel werden im Bereich Zusätzliche Informationen angezeigt.

SSO-Einstellungen für den E-Mail-Channel konfigurieren

Verwenden Sie die Client-ID und das Client-Secret, die Sie unter OAuth-Anmeldedaten erstellen erstellt haben, um die Einstellungen für die Einmalanmeldung (SSO) für den E-Mail-Channel zu konfigurieren.

So konfigurieren Sie die SSO-Einstellungen:

1. Klicken Sie im CCAI Platform-Portal auf  Menü und dann auf Einstellungen > Entwicklereinstellungen.

2. Rufen Sie den Bereich E-Mail-Kontoverwaltung auf und klicken Sie auf E-Mail-Konto verwalten.

3. Klicken Sie auf der Seite E‑Mail-Kontoverwaltung auf E‑Mail-SSO.

4. Konfigurieren Sie im Bereich E-Mail-SSO die Einstellungen wie in der folgenden Liste beschrieben:

   • Autorisierungs-URL Geben Sie https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent ein.

     Wichtig :Fügen Sie das Leerzeichen vor consent ein.

   • Token-URL: Geben Sie https://oauth2.googleapis.com/token ein.

   • Client-ID Geben Sie die Client-ID ein, die Sie unter OAuth-Anmeldedaten erstellen erstellt haben. Wenn Sie Ihre Client-ID nicht gespeichert haben, lesen Sie den Abschnitt Client-ID und Clientschlüssel abrufen.

   • Clientschlüssel Geben Sie den Clientschlüssel ein, den Sie unter OAuth-Anmeldedaten erstellen erstellt haben. Wenn Sie Ihr Clientschlüssel nicht gespeichert haben, lesen Sie den Abschnitt Client-ID und Clientschlüssel abrufen.

   • Umfang: Geben Sie https://mail.google.com/ ein.

   • State, Lassen Sie dieses Feld leer.

   • Zugriffstyp: Geben Sie offline ein.

   • Grant type (Art der Lizenz). Geben Sie Authorization Code ein.

   • Entfernen Sie das Häkchen aus dem Kästchen Grant-Typ als Teil der Autorisierungs-URL und Token-URL einbeziehen.

   • Klicken Sie das Kästchen Weiterleitungs-URL in Autorisierungs-URL und Token-URL einbeziehen an und klicken Sie dann auf Speichern. Ihr E-Mail-Channel ist für OAuth konfiguriert.