> For the complete documentation index, see [llms.txt](https://docs.desk4.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.desk4.de/faq/microsoft-365-exchange-online-anbindung.md).

# Microsoft 365 (Exchange Online) Anbindung

## E-Mail Versand

### Einrichtung&#x20;

{% hint style="danger" %}
**Achtung**: Die Anmeldung für Microsoft 365 funktioniert ausschließlich über den Browser und NICHT über die Windows-App.&#x20;
{% endhint %}

Die Anmeldung für Microsoft 365 muss in jedem Benutzerkonto einzeln hinterlegt werden.&#x20;

Sie finden die Microsoft 365 Anmeldung im aktuellen Benutzer unter dem Menüpunkt "Zugänge ändern".&#x20;

{% hint style="warning" %}
Prüfen Sie im besten Fall schon vorab, mit welchem Microsoft Konto Sie im Browser angemeldet sind. Rufen Sie dazu folgenden Link auf -> <https://account.microsoft.com/account?lang=de-de>

Nun können Sie sich bei Bedarf auch von einem eventuell falschem Konto abmelden und mit dem richtigen Konto anmelden.&#x20;

* Verwenden Sie dazu Ihre Firmen E-Mail-Adresse aus Microsoft 365 und das entsprechende Passwort
* Halten Sie Ihre 2 Faktor Authentifizierungsapp bereit
  {% endhint %}

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FzEjXnPfsKzfDIYTTZ2YU%2Fimage.png?alt=media&amp;token=9fc1d014-a5c5-4adb-af96-681583d75f0d" alt=""><figcaption></figcaption></figure>

Klicken Sie im Bereich **Microsoft 365** auf "**Microsoft Login**". Nun melden Sie sich mit Ihrem Microsoft Benutzerkonto an und erteilen die Freigabe.&#x20;

Der Access-Token und der Refresh-Token werden nach der Freigabe automatisch eingetragen.&#x20;

### **Die erste Freigabe der desk4 Unternehmensanwendung für Microsoft**

{% hint style="warning" %}
**Die erste Freigabe der desk4 Unternehmensanwendung für Microsoft muss durch einen Administrator erfolgen**.&#x20;

Danach können weitere User die Verbindung verwenden. Entsprechende Einstellung für die Verwendung von Unternehmensanwendungen müssen gegeben sein. Weitere Informationen finden Sie in Ihrem **Microsoft Entra Admin Center** -> <https://entra.microsoft.com/>

**Bei Fragen zu Ihren Microsoft-Einstellungen wenden Sie sich an Ihren Microsoft Berater.**
{% endhint %}

Als Administrator setzen Sie bei der ersten Freigabe die Checkbox "Zustimmung im Namen Ihrer Organisation".

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FYsT53kUY7KUG1GtjNcgw%2Foffice_365_desk4_berechtigung.png?alt=media&amp;token=a568c60a-f9c2-470a-a066-2e1fbfd8e325" alt=""><figcaption></figcaption></figure>

Danach werden Sie zu desk4 zurückgeleitet, der Access-Token und der Refresh-Token werden nach der Freigabe automatisch eingetragen

{% hint style="warning" %}
Bitte beachten Sie, dass für das Versenden unter einer zusätzlichen E-Mail-Adresse als der Eigenen, sowohl die Freigabe bei Microsoft als auch im desk4 Benutzerkonto (Einstellungen -> Mitarbeiter -> *gewünschten Mitarbeiter auswählen* -> Registerkarte E-Mail) erfolgen muss.&#x20;

Dies ist z.B. notwendig, wenn man als normaler User mit der info\@... Adresse E-Mails versenden möchte.
{% endhint %}

### Test E-Mail versenden

Über den grünen Button "Testmail versenden" können Sie prüfen, ob eine E-Mail versendet werden kann.&#x20;

Geben Sie dort Ihre E-Mail-Adresse als Absender und eine beliebige E-Mail-Adresse als Empfänger ein. Sie können auch sich selbst als Empfänger eintragen.

Dieser Button prüft nur, ob generell E-Mails versendet werden können. \
Die Berechtigungen für die jeweiligen Mitarbeiter in desk4 werden dabei nicht berücksichtigt. &#x20;

{% hint style="danger" %}
Sollte ein E-Mail-Versand nicht möglich sein, prüfen Sie die Einstellungen bei Microsoft. Eventuell haben Sie sich auch mit dem falschen Microsoft-Konto angemeldet. Loggen Sie sich über den  Button "Microsoft Logout" in desk4 bei Microsoft aus. Danach können Sie vorne beginnen.
{% endhint %}

### Mandant-ID (Tenant-ID) - Sicherheit erhöhen

Um die Sicherheit zu erhöhen und damit kein falsches Microsoft Konto verbunden werden kann, können Sie die Mandant-ID oder auch Tenant-ID genannt, in den Grundeinstellungen von desk4 hinterlegen.&#x20;

Unter Einstellungen -> Grundeinstellungen -> Microsoft kann die Microsoft Tenant-Id eingetragen werden. Das System prüft beim Verbinden mit Microsoft, ob die Tenant-ID des Benutzers mit der ID der Firma übereinstimmt. Somit ist es nicht mehr möglich, dass ein Konto einer anderen Firma oder eines privaten Kontos verknüpft wird.&#x20;

Ihre Tenant-ID finden Sie im Microsoft [Entra Admin Center im Menüpunkt Übersicht](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/TenantOverview.ReactView/initialValue//tabId//recommendationResourceId//fromNav/Identity). \
Im Standard ist keine Tenant-ID in desk4 eingetragen.&#x20;

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FlrjjIWb5bzDNbMjiC1sH%2Fimage.png?alt=media&amp;token=e79be025-1ad0-4ea3-bbab-7a15f65cebd1" alt=""><figcaption></figcaption></figure>

### Gesendeter Postausgangsordner für freigegebene Postfächer

Wenn Sie die versendeten E-Mails in Ihren freigegebenen Postfächern (z.B. auch in Outlook) aufgeführt haben möchten, dann muss für das jeweilige Postfach per PowerShell die Berechtigungen erteilt werden. Verwenden Sie dazu bitte folgende PowerShell-Befehle.&#x20;

{% hint style="danger" %}
Die Powershell darf nur geschulten Administrator verwendet werden.

**Wenden Sie sich ggfls. an Ihren Microsoft Berater.**
{% endhint %}

```
Microsoft Powershell als Admin starten:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Install-Module Microsoft.Graph -Scope CurrentUser
Install-Module Microsoft.Graph.Beta
Install-Module -Name ExchangeonlineManagement
Connect-Exchangeonline -UserPrincipalName Benutzername/E-Mail/Admin
Set-Mailbox "Postfachname" -MessageCopyForSendOnBehalfEnabled $true
Set-Mailbox "Postfachname" -MessageCopyForSentAsEnabled $true


Get-Mailbox -Identity "Postfachname" | Format-List DisplayName, RecipientType, MessageCopyForSendOnBehalfEnabled
Get-Mailbox -Identity "Postfachname" | Format-List DisplayName, RecipientType, MessageCopyForSentAsEnabled
```

Versendete E-Mails werden ab jetzt sowohl im eigenen als auch im zusätzlich freigegebenen Postfach unter den gesendeten E-Mails angezeigt.&#x20;

### Beschränkungen und Limits

Mehr Informationen zu den Limits beim E-Mail Versand haben wir [hier](https://docs.desk4.de/faq/was-sind-die-beschrankungen-fur-den-massenversand.md#welches-empfangs-und-sendegrenzen-hat-microsoft-365-bei-dem-mailversand) beschrieben.

### Weitere FAQ's aus Kundenfragen

* Frage: Werden die E-Mails auch als gesendete E-Mails in den Absender-Ordnern der in den Grundeinstellungen eingetragenen Absender-E-Mail-Adressen erscheinen (z.B. Angebotsmailadresse)\
  Antwort: Wenn die Powershell-Einträge (dementsprechend) getätigt wurden, ja
* Frage: Sollte man trotz der Microsoft 356-Einstellungen die SMTP-Einstellungen unter \
  Einstellungen -> Grundeinstellungen -> E-Mail pflegen?&#x20;

  Antwort: Wenn Sie den Fallback auf SMTP möchten, dann ja.

  Reihenfolge:

  Microsoft 356 hat Vorrang, wenn eingestellt,

  danach die Einstellungen unter Einstellungen -> Mitarbeiter.

  Danach die Einstellungen unter Einstellungen -> Grundeinstellungen -> E-Mail

## Kalender

### Arbeitsnachweise und CRM-Einträge als Termin eintragen

desk4 kann Arbeitsnachweise und CRM-Einträge zum Nachhaken als Termin in den Microsoft-365-Kalender eintragen. Der Termin wird im Kalender des zuständigen Mitarbeiters eingetragen, auch wenn ein anderer Mitarbeiter den Eintrag angelegt hat.

Voraussetzungen:

1. Unter **Einstellungen -> Anbindungen -> Microsoft 365** ist die Checkbox "**Kalender erlauben**" gesetzt <mark style="color:red;">**(1)**</mark>.
2. In den [Grundeinstellungen](https://docs.desk4.de/einstellungen/grundeinstellungen.md#checkboxen-der-grundeinstellungen) ist die Checkbox "**Arbeitsnachweise und CRM-Einträge als Termin im Microsoft-365-Kalender eintragen**" gesetzt. Im Standard ist sie nicht gesetzt.
3. Der zuständige Mitarbeiter hat sein Microsoft-365-Konto verbunden (siehe [Einrichtung](https://docs.desk4.de/faq/microsoft-365-exchange-online-anbindung.md#einrichtung)).

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2Fgk7H0YSp90Y1Rr6lUpgd%2Fmicrosoft-365-kalender-erlauben.png?alt=media&amp;token=a665412b-780f-4f3a-bb88-da6b29c3f0ed" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Wurde "Kalender erlauben" nachträglich gesetzt, muss sich jeder Mitarbeiter einmal über den Button "Microsoft Logout" abmelden und über "Microsoft Login" neu anmelden. Erst dann sind die Rechte für den Kalender erteilt.
{% endhint %}

### Wann wird ein Termin eingetragen?

Der Termin wird bei jedem Speichern eingetragen oder angepasst. Bereits vorhandene Einträge werden erst beim nächsten Speichern übertragen. Änderungen in Outlook werden nicht nach desk4 übernommen.

**Arbeitsnachweis:** Ein Termin wird nur eingetragen, wenn ein **Laufzeitanfang** gepflegt ist. Das Ende des Termins ergibt sich in dieser Reihenfolge:

1. Laufzeitanfang + **geplante Zeit**
2. Laufzeitanfang bis **Laufzeitende**
3. Laufzeitanfang + **Gesamt**

Sind mehrere Arbeitszeiträume erfasst ("Weitere Zeiten"), wird für jeden Zeitraum ein eigener Termin eingetragen.

**CRM-Eintrag:** Ein Termin wird eingetragen, wenn ein Datum zum **Nachhaken** gepflegt ist. Die Länge des Termins wählen Sie im Feld **Dauer**. Im Standard sind es 30 Minuten. Mehr dazu erfahren Sie [hier](https://docs.desk4.de/stammdaten/kunden.md#registerkarte-crm).

Im Betreff steht der Status in eckigen Klammern, z.B. "\[Geplant] Arbeitsnachweis ZE0000019 - Musterfirma GmbH" oder "\[Offen] Nachhaken - Musterfirma GmbH: Rückruf wegen Angebot". Im Text des Termins stehen die Aufgabe bzw. die Beschreibung und der Ansprechpartner.

### Was passiert bei Änderungen?

* **Erledigt:** Der Termin bleibt im Kalender. Im Betreff steht dann "\[Erledigt]".
* **Anderer Mitarbeiter:** Der Termin wird beim bisherigen Mitarbeiter entfernt und beim neuen Mitarbeiter eingetragen.
* **Löschen:** Wird ein Arbeitsnachweis, ein Arbeitszeitraum oder ein CRM-Eintrag gelöscht, wird auch der Termin aus dem Kalender entfernt. Das gilt auch, wenn das Datum zum Nachhaken entfernt wird.

### Mögliche Meldungen

| Meldung                                                                               | Bedeutung                                                                                       |
| ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| "... hat kein Microsoft-365-Konto verbunden. Es wurde kein Kalendereintrag angelegt." | Der zuständige Mitarbeiter muss sein Microsoft-365-Konto verbinden                              |
| "Für den Kalendereintrag fehlt die Berechtigung bei ..."                              | Der zuständige Mitarbeiter muss sich über "Microsoft Logout" und "Microsoft Login" neu anmelden |
| "Der Kalendereintrag für ... konnte nicht in Microsoft 365 geschrieben werden."       | Microsoft war nicht erreichbar. Beim nächsten Speichern wird es erneut versucht                 |

{% hint style="info" %}
Der Arbeitsnachweis bzw. der CRM-Eintrag wird in jedem Fall gespeichert, auch wenn der Termin nicht eingetragen werden konnte.
{% endhint %}

## Problemlösungen

### MailboxNotEnabledForRESTAPI

#### Einwilligung und Berechtigungen | Einstellungen für die Benutzereinwilligung

Einstellungen der User Content sperren die Anbindung weiterer Apps. Achten Sie darauf, dass die Freigaben vom Administrator eingestellt werden müssen. Alternativ kann folgende Einstellungen vorgenommen werden, welche seitens Microsft empfohlen wird.

1. Melden Sie sich als Administrator bei [entra.microsoft.com](https://entra.microsoft.com/) an.
2. Navigieren Sie zu **Entra ID** > **Unternehmens-Apps** > **Einwilligung und Berechtigungen** > **Einstellungen für die Benutzereinwilligung**.
3. Passen Sie die Einstellung nach Bedarf an.&#x20;

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FdBew5MLTdVY97Jj85cJX%2Fuser-consent.png?alt=media&amp;token=61d6a20b-1c2e-4421-a238-be5b97ce5744" alt=""><figcaption></figcaption></figure>
