> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Exchange Server mit anny verbinden

> Synchronisiere die Raumkalender deines eigenen Exchange Servers über Exchange Web Services (EWS) mit deinen anny Ressourcen.

Mit der Integration **Microsoft Exchange Server** verbindest du anny mit den Raumpostfächern deines eigenen Exchange Servers (Exchange 2016, 2019 oder Subscription Edition). Sie ist für Organisationen gedacht, deren Postfächer nicht in Microsoft 365 liegen, sondern on-premise im eigenen Rechenzentrum. anny spricht dafür über Exchange Web Services (EWS) mit deinem Server.

Mit Exchange Server kannst du in anny:

* Jede Ressource mit einem Raumpostfach koppeln (2-Wege-Synchronisation)
* Termine aus Exchange automatisch als Blocker in anny übernehmen und Doppelbuchungen vermeiden
* Viele Räume auf einmal aus deinen Exchange-Raumlisten importieren und fehlende Ressourcen direkt anlegen lassen

Liegen deine Postfächer in Exchange Online, nutze stattdessen [Microsoft 365](https://docs.anny.co/m365-workspace.md). Einen Vergleich aller Kalender-Integrationen findest du unter [Kalenderintegrationen](https://docs.anny.co/calendar-integrations.md).

## Wie die Exchange-Server-Verbindung funktioniert

Die Verbindung läuft über ein Dienstkonto in deinem Active Directory. Das Konto braucht entweder die Rolle **ApplicationImpersonation** für die Raumpostfächer oder Vollzugriff auf jedes Raumpostfach. anny verbindet sich von außen über HTTPS (Port 443) mit dem EWS-Endpunkt deines Servers; eingehende Verbindungen von deinem Server zu anny sind nicht nötig.

| Daten | Richtung | Häufigkeit |
| :- | :- | :- |
| Buchungen werden als Termine im Raumkalender angelegt, aktualisiert und entfernt | anny → Exchange | Bei jeder Änderung |
| Termine aus dem Raumkalender werden als Blocker übernommen, aktualisiert und entfernt | Exchange → anny | Meist innerhalb weniger Sekunden |
| Räume aus deinen Raumlisten (Name und Adresse) für die Auswahl und den Import | Exchange → anny | Beim Öffnen der Einstellungen |

anny schreibt die Termine ohne Einladungen oder Absagen an Teilnehmer:innen in den Raumkalender und trägt sie als „beschäftigt" ein. Änderungen in den Raumkalendern meldet Exchange über eine dauerhafte Verbindung; zusätzlich gleicht anny alle verbundenen Räume regelmäßig ab, damit keine Änderung verloren geht.

## Exchange Server verbinden

### Voraussetzungen

Bevor du Exchange Server verbindest, stelle sicher, dass du Folgendes hast:

* Das Feature **Kalendersynchronisation** in deinem Plan. Ohne das Feature erscheint die Integration nicht unter **Account › Apps & Integrationen**.
* Admin-Rechte in deinem anny Account
* Exchange Server 2016, 2019 oder Subscription Edition mit Raumpostfächern für deine Räume
* Ein Dienstkonto mit der Rolle ApplicationImpersonation für die Raumpostfächer oder mit Vollzugriff auf jedes Raumpostfach
* Einen EWS-Endpunkt, der über HTTPS aus dem Internet ohne Vorab-Anmeldung erreichbar ist
* Eine Firewall-Freigabe für die Adressen von anny (siehe unten)

### Firewall freigeben

anny verbindet sich von festen IP-Adressen mit deinem Exchange. Erlaube in deiner Firewall eingehende Verbindungen von diesen Adressen auf Port 443 zu deinem EWS-Endpunkt:

| anny Umgebung | IP-Adressen |
| :- | :- |
| anny.co | `35.198.173.81`, `34.40.77.178` |

Die Adressen für deine Umgebung zeigt dir auch die Einrichtung im Feld **Firewall** an. Steht dort keine Adresse, nennt dir unser Support die Adressen für deine Umgebung.

### Verbindung einrichten

**1. Integration erstellen**

Öffne in der Seitenleiste **Account › Apps & Integrationen**, wähle unter **Alle Apps und Integrationen** **Microsoft Exchange Server** aus und klicke auf **Einrichten**.

**2. Dienstkonto eintragen**

Fülle die Felder aus:

| Feld | Eingabe |
| :- | :- |
| **EWS-URL** | Die Adresse deines EWS-Endpunkts, meist `https://mail.deine-domain.de/EWS/Exchange.asmx`. Es wird nur HTTPS unterstützt. |
| **Benutzername** | `DOMÄNE\benutzer` oder der Benutzerprinzipalname (UPN) des Dienstkontos |
| **Passwort** | Das Passwort des Dienstkontos |
| **Testpostfach** | Ein Raumpostfach, auf das das Dienstkonto zugreifen darf |
| **Anmeldung** | **NTLM (empfohlen)** oder **Basic über HTTPS** |
| **Zugriff auf die Räume** | **ApplicationImpersonation (empfohlen)** oder **Vollzugriff auf jedes Raumpostfach** |
| **CA-Zertifikat (optional)** | Nur nötig, wenn das Zertifikat deines Servers von einer internen CA stammt: das CA-Zertifikat im PEM-Format |

**3. Verbinden und prüfen**

Klicke auf **Verbinden und prüfen**. anny meldet sich mit dem Dienstkonto an und öffnet das Testpostfach. Erst wenn Exchange das Konto akzeptiert, speichert anny die Zugangsdaten. Schlägt die Prüfung fehl, zeigt anny den Grund an (siehe Troubleshooting).

**4. Räume verbinden**

Verbinde im Bereich **Räume** jede Ressource mit einem Raumpostfach: einzeln über **Hinzufügen** oder viele auf einmal über **Räume importieren** (siehe nächster Abschnitt).

Beim einzelnen Verbinden wählst du unter **Ressource auswählen** die anny Ressource und unter **Raum aus deinen Raumlisten** den Raum. Hat deine Organisation keine Raumlisten, trägst du die **Adresse des Raumpostfachs** direkt ein. Klicke auf **Bestätigen**.

**5. Aktivieren**

Aktiviere die Integration über den **Toggle** im Seitenkopf. anny gleicht danach alle zukünftigen Termine und Buchungen der verbundenen Räume ab.

### Räume importieren

Mit **Räume importieren** verbindest du viele Räume aus deinen Exchange-Raumlisten auf einmal, auch mehrere hundert.

**1. Raumliste wählen**

Klicke im Bereich **Räume** auf **Räume importieren** und wähle unter **Raumliste** eine einzelne Liste oder **Alle Raumlisten**.

**2. Fehlende Ressourcen anlegen**

Lass **Fehlende Ressourcen anlegen** eingeschaltet, wenn anny für Räume ohne passende Ressource neue Ressourcen anlegen soll. Schaltest du die Option aus, überspringt anny diese Räume.

**3. Vorschau prüfen**

Klicke auf **Vorschau**. anny zeigt, wie viele Räume es **Mit vorhandener Ressource verbinden**, für wie viele es eine **Neue Ressource anlegen** würde, welche **Schon verbunden** sind und welche **Übersprungen, keine passende Ressource** werden.

**4. Importieren**

Klicke auf **Importieren**. anny verbindet die Räume in Paketen und zeigt den Fortschritt an. Ist die Integration bereits aktiv, startet die Synchronisation für die neuen Räume sofort.

So ordnet anny die Räume zu:

* Passt der Name eines Raums genau zu einer Ressource, verbindet anny ihn mit ihr. Groß- und Kleinschreibung spielt keine Rolle. Gibt es mehrere Ressourcen mit diesem Namen, legt anny lieber eine neue Ressource an, statt falsch zu verbinden.
* Archivierte Ressourcen, Unterressourcen und Ressourcen, die schon mit einem Raum verbunden sind, werden nicht verknüpft.
* Neue Ressourcen sind noch nicht live. Sie übernehmen Standort und Zeitzone deiner Organisation und landen in deiner ersten Kategorie. Prüfe sie und schalte sie live, wenn sie fertig eingerichtet sind.
* Schon verbundene Räume bleiben, wie sie sind. Ein zweiter Import ergänzt nur neue Räume.

> [!NOTE]
>
> Neue Ressourcen zählen wie im Admin angelegte Ressourcen gegen deinen Plan. Erlaubt dein Plan nicht so viele neue Ressourcen, zeigt die Vorschau einen Hinweis und der Import startet nicht. Schalte dann **Fehlende Ressourcen anlegen** aus oder wähle eine kleinere Raumliste.

## Einschränkungen

Die Exchange-Server-Integration unterstützt nicht:

* **Exchange Online:** Für Postfächer in Microsoft 365 nutzt du die Integration [Microsoft 365](https://docs.anny.co/m365-workspace.md).
* **Personenkalender:** Verbunden werden Raumpostfächer, keine persönlichen Postfächer von Mitarbeiter:innen.
* **Termine als Buchungen:** Termine aus Exchange werden immer als Blocker übernommen.
* **Verschachtelte Raumlisten:** Räume aus Raumlisten innerhalb einer Raumliste erscheinen nicht in der Auswahl und im Import. Du kannst sie über die Adresse des Raumpostfachs einzeln verbinden.
* **Zugriff ohne Firewall-Freigabe:** anny muss deinen EWS-Endpunkt direkt aus dem Internet erreichen. Eine vorgeschaltete Anmeldeseite, etwa über einen Reverse-Proxy mit Vorab-Authentifizierung, verhindert die Verbindung.

## FAQ

> [accordion] Bekommen Teilnehmer:innen Einladungen aus Exchange?
>
> Nein. anny legt die Termine direkt im Raumkalender an, aktualisiert und entfernt sie, ohne Einladungen oder Absagen zu verschicken.

> [accordion] Wie schnell werden Änderungen synchronisiert?
>
> Buchungsänderungen aus anny werden sofort übertragen. Änderungen im Raumkalender meldet Exchange meist innerhalb weniger Sekunden. Zusätzlich gleicht anny alle verbundenen Räume regelmäßig ab.

> [accordion] Muss mein Exchange Server Verbindungen zu anny aufbauen?
>
> Nein. Nur anny verbindet sich mit deinem Server, über HTTPS auf Port 443. Du musst lediglich die IP-Adressen von anny in deiner Firewall freigeben.

> [accordion] Welche Anmeldung soll ich wählen?
>
> Wir empfehlen **NTLM**. anny unterstützt dabei auch Server, auf denen Extended Protection aktiviert ist. **Basic über HTTPS** funktioniert nur, wenn Basic-Authentifizierung für EWS auf deinem Server erlaubt ist.

## Troubleshooting

> [accordion] „Exchange Server nicht erreichbar“
>
> anny erreicht die Exchange Web Services unter der eingetragenen Adresse nicht. Prüfe die EWS-URL, ob der Endpunkt ohne Vorab-Anmeldung aus dem Internet erreichbar ist und ob die IP-Adressen von anny in deiner Firewall freigegeben sind. Eine Firewall, die die Verbindung verwirft, ist die häufigste Ursache.

> [accordion] „Authentifizierung fehlgeschlagen“
>
> Exchange hat das Dienstkonto abgelehnt. Prüfe den Benutzernamen (`DOMÄNE\benutzer` oder UPN), das Passwort und die gewählte **Anmeldung**.

> [accordion] „Postfach nicht erreichbar“
>
> Das Dienstkonto kann das Testpostfach nicht öffnen. Prüfe die Adresse des Testpostfachs und ob das Konto die Rolle ApplicationImpersonation oder Vollzugriff auf das Postfach hat.

> [accordion] Ein Raum zeigt „Raumpostfach nicht erreichbar“
>
> Das Dienstkonto darf auf dieses Raumpostfach nicht zugreifen, oder die Adresse stimmt nicht. Prüfe den Zugriff des Dienstkontos auf das Postfach und die Adresse des Raumpostfachs.

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Integration „Microsoft Exchange Server" für Exchange on-premise (2016, 2019, Subscription Edition) über EWS. NICHT gemeint: „Microsoft 365" (Exchange Online, Graph), persönliche Outlook-Integration, Outlook-Add-In. Nur Raumpostfächer, eine Ressource pro Raumpostfach.
>
> **Gating:** Plan-Feature Kalendersynchronisation (wie Microsoft 365). Zusätzlich muss die Integration in der anny Umgebung freigeschaltet sein; sonst fehlt sie im Katalog. Einrichtung nur durch Admins mit Bearbeitungsrecht für die Integration. Zugangsdaten lassen sich nur eintragen, solange die Integration deaktiviert ist.
>
> **UI-Pfade:** Seitenleiste **Account › Apps & Integrationen** (`/apps`) → „Alle Apps und Integrationen" → **Microsoft Exchange Server** → „Einrichten". Authentifizierung: Box „Firewall" (zeigt die IP-Adressen der Umgebung, sonst „Die Adressen für diese Umgebung nennt dir unser Support."), Felder „EWS-URL", „Benutzername", „Passwort", „Testpostfach", Auswahl „Anmeldung" („NTLM (empfohlen)" / „Basic über HTTPS"), „Zugriff auf die Räume" („ApplicationImpersonation (empfohlen)" / „Vollzugriff auf jedes Raumpostfach"), „CA-Zertifikat (optional)", Button „Verbinden und prüfen" (alle Felder außer CA-Zertifikat Pflicht; EWS-URL nur https). Regeln: Bereich „Räume" mit Buttons „Räume importieren" und „Hinzufügen"; Tabelle mit Spalten „Ressource" und „Exchange-Raum"; Modal „Raum verbinden"/„Raum bearbeiten" mit „Ressource auswählen", „Raum aus deinen Raumlisten" (nur wenn Raumlisten existieren), „Adresse des Raumpostfachs". Import-Modal „Räume aus Exchange importieren": „Raumliste" („Alle Raumlisten ({Anzahl})"), Toggle „Fehlende Ressourcen anlegen", Buttons „Vorschau" → „Importieren ({Anzahl})". Ergebnisse: „Mit vorhandener Ressource verbinden", „Neue Ressource anlegen", „Schon verbunden", „Übersprungen, keine passende Ressource".
>
> **Quirks:** (1) Regeln sind immer Blocker ohne Buchungsoptionen-Filter und ohne Vor-/Nachbereitungszeit; Termine in Exchange ohne Einladungen/Absagen, Status „beschäftigt". (2) Änderungen aus Exchange per Streaming-Benachrichtigung (typisch wenige Sekunden), regelmäßiger Abgleich aller Räume als Sicherheitsnetz. (3) Raumliste: alle Räume einer Liste (auch über 100), verschachtelte Listen werden übersprungen. (4) Import: Namensabgleich exakt, ohne Groß-/Kleinschreibung und mit zusammengefassten Leerzeichen, nur gegen Hauptressourcen, die nicht archiviert und noch nicht verbunden sind; mehrdeutiger Name → neue Ressource. Neue Ressourcen: nicht live, Kapazität 1, Standort/Zeitzone/Community-Einstellungen der Organisation, erste Kategorie. Vorschau bis 5000 Räume in einer Anfrage, Import in Paketen zu 100 (alles oder nichts pro Paket); bricht ein späteres Paket ab, bleiben die früheren gespeichert. Ressourcen-Limit wie beim Anlegen im Admin (Plan muss Ressourcen enthalten, Sitzplatz-Regeln). Bei aktiver Integration starten neue Regeln sofort ihren ersten Sync. (5) Verbindungsaufbau zu Exchange bricht nach 5 Sekunden ab, damit eine blockierende Firewall schnell als „Exchange Server nicht erreichbar" gemeldet wird; die Prüfung im Admin wartet bis 45 Sekunden. (6) Fehlermeldungen beim Verbinden: „Authentifizierung fehlgeschlagen", „Postfach nicht erreichbar", „Exchange Server nicht erreichbar". Zugangsdaten werden nur gespeichert, wenn die Prüfung am Testpostfach erfolgreich war. (7) Der anny AI Admin-Agent kann Räume ebenfalls importieren (`organizations.import-exchange-rooms`, erst Probelauf, höchstens 500 Räume pro Lauf, sonst Raumliste für Raumliste); das Dienstkonto verbinden geht nur im Admin. Hat eine Organisation mehrere Exchange-Server-Integrationen, muss der Agent eine benennen.
>
> **Beziehungen:** Gleiche Regel-, Blocker- und Lösch-Logik wie „Microsoft 365" (`/m365-workspace`), aber EWS statt Graph und Streaming statt Webhooks. Übersicht: `/calendar-integrations`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.