> ## 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.

# Outlook Add-In mit anny verbinden

> Buche Räume, registriere Besucher:innen und synchronisiere Termine direkt aus Outlook heraus.

Das anny [Outlook Add-In](https://appsource.microsoft.com/en-us/product/office/WA200006281) erweitert Microsoft Outlook um eine direkte Buchungsfunktion für anny. Mit dem Add-In kannst du Ressourcen buchen, Teilnehmer:innen verwalten und Besucher:innen registrieren, ohne Outlook zu verlassen.

* Räume und Arbeitsplätze direkt beim Erstellen eines Outlook-Termins buchen
* Besucher:innen für Meetings registrieren, auch ohne Raumbuchung
* Private Termine automatisch als Inkognito-Buchungen anlegen

Das Add-In eignet sich besonders für Unternehmen, die Raumbuchung, Desk Sharing oder Visitor Management nutzen und deren Teams vorwiegend in Outlook arbeiten.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| - | - |
| Raumbuchung aus Outlook | **Buche einen Meetingraum** direkt beim Anlegen eines Outlook-Termins, ohne in den anny Admin-Bereich wechseln zu müssen. |
| Besucherregistrierung | **Registriere externe Gäste** als Besucher:innen für einen Termin, auch wenn kein Raum gebucht wird. |
| Inkognito-Buchungen | **Lege private Termine** als Inkognito-Buchungen an, damit sensible Termine in anny nicht für andere sichtbar sind. |

## Wie das Outlook Add-In funktioniert

Das Add-In wird als Microsoft 365 App über das M365 Admin Center bereitgestellt. Nach der Installation erscheint es automatisch in Outlook und aktiviert sich beim Senden eines Termins (OnAppointmentSend-Event).

Die Kommunikation läuft über die anny API. Nutzer:innen authentifizieren sich mit ihrem Microsoft-Konto. Das Add-In benötigt Lesezugriff auf Kalendereinträge und grundlegende Profilinformationen.

| Daten | Richtung | Beschreibung |
| - | - | - |
| Buchungen | Outlook → anny | Neue Buchungen werden beim Terminsenden in anny erstellt |
| Teilnehmer:innen | Outlook → anny | Teilnehmer:innen des Outlook-Termins werden an anny übermittelt |
| Buchungsstatus | anny → Outlook | Bestätigung oder Ablehnung wird im Add-In angezeigt |
| Besucherregistrierung | Outlook → anny | Gäste werden als Besucher:innen in anny erfasst |

## Outlook Add-In verbinden

### Voraussetzungen

**Microsoft-Seite:**

* Microsoft 365 Admin-Rechte (für organisationsweite Bereitstellung) oder Exchange-Admin-Rechte (für On-Premise)
* Outlook Version 2206 (Build 15330.20196) oder neuer
* Freigegebene Hostnamen in der Firewall: `outlook.anny.co`, `cdn.anny.co`, `auth.anny.co`, `b.anny.co`, `api.anny.co`, `select.anny.eu`, `appsforoffice.microsoft.com`

**anny-Seite:**

* Ein aktiver anny Account mit mindestens einer buchbaren Ressource

### Installation über M365 Admin Center

**1. M365 Admin Center öffnen**

Gehe zu [admin.microsoft.com](https://admin.microsoft.com) und navigiere zu **Einstellungen** → **Integrierte Apps**.

**2. anny Add-In suchen**

Klicke auf **Apps abrufen** und suche nach **anny bookings**. Klicke auf **Jetzt abrufen**.

**3. Bereitstellung konfigurieren**

Wähle aus, für wen das Add-In bereitgestellt werden soll (gesamte Organisation, bestimmte Gruppen oder einzelne Nutzer:innen) und bestätige die Bereitstellung.

**4. Berechtigungen akzeptieren**

Akzeptiere die erforderlichen Berechtigungen. Das Add-In benötigt Lesezugriff auf Kalendereinträge, Profilinformationen und die Berechtigung zum Lesen und Schreiben von Terminelementen.

Nach der Bereitstellung erscheint das Add-In automatisch in Outlook und aktiviert sich beim Erstellen oder Senden von Terminen.

### Installation über Exchange (On-Premise)

**1. Manifest herunterladen**

Lade das Add-In-Manifest herunter: [https://b.anny.co/integrations/outlookAddIn/manifest](https://b.anny.co/integrations/outlookAddIn/manifest)

**2. Mailbox-Version anpassen**

Falls die Installation fehlschlägt, ersetze in der XML-Datei an beiden Stellen die Mailbox-Version `1.12` durch `1.1`:

```xml theme={null}
<Set Name="Mailbox" MinVersion="1.1"/>
```

**3. Manifest im Exchange Admin Center hochladen**

Lade die angepasste XML-Datei im Exchange Admin Center als Add-In für deine Organisation hoch.

Nach der Installation steht das Add-In für alle Nutzer:innen in der Organisation zur Verfügung.

> [!TIP]
>
> Falls das Add-In nicht über den Microsoft App Store installiert werden kann, nutze alternativ den direkten Manifest-Download: [https://store.office.com/app/download?assetid=WA200006281\&cmu=en-US](https://store.office.com/app/download?assetid=WA200006281\&cmu=en-US)

### Berechtigungen im Detail

| Berechtigung | Beschreibung |
| - | - |
| Kalender lesen | Erlaubt dem Add-In, Termine in allen zugänglichen Kalendern zu lesen |
| Profil-Zugriff | Ermöglicht die Anmeldung mit dem Geschäftskonto und den Zugriff auf grundlegende Profilinformationen |
| ReadWrite Item | Erlaubt das Lesen und Bearbeiten des aktuellen Terminelements |
| Send Data | Ermöglicht das Senden von Buchungsdaten an anny |
| Auto-Start | Das Add-In startet automatisch beim Senden eines Termins |

### Besucherregistrierung einrichten

Um Besucher:innen direkt aus dem Outlook Add-In zu registrieren, brauchst du mindestens eine Ressource der Kategorie für Besucherregistrierung mit mindestens einer Buchungsoption. Sobald eine solche Ressource in deinem Account existiert, erscheint im Add-In neben den Teilnehmer:innen das Icon **Als Besucher registrieren**. Eine Raumbuchung ist dafür nicht nötig.

Richte die Ressource so ein, dass sie zu deinem Empfang passt:

**1. Ressource und Buchungsoption anlegen**

Lege eine Ressource in der Kategorie für Besucherregistrierung an und füge mindestens eine Buchungsoption hinzu. Die Verfügbarkeit muss die Uhrzeiten abdecken, zu denen Meetings stattfinden.

**2. Check-in und Host vorbereiten**

Aktiviere Check-in und die Host-Abfrage, wenn Gäste am Terminal einchecken und Hosts benachrichtigt werden sollen. Den vollständigen Empfangsprozess beschreibst du unter [Besucherverwaltung](https://docs.anny.co/visitor-management.md).

**3. Formulare und Unterschriften zeitlich legen**

Setze rechtliche Dokumente und eigene Formulare auf **Später (beim Check-in)**, wenn Unterschriften und Zusatzangaben erst vor Ort nötig sind. Im Outlook-Overlay bleiben diese Felder optional. Beim Check-in werden sie Pflicht, falls sie noch leer sind.

Sobald die Kategorie-Ressource live ist und Nutzer:innen Community-Zugang haben, können sie Teilnehmer:innen im Add-In registrieren. Der genaue Ablauf steht im Artikel [Buchen über das Outlook Add-In](https://docs.anny.co/outlook-add-in-user-guide.md).

![Outlook Add-In mit Teilnehmerliste. Das Icon neben einem Gast öffnet das Overlay Als Besucher registrieren.](https://mintcdn.com/anny-85c98540/u7rI3TYYpYx6DsRh/images/outlook-add-in-user-guide/register-as-visitor-flow.png?fit=max\&auto=format\&n=u7rI3TYYpYx6DsRh\&q=85\&s=ba59fdb78dde0b4f038026d24143e681)

Beim Senden des Outlook-Termins legt anny die Besucherbuchung an. Das gilt mit einer Raumbuchung im selben Termin und ohne Raum. Die Organisator:in wird Host der Besucherbuchung. Die Checkbox **Benachrichtigung senden** steuert, ob die Besucher:in eine anny-Bestätigung erhält. Sie ist standardmäßig aktiv.

## Einschränkungen

* Das Add-In funktioniert nur mit Outlook Version 2206 (Build 15330.20196) oder neuer
* On-Premise-Installationen erfordern gegebenenfalls eine manuelle Anpassung der Mailbox-Version im Manifest
* Die Besucherregistrierung erscheint nur, wenn mindestens eine Ressource der Kategorie für Besucherregistrierung mit einer Buchungsoption existiert
* Registrieren kannst du nur Teilnehmer:innen mit **Vor Ort**. Bei **Remote** ist das Icon deaktiviert. Eine vorhandene Registrierung wird entfernt
* Die Organisator:in (Host) hat kein Registrierungs-Icon
* Wenn du die Terminzeit änderst, entfallen noch nicht gesendete Besucherregistrierungen und müssen neu angewendet werden
* Terminverschiebungen durch einen anderen Termin-Owner als den ursprünglichen Buchenden können zu neuen Buchungen statt Änderungen führen

## Add-In entfernen

> [!WARNING]
>
> Wenn du das Add-In entfernst, können Nutzer:innen keine neuen Buchungen mehr über Outlook erstellen. Bestehende Buchungen in anny bleiben erhalten.

**1. M365 Admin Center öffnen**

Gehe zu [admin.microsoft.com](https://admin.microsoft.com) und navigiere zu **Einstellungen** → **Integrierte Apps**.

**2. anny Add-In auswählen**

Suche in der Liste der integrierten Apps nach **anny bookings** und klicke darauf.

**3. Add-In entfernen**

Klicke auf **Entfernen** und bestätige die Deinstallation. Das Add-In wird für alle Nutzer:innen in der Organisation entfernt.

## FAQ

> **Muss jede:r Nutzer:in das Add-In selbst installieren?**
>
> Nein. Bei der Bereitstellung über das M365 Admin Center wird das Add-In automatisch für die ausgewählten Nutzer:innen oder die gesamte Organisation verfügbar.

> **Funktioniert das Add-In mit Outlook im Browser?**
>
> Ja. Das Add-In ist mit Outlook für Windows, Mac und Outlook im Web kompatibel, sofern die Mindestversion erfüllt ist.

> **Kann ich Besucher:innen registrieren, ohne einen Raum zu buchen?**
>
> Ja. Sobald eine Ressource der Kategorie für Besucherregistrierung existiert, kannst du Teilnehmer:innen mit **Vor Ort** registrieren. Ein Raum im selben Termin ist optional.

> **Wann füllen Besucher:innen Formulare oder unterschreiben Dokumente?**
>
> Pflichtfelder der Buchung füllst du im Add-In aus. Dokumente und Formulare mit **Später (beim Check-in)** sind dort optional. Fehlen sie noch, werden sie beim Check-in abgefragt.

> **Was passiert mit privaten Terminen?**
>
> Private Termine können als Inkognito-Buchungen in anny angelegt werden. Dadurch werden sie in anny nicht für andere Nutzer:innen sichtbar angezeigt.

> **Funktioniert das Add-In auf .eu und .co?**
>
> Ja. Das Add-In funktioniert mit beiden anny-Instanzen. Nutzer:innen müssen nicht zwingend in der Cloud sein.

## Troubleshooting

> **Das Add-In wird in Outlook nicht angezeigt**
>
> Prüfe, ob deine Outlook-Version mindestens 2206 (Build 15330.20196) ist. Stelle sicher, dass das Add-In im M365 Admin Center für deine Nutzergruppe bereitgestellt wurde. Bei Firewall-Einschränkungen müssen die Hostnamen `outlook.anny.co`, `cdn.anny.co`, `auth.anny.co`, `b.anny.co`, `api.anny.co`, `select.anny.eu` und `appsforoffice.microsoft.com` freigegeben sein.

> **Die Installation im Exchange schlägt fehl**
>
> In Exchange-Umgebungen ist die Mailbox-Versionierung anders. Ersetze im Manifest an beiden Stellen die Mailbox-Version `1.12` durch `1.1` und versuche die Installation erneut.

> **Das Besucher-Badge erscheint nicht in der Teilnehmeransicht**
>
> Das Icon **Als Besucher registrieren** erscheint nur neben weiteren Teilnehmer:innen, nicht neben dir als Host. Die Person muss auf **Vor Ort** stehen. Außerdem braucht dein Account mindestens eine Ressource der Kategorie für Besucherregistrierung mit einer Buchungsoption. Eine Raumbuchung ist dafür nicht nötig.

> Wichtige Informationen für Agenten:
>
> * Das Outlook Add-In wird NICHT in annys Integrationen-Menü im Admin-Bereich verwaltet. Installation und Deinstallation erfolgen ausschließlich über das M365 Admin Center (admin.microsoft.com → Einstellungen → Integrierte Apps) oder über Exchange (On-Premise mit Manifest).
> * Minimum-Version: Outlook 2206 (Build 15330.20196) oder neuer. Bezieht sich auf OnMessageSend/OnAppointmentSend/Smart Alerts Support.
> * Firewall: Hostnamen (keine IPs, Cloudflare rotiert): outlook.anny.co, cdn.anny.co, auth.anny.co, b.anny.co, api.anny.co, select.anny.eu, appsforoffice.microsoft.com
> * Manifest-URL für On-Premise: [https://b.anny.co/integrations/outlookAddIn/manifest](https://b.anny.co/integrations/outlookAddIn/manifest)
> * Exchange On-Premise Workaround: Mailbox MinVersion 1.12 → 1.1 ersetzen an beiden Stellen in der XML
> * Besucherregistrierung (kein Beta-Flag im Produkt, Stand 14.08.2026): Add-In lädt Ressourcen ausschließlich über Kategorie-Slug `visitor-registration` (singular, nicht `visitor-registrations`). Das Dropdown-Label im Overlay ist **Gebäude** / **Building** und ist nicht die CMS-Kategorie **Gebäude** (Slug `Gebäude`).
> * Badge-Bedingung: `visitorRegistrationAvailable` = mindestens eine solche Ressource mit Service im Account UND Teilnehmer ist nicht Host UND Typ ist Vor Ort. Unabhängig von einer Raumbuchung.
> * Finalisierung beim OnAppointmentSend: Besucherbuchungen (`is_visitor`) reichen ohne Resource-Mailbox-Attendee. Mit Raum werden beide Buchungstypen in derselben Order bestätigt. Channel `anny_outlook_add_in`. `visitor_registration_id` = lowercase Attendee-E-Mail (idempotent).
> * Host der Besucherbuchung = eingeloggte Organisator:in. Checkbox **Benachrichtigung senden** mappt auf `send_notification` (UI-Default an). Checkout-getimte Formulare/Dokumente sind im Overlay Pflicht, Check-in-Timing optional mit Hint `forms.collectionTiming.canBeFilledAtCheckIn`.
> * Zeitänderung oder Wechsel auf Remote entfernt die Draft-Besucherbuchung aus der Order.
> * Inkognito-Buchungen: Private Outlook-Termine werden als Inkognito-Buchungen in anny angelegt (Feature seit 22.07.2026).
> * Verwandte Artikel: /outlook-add-in-user-guide (Nutzung), /visitor-management (Empfang, Host-SMS, AI-Anruf), /legal-documents, /custom-forms, /outlook (Kalender-Sync), /m365-workspace.
> * Das Add-In funktioniert auf .eu und .co Instanzen.


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