Exchange-Integration

Exchange-Integration für IXP in Automation Cloud zum Synchronisieren von E-Mail-Daten in Communications Mining, einschließlich Abrechnungsdetails und Setup-Übersicht.

Warnung:

Microsoft stellt Exchange Web Services (EWS) für Exchange Online am 1. Oktober 2026 ein (Ankündigung von Microsoft). Es wird empfohlen, Ihre Exchange-Integrationen so schnell wie möglich auf die Microsoft Graph-API umzustellen. Die Migrationsschritte finden Sie in der Migrationsanleitung von EWS zu Microsoft Graph API.

Überblick

Die Exchange-Integration bietet eine bequeme und einfach einzurichtende Möglichkeit, Ihre Entwicklungs- und Produktions-E-Mail-Daten in Echtzeit mit Communications Mining™ zu synchronisieren.

Hinweis:

Ihnen werden 1 AI Unit oder 0,2 Platform Units pro erstelltem Kommentar oder pro aktualisiertem Kommentar in Rechnung gestellt, basierend auf der Nachrichten-ID der E-Mail, wenn ihr Text geändert wurde.

Die Exchange-Integration fragt Ihren Exchange-Server kontinuierlich nach neuen E-Mails in den konfigurierten Postfächern ab. Die E-Mails werden bereinigt, bereichert und in Communications Mining-Kommentarobjekte konvertiert, auf die Benutzer auf der Communications Mining-Webplattform und Anwendungen oder Bots über die Communications Mining-API zugreifen können. Die Exchange-Integration wird in der Communications Mining-Cloud ausgeführt.

Die abzurufenden Postfächer können bequem in der Communications Mining-Benutzeroberfläche konfiguriert werden, die auch die Funktionalität zum Starten oder Beenden der Integration und zum Aktualisieren der Konfigurationsparameter bietet, die zum Herstellen einer Verbindung mit Ihrem Exchange-Server verwendet werden.

Hinweis:

• Die Exchange-Integration ist kompatibel mit Exchange Online und mit Microsoft Exchange 2010-2019 Server unter Verwendung von Exchange Web Services (EWS).
• Die Exchange-Integration ruft den Exchange-Server ab, indem authentifizierte GET-Anforderungen über HTTPS gestellt werden. Die Exchange-Integration empfängt Daten über die GET-Anforderungen, die sie initiiert, und akzeptiert keine eingehenden Verbindungen, die anderswo initiiert werden. Die Exchange-Integration kann mit bestimmten Verschlüsselungen konfiguriert werden.
• Es reicht, der Exchange-Integration schreibgeschützten Zugriff auf Ihre Postfächer zu gewähren.

So werden E-Mails synchronisiert

Die Integration synchronisiert kontinuierlich E-Mails von jedem konfigurierten Postfach. Wenn keine Startzeit angegeben ist, werden alle E-Mails synchronisiert.

Die Integration legt den message_id des Kommentars auf den hexadex-codierten comment ID der synchronisierten E-Mail fest. Wenn mehrere Postfächer, die dieselbe E-Mail enthalten, z. B. aufgrund des Hinzufügens zum CC-Feld derselben E-Mail, mit demselben Bucket synchronisiert werden, enthält der resultierende Kommentar die Metadaten der zuletzt synchronisierten E-Mail.

Die Integration aktualisiert die Benutzereigenschaft Ordner eines Kommentars, wenn die entsprechende E-Mail in einen anderen Ordner verschoben wird. Die Integration aktualisiert nicht den Betreff oder Text des Kommentars, wenn einer in der E-Mail aktualisiert wird, nachdem sie gesendet oder empfangen wurde.

Sie können die Synchronisierung von Anhängen auch auf Postfachebene auf einer Exchange-Integration aktivieren. Die Streams-API macht die Anhänge dann über eine Anhangsreferenz abrufbar. Weitere Informationen zum Synchronisieren von Anhängen finden Sie auf den Seiten Anhänge und Verwenden von Exchange-Integrationen .

Die folgende Abbildung enthält ein Beispiel für eine Postfachkonfiguration mit den Werten:

• Bucket: Postfach (org2/example-2b2f8982)

• Inhaltsfilterregeln:

  • Explizit zulässige Ordner: Stamm/Oben des Informationsspeichers/Posteingang
  • Explizit verweigerte Ordner: Keine
  • Ab dem 1. Februar 2023 12:00 Uhr UTC
  Hinweis:

  Sie sollten den Top of Information Store/ in der Sprache des Exchange-Servers und nicht in der Sprache des Benutzers ausdrücken.

  Beachten Sie beim Anwenden von Ordnerfiltern Folgendes:

  • Geschachtelte Ordner werden durch einen Schrägstrich / getrennt.
  • In Outlook sichtbare Ordner haben normalerweise das Präfix root/Top of Information Store.
  • Das Zulassen von Ordnern bedeutet, dass nicht explizit zulässige Ordner verweigert werden.
  • Sie können einen Ordner innerhalb eines zulässigen Ordners verweigern.
  • Sie können einen Ordner innerhalb eines verweigerten Ordners nicht zulassen.
  Tipp:

  Beschränken Sie den Ordnerfilter-Scope auf die Mindestanforderungen für Ihren Anwendungsfall. Wenn Sie Zulässige Ordner leer lassen, wird die Integration kontinuierlich mit jedem Ordner im Postfach synchronisiert – einschließlich Archivieren und wiederherstellbaren Elementen (Bereinigungen) –, was die Synchronisierung erheblich verlangsamt. Lassen Sie für die meisten BAU-Verarbeitungen nur Folgendes zu:

  • root/Top of Information Store/Inbox
  • root/Top of Information Store/Sent Items

  

