E-Mail-Channel für OAuth mit Microsoft Office 365 konfigurieren

In diesem Dokument erfahren Sie, wie Sie einen E‑Mail-Kanal der Contact Center AI Platform (CCAI Platform) für Microsoft OAuth konfigurieren.

Vorbereitung

  1. Ein Azure-Konto mit einem aktiven Abo. Das Konto muss Zugriff auf die Microsoft Entra-Verwaltung haben und daher mit einer der folgenden Rollen konfiguriert sein:

    • Anwendungsadministrator
    • Anwendungsentwickler
    • Cloud-Anwendungsadministrator

  2. Ein Microsoft Entra-Mandant. Eine Anleitung zum Erstellen eines Mandanten finden Sie in der Microsoft-Kurzanleitung.

Prüfen, ob IMAP und SMTP für das E‑Mail-Konto zulässig sind

Die CCAI Platform verwendet IMAP und SMTP, um E‑Mails von Microsoft zu senden und zu empfangen. Da ein Microsoft-Konto mit verschiedenen Programmen verknüpft sein kann, ist es wichtig, dass IMAP oder SMTP nicht von anderen sekundären Programmen blockiert wird. In den folgenden Schritten werden einige häufige Stellen beschrieben, an denen Sie in Microsoft nachsehen können.

  1. Klicken Sie in der linken Navigationsleiste auf Nutzer > Aktive Nutzer.

  2. Wählen Sie einen Nutzer aus, den Sie überprüfen möchten.

  3. Klicken Sie auf E‑Mail. Wenn die Meldung „Dieser Nutzer hat keine Exchange Online-Lizenz“ angezeigt wird, müssen Sie dem Nutzer eine entsprechende Lizenz für die Verwendung von Exchange zuweisen. Ohne eine entsprechende Lizenz kann die CCAI Platform keine E‑Mails für dieses Nutzerkonto senden oder empfangen.

  4. Nachdem eine entsprechende Lizenz hinzugefügt wurde, wählen Sie auf dem Tab E‑Mail die Option E‑Mail-Apps verwalten aus. Prüfen Sie, ob die Optionen „IMAP“ und „Authentifiziertes SMTP“ ausgewählt sind.

  5. Klicken Sie auf Speichern.

  6. Klicken Sie in der linken Navigationsleiste auf Postfächer.

  7. Wählen Sie das Nutzerkonto aus, das Sie überprüfen möchten.

  8. Wählen Sie auf dem Tab Allgemein die Option Einstellungen für E‑Mail-Apps verwalten aus. Prüfen Sie, ob die Option „IMAP“ aktiviert ist.

Anwendung registrieren

  1. Melden Sie sich im Microsoft Entra Admin Center an. Wenn Sie mehrere Mandanten haben, verwenden Sie den Filter Verzeichnisse + Abos , um zum richtigen Mandanten zu wechseln.

  2. Klicken Sie auf Identität > Anwendungen > App-Registrierungen > Neue Registrierung.

  3. Geben Sie einen aussagekräftigen Anzeigenamen ein. Mehrere App-Registrierungen können denselben Namen haben. Die Client-ID wird vom Programm verwendet, um die App zu identifizieren. Da Nutzer des Programms den von Ihnen erstellten Namen sehen können, kann es die Registrierung beschleunigen, wenn Sie einen eindeutigen Namen verwenden.

  4. Geben Sie den Kontotyp an, der die Anwendung verwenden kann, oder die Zielgruppe für die Anmeldung. Es werden mehrere Kontotypen unterstützt:

    1. Nur Konten in diesem Organisationsverzeichnis: Wählen Sie diese Option aus, wenn Sie eine Anwendung erstellen, die nur von Nutzern (oder Gästen) in einem einzelnen Mandanten verwendet werden soll. Diese Anwendungen werden manchmal auch als Line-of-Business-Anwendungen (LOB) bezeichnet.

    2. Konten in einem beliebigen Organisationsverzeichnis: Wählen Sie diese Option aus, wenn Sie möchten, dass Nutzer in einem beliebigen Mandanten diese Anwendung verwenden können. Diese Option ist für Konfigurationen mit mehreren Mandanten vorzuziehen.

    3. Konten in einem beliebigen Organisationsverzeichnis und private Microsoft Konten: Wählen Sie diese Option aus, wenn Nutzer in einem beliebigen Mandanten diese Anwendung verwenden können sollen, sowie Nutzer mit privaten Microsoft Konten.

    4. Private Microsoft-Konten: Wählen Sie diese Option aus, wenn Sie nur eine Anwendung für Nutzer mit privaten Microsoft-Konten erstellen möchten. Dazu gehören Microsoft-, Skype-, Xbox-, Live- und Hotmail-Konten.

  5. Wählen Sie für Weiterleitungs-URI die Option Web aus und geben Sie https://{tenant}.ccaiplatform.com/v1/email_accounts/oauth_callback ein. Ersetzen Sie {tenant} durch den Namen Ihres CCAI Platform-Mandanten.

  6. Klicken Sie auf Registrieren , um die erste App-Registrierung abzuschließen.

  7. Nach Abschluss der Registrierung wird der Bildschirm Übersicht angezeigt. Notieren Sie sich die folgenden Informationen, die Sie benötigen, wenn Sie den Vorgang in der CCAI Platform abschließen:

    • Anwendungs- oder Client-ID
    • Verzeichnis- oder Mandanten-ID

