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

Auf dieser Seite wird erklärt, wie Sie OAuth-Anmeldedaten erstellen, um den E‑Mail-Channel Ihrer Contact Center AI Platform (CCAI Platform) zu konfigurieren. Google Cloud

Hinweis

Sie benötigen Folgendes:

Außerdem muss die Abrechnung für Ihr Google Cloud Projekt aktiviert sein. Weitere Informationen finden Sie unter Abrechnungsstatus Ihrer Projekte.

OAuth-Anmeldedaten erstellen

Sie können Google Cloud verwenden, um OAuth-Anmeldedaten zu erstellen – die Client-ID und den Clientschlüssel. Wenn Sie noch keinen Zustimmungsbildschirm konfiguriert haben, müssen Sie das tun, bevor Sie OAuth-Anmeldedaten erstellen können. Weitere Informationen zu OAuth finden Sie unter OAuth 2.0 für den Zugriff auf Google APIs verwenden.

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 Cloud Projekt noch nicht konfiguriert haben, wird die Schaltfläche Zustimmungsbildschirm konfigurieren angezeigt. Konfigurieren Sie in diesem Fall den Zustimmungsbildschirm mit der folgenden Anleitung. Andernfalls fahren Sie 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 die 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 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 zum OAuth-Zustimmungsbildschirm und klicken Sie dann auf Zurück zum Dashboard.

    11. Wenn Sie Ihre App jetzt in der Produktionsumgebung veröffentlichen möchten, klicken Sie auf Publish app und dann im Bestätigungsdialog auf Confirm. 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 Ihren 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 Ihren Mandantennamen.

  12. Klicken Sie auf Erstellen. Der Dialog OAuth-Client erstellt wird angezeigt.

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

Client-ID und Clientschlüssel abrufen

Nachdem Sie OAuth-Anmeldedaten erstellt haben, können Sie Ihre Client-ID und Ihren Clientschlüssel jederzeit abrufen.

So rufen Sie Ihre Client-ID und Ihren Clientschlüssel 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 den Clientschlüssel, die Sie unter OAuth-Anmeldedaten erstellen erstellt haben, um die Einstellungen für die Einmalanmeldung (Single Sign-On, 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 dann 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 gezeigt:

    • Autorisierungs-URL. Geben Sie https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account 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 Ihren Clientschlüssel nicht gespeichert haben, lesen Sie den Abschnitt Client-ID und Clientschlüssel abrufen.

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

    • Status. Lassen Sie dieses Feld leer.

    • Zugriffstyp. Geben Sie offline ein.

    • Gewährungstyp. Geben Sie Authorization Code ein.

    • Deaktivieren Sie das Kästchen Gewährungstyp als Teil der Autorisierungs-URL und Token-URL einbeziehen.

    • Aktivieren Sie das Kästchen Weiterleitungs-URL als Teil der Autorisierungs-URL und Token-URL einbeziehen und klicken Sie dann auf Speichern. Ihr E‑Mail-Channel ist für OAuth konfiguriert.