Integrationsfehler

Integrationen, bei denen persistente Probleme auftreten, werden automatisch auf Integrationsebene deaktiviert, wenn die Integration falsch konfiguriert ist, oder auf Postfachebene, wenn das Postfach falsch konfiguriert ist.

Sie werden benachrichtigt, um ein oder mehrere Probleme zu beheben. Sobald sie gelöst sind, können Sie die Integration wieder aktivieren.

Dies geschieht, wenn das Postfach nicht gefunden werden kann, wenn es gelöscht wurde, das Dienstkonto keinen Zugriff auf den Posteingang hat oder die Anmeldeinformationen abgelaufen sind und aktualisiert werden müssen.

Beispiele für Fehler, die die Integration deaktivieren, sind:

• Falsche Anmeldeinformationen
• Abgelaufene Anmeldeinformationen
• Erreichen eines Kontingentlimits für das Hochladen von Daten
• Fehlkonfiguration der Exchange-Serverdetails

Beispiele für Fehler, die ein Postfach deaktivieren, sind:

• Ungültige Berechtigungen für das Dienstkonto oder die App-Authentifizierung
• Falsch geschriebene Postfachadresse
• Postfach gelöscht

Abonnieren von Benachrichtigungen

Sie erhalten Warnungen und Integrationsfehlerbenachrichtigungen automatisch, wenn Sie eine der folgenden Rollen haben:

• IXP-Projektadministrator
• IXP Modelltrainer
• IXP-Entwickler
• IXP_Anzeige
• IXP Analyst

Sie können sich auch selbst über den Benachrichtigungsdienst abonnieren oder abmelden. Informationen zum Verwalten Ihrer Benachrichtigungseinstellungen finden Sie unter Verwalten von Benachrichtigungen.

Zum Aktualisieren von Integrationskonfigurationen sind die Rollen IXP Project Admin oder IXP Developer erforderlich.

Konfiguration

Online austauschen

Folgen Sie einer der Schritt-für-Schritt-Anleitungen:

• Exchange-Integration mit der Azure-Anwendungsauthentifizierung
• Exchange Integration mit einem Azure-Dienstbenutzer

Selbst gehosteter Exchange Server

Selbst gehostete Exchange-Server werden nur über die EWS-API mit NTLM-Authentifizierung unterstützt. Die OAuth-Authentifizierung mit einem geheimen Clientschlüssel oder einem privaten Schlüssel ist nur für Exchange Online verfügbar.

Richten Sie ein NTLM-Dienstkonto ein und gewähren Sie dem Dienstbenutzerdelegierten Lesezugriff auf die Postfächer, die Sie synchronisieren möchten.

Hinweis:

Die Exchange-Integration wird in der UiPath Automation Cloud™ ausgeführt, daher muss Ihr EWS-Endpunkt über das Internet erreichbar sein und eine öffentliche IP-Adresse auflösen.

Erfassen Sie die folgenden Details:

• EWS-Endpunkt – die vollständige URL des EWS-Diensts auf Ihrem Exchange Server. Der Pfad sollte mit /EWS/Exchange.asmx enden, z. B. https://mail.example.com/EWS/Exchange.asmx.
• Benutzername und Kennwort des Dienstbenutzers.
• Ein Testpostfach, auf das der Dienstbenutzer zugreifen kann, mit dem die Anmeldeinformationen überprüft werden, wenn Sie sie speichern.
• Optional die Build-Nummer Ihres Exchange Servers.
• Liste der zu synchronisierenden Postfächer.

So konfigurieren Sie die Integration in Communications Mining™:

1. Navigieren Sie zur Seite Administration und wählen Sie die Registerkarte Integrationen .
2. Wählen Sie Neue Integration aus.
3. Wählen Sie unter Mit Ihrer Anwendung verbinden die Option EWS-API aus.
4. Wählen Sie Mit NTLM aus und geben Sie den EWS-Endpunkt, die Build-Nummer, falls Sie eine haben, und das Testpostfach ein.
5. Wählen Sie Mit Dienstbenutzerzugriff aus und geben Sie den Benutzernamen und das Kennwort des Dienstbenutzers ein.
6. Wählen Sie Anmeldeinformationen validieren und speichern aus.
7. Fügen Sie die Postfächer hinzu, die Sie synchronisieren möchten, wie unter Verwenden von Exchange-Integrationen beschrieben.

Wichtig:

Wenn Sie Gesamte Zeit im Abschnitt Zeitfilter auswählen, kann dies dazu führen, dass mehr Daten als erwartet synchronisiert werden und Nachrichten beim Hochladen in Rechnung gestellt werden.