O365 - Exchange Connector einrichten Einrichtung der Verbindung 1. App registrieren Auf https://entra.microsoft.com anmelden. Nun auf „App-Registrierungen” klicken. Dann auf „Alle Anwendungen“ klicken. Jetzt eine neue Registrierung anlegen in dem oben auf „Neue Registrierung“ geklickt wird. Unter „Name“: „DeDeSales Exchange Connector“ eingeben. Gemäß der Umgebung den unterstützten Kontotypen auswählen. Bei nur einer Instanz haben: „Nur Konten in diesem Organisationsverzeichnis“ auswählen. Umleitungs-URL auswählen und „https://login.microsoftonline.com/common/oauth2/nativeclient“ eintragen. Auf „Registrieren“ klicken. Die gerade registrierte App aufrufen, in dem wieder auf „Azure Active Directory“ > „App-Registrierungen“ und dann auf „DeDeSales Exchange Connector“ geklickt wird. Übermitteln Sie uns die Anwendungs-ID. Übermitteln Sie uns und die Verzeichnis-ID.  Unter Beschreibung „DeDeSales Exchange Connector“ eingeben. Bei Gültig bis einen Zeitraum auswählen. Achtung! Vor Ablauf muss ein neuer Schlüssel erstellt und uns mitgeteilt werden, da ansonsten keine Kommunikation mehr möglich ist. Nun auf Hinzufügen klicken. Jetzt den „Wert“ kopieren, in dem auf das Copy-Symbol hinter den Zeichen getippt wird. Achtung! Dies geht nur jetzt. Wenn Sie die Seite verlassen, muss der Geheime Schlüssel neu angelegt werden. Uns den geheimen Schlüssel zur Verfügung stellen. Klicken Sie auf „API-Berechtigungen“ Auf „Berechtigung hinzufügen“ klicken. „Von meiner Organisation verwendete APIs“ auswählen Dann: Nach „Office 365 Exchange Online“ suchen und anklicken. Jetzt „Anwendungsberechtigungen“ auswählen. Unter „Andere Berechtigungen“, „full_access_as_app“ auswählen. Auf „Berechtigungen hinzufügen“ klicken. Auf „Administratorzustimmung für … erteilen“ klicken. Sicherstellen, dass uns folgende Informationen auf unterschiedlichen Wegen, mehrere E-Mails, sicherer Upload, o.ä., zukommen lassen: Anwendungs-ID Verzeichnis-ID Wert aus Geheimer Clientschlüssel in „Zertifikate & Geheimnisse“ Mit diesen Daten wurden nun Vollzugriff auf die Exchange Daten gegeben. Im nächsten Abschnitt, wird erklärt wie der Zugriff auf bestimmte Benutzerkonten eingeschränkt wird. 2. Zugriff auf Postfächer einschränken Eine neue E-Mail-aktivierte Sicherheitsgruppe erstellen oder eine vorhandene verwenden. Jetzt eine Richtlinie für den Anwendungszugriff anlegen. Dafür den folgenden Befehl in der Powershell ausführen und dabei die Argumente für AppId (=> entspricht der Anwendungs-ID aus der Registrierung der App), PolicyScopeGroupId ersetzen: “New-ApplicationAccessPolicy -AppId e7e4dbfc-046f-4074-9b3b-2ae8f144f59b -PolicyScopeGroupId EvenUsers@contoso.com -AccessRight RestrictAccess -Description "Eingeschränkter Zugriff für den DeDeSales Connector." Achtung! Wenn es Änderungen an den Zugriffen der Benutzer gibt, z.B. durch Neueinstellung eines Mitarbeiters, dann müssen die E-Mail-aktivierte Sicherheitsgruppe entsprechend erweitert werden. Konfiguration im DeDeSales-Backend Zugangsdaten hinterlegen Die Zugangsdaten im DeDeSales Backend unter Grundkonfiguration > Einstellungen > Exchange-Zugriff hinterlegen. Mitarbeiter-Benutzerkonten konfigurieren Unter Grundkonfiguration > Mitarbeiter bei jedem Mitarbeiter im Feld „Exchange Postfach“ die E-Mail-Adresse hinterlegen. Nur bei den Mitarbeitern, bei denen das Feld gefüllt ist, erfolgt auch ein Abzug der E-Mails. Bitte beachten, dass diese Mitarbeiter auch in der E-Mail-aktivierten Sicherheitsgruppe enthalten sein müssen, wenn der Zugriff eingeschränkt wurde. Zuordnung von Mails zu Kunden Es wird direkt der Msg Root Ordner geprüft, dabei werden die bekannten Ordner, wie Junk, Gelöscht, Entwürfe etc. ignoriert mit Ausnahme von Inbox und SentItems. Somit werden alle selbst erstellten Ordner für die Emails berücksichtigt. Liegt die E-Mail im Posteingang oder einem der Unterordner prüfen wir den Absender auf einen Treffer bei den Kontakten. Im Backend unter Grundkonfiguration \ Einstellungen \ "Domains bei Email Import ignorieren" können Domains eingetragen werden, die verworfen werden. Des Weiteren kann man unter Grundkonfiguration \ Einstellungen \ "Domains-Abgleich bei Kunden über vollständige E-Mail" hinterlegen, bei welchen Domains ein vollständiger Abgleich gemacht werden soll. Das können allgemeine Adressen sein, wie @gmx.de oder ähnliches.  Regeln zur Zuordnung: Empfänger (TO, CC) auslesen Abhängig von den Backendeinstellungen: genauer Treffer beim Ansprechpartner => Mail wird zugewiesen. keinen genauen Treffer beim Ansprechpartner: Der Domain-Teil der E-Mail-Adresse wird verglichen mit dem Eintrag des Domain-Teils der E-Mail des Debitors bei einem Treffer wird die Mail zugewiesen bei keinem Treffer wird die Mail ignoriert Bei einem Treffer wird importiert und zugeordnet. Die Anzeige der Exchange E-Mails finden Sie im Client unter Aktivitäten. Wird das Modul Chancen verwendet, dann erfolgt automatisch eine Zuordnung der Exchange Aktivität zu einem Lead/einer Chance. Regeln zur Zuordnung:  Lead Nach der Ermittlung des Kunden  Hat der Kunde einen Lead?   Ist der Status des Leads "In Bearbeitung" oder "Zurückgestellt" Dann die Aktivität dem Lead zuordnen. Chance Nach der Ermittlung des Kunden Ist der Kunde einer Chance zugeordnet? Ist die Chance In Bearbeitung Dann die Aktivität der Chance zuordnen Gibt es mehrere Treffer, dann wird der erste verwendet. E-Mail-Anhänge Im Widget Dokumente werden die E-Mail-Anhänge abgelegt. Auf der obersten Ebene gibt es einen Ordner "E-Mail Attachments" Klickt man da drauf werden Ordner angezeigt (Alle E-Mail-Anhänge mit Datum absteigend und dem Betreff der E-Mail) Gleiche Betreffs (ohne die Kürzel vor dem Doppelpunkt bei Antworten und weiterleiten) werden gruppiert angezeigt. Gibt es mehrere E-Mails mit gleichem Betreff und mehreren Anhängen befinden sie sich in Unterordnern In dem untersten Ordner befinden sich die eigentlichen Dateien Das Widget wird aktiviert im Backend unter / BASIS / Kundenstamm / Dokumente. Des Weiteren ist die Einstellung Nextcloud anzupassen, damit die Anhänge aus dem korrekten Verzeichnis ausgelesen werden.