Anwendung aktivieren

  1. Melden Sie sich im Microsoft Entra Admin Center an.

  2. Klicken Sie auf Identität > Anwendungen > Unternehmensanwendungen und wählen Sie die App aus.

  3. Klicken Sie auf Eigenschaften.

  4. Setzen Sie die Option Für Nutzer sichtbar? auf Ja.

Anmeldedaten für die Anwendung hinzufügen

Erstellen Sie einen Clientschlüssel für die Verwendung auf der CCAI Platform.

  1. Melden Sie sich im Microsoft Entra Admin Center an.

  2. Klicken Sie auf Identität > Anwendungen > App-Registrierungen und wählen Sie die App aus.

  3. Klicken Sie auf Zertifikate & Secrets > Clientschlüssel > Neuer Clientschlüssel. Dadurch wird ein Bereich geöffnet, in dem Sie den Schlüssel benennen können.

  4. Fügen Sie eine Beschreibung für den Clientschlüssel hinzu.

  5. Wählen Sie ein Ablaufdatum für den Schlüssel aus oder geben Sie eine benutzerdefinierte Lebensdauer an. Die Lebensdauer des Clientschlüssels ist auf zwei Jahre (24 Monate) oder weniger begrenzt. Microsoft empfiehlt jedoch, einen Ablaufwert von weniger als 12 Monaten festzulegen.

  6. Klicken Sie auf Hinzufügen. Notieren Sie sich den Wert des Schlüssels. Sie benötigen ihn, um den Vorgang in der CCAI Platform abzuschließen.

API-Berechtigungen hinzufügen

Die Graph API ermöglicht es Zugriffstokens, mit IMAP zu arbeiten, was für den Betrieb des E‑Mail-Kanals der CCAI Platform erforderlich ist.

  1. Melden Sie sich im Microsoft Entra Admin Center an.

  2. Klicken Sie auf Identität > Anwendungen > App-Registrierungen und wählen Sie die App aus.

  3. Klicken Sie auf API-Berechtigungen > Berechtigung hinzufügen.

  4. Wählen Sie Microsoft Graph aus.

  5. Wählen Sie Delegated permissions (Delegierte Berechtigungen) aus. Verwenden Sie die Suchleiste Berechtigungen auswählen , um die folgenden Suchanfragen auszuführen, und setzen Sie die Häkchen neben den entsprechenden Ergebnissen:

    • IMAP: Wählen Sie IMAP.AccessAsUser.All aus.
    • offline: Wählen Sie offline_access aus.
    • openid: Wählen Sie openid aus.
    • smtp: SMTP.Send

  6. Klicken Sie auf Add permissions (Berechtigungen hinzufügen).

Anmeldedaten zur CCAI Platform hinzufügen

Nachdem die Microsoft-Einrichtung abgeschlossen ist, verwenden Sie die Informationen aus dem Einrichtungsprozess, um die Verbindung zwischen den beiden Programmen in der CCAI Platform herzustellen. Klicken Sie auf Einstellungen > E‑Mail-Kontoverwaltung > E‑Mail SO und geben Sie die folgenden Informationen ein:

Zugriffstyp: Lassen Sie das Feld leer.

Autorisierungs-URL: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize. {tenant_id} ist die Verzeichnis- oder Mandanten-ID aus der Microsoft-App.

Token-URL: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. {tenant_id} ist die Verzeichnis- oder Mandanten-ID aus der Microsoft-App.

Client-ID: Die Anwendungs- oder Client-ID aus der Microsoft-App.

Clientschlüssel: Der Wert des Clientschlüssels aus der Microsoft-App.

Bereich: Geben Sie die folgenden Werte ein. Sie müssen nicht durch Kommas getrennt sein, aber alle müssen vorhanden sein.

  • openid email offline_access
  • https://outlook.office.com/IMAP.AccessAsUser.All
  • https://outlook.office.com/SMTP.Send

Status: Lassen Sie das Feld leer.

Zugriffstyp: Lassen Sie das Feld leer.

Berechtigungstyp: Autorisierungscode

Deaktivieren Sie „Berechtigungstyp als Teil der Autorisierungs-URL und der Token-URL einbeziehen“.

Aktivieren Sie „Weiterleitungs-URL als Teil der Autorisierungs-URL und der Token-URL einbeziehen“.

Klicken Sie auf Speichern.