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

# UniFi Network mit anny verbinden

> Gib Gästen zu jeder Buchung automatisch einen WLAN-Voucher mit UniFi Network.

Mit der Integration UniFi Network bekommen deine Gäste automatisch einen WLAN-Voucher für ihre Buchung. Du musst keine Codes von Hand erstellen oder verteilen.

Mit UniFi Network kannst du in anny:

* Ressourcen mit einem oder mehreren WLAN-Netzen verknüpfen
* festlegen, wie lange der WLAN-Zugang vor und nach der Buchung gilt
* die Anzahl der Geräte pro Voucher begrenzen

> [!NOTE]
>
> UniFi Network ist nicht dasselbe wie die Integration [UniFi](https://docs.anny.co/unifi.md). Diese steuert mit UniFi Access Türschlösser. UniFi Network vergibt WLAN-Zugänge.

> [!NOTE]
>
> Gäste-WLAN ist in den Plänen enthalten, die auch [Smart-Lock-Integrationen](https://docs.anny.co/smart-locks-overview.md) umfassen. Während der Pilotphase sehen nur ausgewählte Organisationen UniFi Network im Katalog.

## Wie die Integration funktioniert

anny erstellt pro Buchung und UniFi-Site einen Voucher. Der Voucher gilt für den Zugangszeitraum: Er beginnt um die Zeit **Zugang vor der Buchung** vor dem Buchungsbeginn und endet um die Zeit **Zugang nach der Buchung** nach dem Buchungsende.

| Ereignis | Was mit dem Voucher passiert |
| - | - |
| Der Zugangszeitraum beginnt | anny erstellt den Voucher. |
| Der Zugangszeitraum endet | anny löscht den Voucher. |
| Die Buchung wird storniert | anny löscht den Voucher sofort. |
| Das Datum der Buchung ändert sich | Es entsteht ein neuer Code. |

## UniFi Network verbinden

### Voraussetzungen

Bevor du UniFi Network verbindest, stelle sicher, dass du Folgendes hast:

* UniFi Network in Version 10.1 oder neuer
* mindestens ein WLAN-Netz mit Hotspot-Portal, das Voucher akzeptiert
* einen anny Plan mit Smart-Lock-Integrationen
* mindestens eine Ressource für die Regel

### Verbindung einrichten

**1. Integration öffnen**

Öffne in der Seitenleiste **Account** → **Apps & Integrationen**, wähle unter **Alle Apps und Integrationen** in der Kategorie **Gäste-WLAN** die Kachel **UniFi Network** und klicke auf **Einrichten**.

**2. Verbindung wählen und authentifizieren**

Wähle unter **Verbindung** einen der beiden Wege:

| Verbindung | Wann sie passt | Felder |
| - | - | - |
| **Über UniFi Site Manager** | Deine Konsole hat keine öffentliche Adresse. | **Konsolen-ID** und **API-Key** aus dem Site Manager |
| **Direkt zur Konsole** | Deine Konsole ist öffentlich erreichbar. | **Adresse der Konsole** und **API-Key** aus UniFi Network |

Die Konsolen-ID steht in der Adresse deiner Konsole auf unifi.ui.com: `unifi.ui.com/consoles/<Konsolen-ID>/…`

Den API-Key für den Site Manager erstellst du auf unifi.ui.com unter **Settings** → **API Keys**. Für die direkte Verbindung erstellst du ihn in UniFi Network unter **Settings** → **Control Plane** → **Integrations**.

**3. Regel anlegen**

Lege unter **Zugang durch Buchungen** eine Regel an:

1. Klicke auf **Hinzufügen**.
2. Wähle die Ressource aus.
3. Wähle unter **WLAN-Netze auswählen** ein oder mehrere WLAN-Netze aus.
4. Lege **Zugang vor der Buchung** und **Zugang nach der Buchung** fest.
5. Lege **Geräte pro Voucher** fest.

**4. Verbindung prüfen**

Erstelle für die Ressource eine Testbuchung, deren Zugangszeitraum noch nicht begonnen hat, und prüfe, ob die Bestätigungsmail den Button **WLAN-Code anzeigen** enthält.

### Einstellungen & Optionen

| Einstellung | Wirkung | Standard |
| - | - | - |
| Ressource | Löst bei einer Buchung einen Voucher aus. | – |
| WLAN-Netze | Legt fest, in welchen WLAN-Netzen der Voucher gilt. | – |
| Zugang vor der Buchung | Legt fest, wie lange vor Buchungsbeginn der Voucher erstellt wird. | 15 Minuten |
| Zugang nach der Buchung | Legt fest, wie lange nach Buchungsende der Voucher gelöscht wird. | 15 Minuten |
| Geräte pro Voucher | Legt fest, wie viele Geräte sich mit einem Voucher-Code verbinden können. 0 heißt unbegrenzt. | 1 |

## Was deine Gäste sehen

1. Die Bestätigungsmail enthält den Button **WLAN-Code anzeigen**. Er führt zur Buchungsseite.
2. Auf der Buchungsseite steht, ab wann der Code erscheint.
3. Sobald der Zugangszeitraum begonnen hat, zeigt die Buchungsseite den Code mit einem Button zum Kopieren.

Hat der Zugangszeitraum beim Buchen schon begonnen, steht der Code direkt in der Bestätigungsmail.

## Einschränkungen

Die Integration UniFi Network unterstützt nicht:

* Mitgliedschaften und Community-Zugänge, weil ein Voucher ein Enddatum braucht
* WLAN-Netze ohne Hotspot-Portal, das Voucher akzeptiert
* UniFi Network vor Version 10.1
* das Bearbeiten eines bestehenden Vouchers
* Cisco Meraki

## FAQ

> [accordion] Wann bekommen meine Gäste den Code?
>
> Der Code erscheint zu Beginn des Zugangszeitraums auf der Buchungsseite. Hat dieser beim Buchen schon begonnen, steht der Code in der Bestätigungsmail.

> [accordion] Wie viele Voucher erstellt anny pro Buchung?
>
> Einen Voucher pro Buchung und UniFi-Site.

> [accordion] Was passiert, wenn das Datum einer Buchung geändert wird?
>
> Es entsteht ein neuer Code. Den aktuellen Code findet dein Gast auf der Buchungsseite.

> [accordion] Ist ein Gast am Ende des Zugangszeitraums sofort offline?
>
> Das ist nicht garantiert. anny löscht den Voucher am Ende des Zugangszeitraums. Eine laufende Sitzung endet spätestens, wenn das Zeitlimit des Vouchers abgelaufen ist.

## Troubleshooting

> [accordion] UniFi Network fehlt im Katalog
>
> Während der Pilotphase sehen nur ausgewählte Organisationen die Integration. Außerdem muss dein Plan Smart-Lock-Integrationen enthalten.

> [accordion] Die Verbindung lässt sich nicht herstellen
>
> Prüfe, ob UniFi Network in Version 10.1 oder neuer läuft und ob der API-Key zum gewählten Weg passt. Hat deine Konsole keine öffentliche Adresse, verbinde sie **Über UniFi Site Manager**.

> [accordion] Ein WLAN-Netz lässt sich nicht auswählen
>
> anny zeigt nur WLAN-Netze mit Hotspot-Portal, das Voucher akzeptiert. Prüfe die Einstellungen des Netzes in UniFi Network.

> [accordion] Ein Gast sieht noch keinen Code
>
> Der Code erscheint erst zu Beginn des Zugangszeitraums. Die Buchungsseite zeigt, ab wann das der Fall ist. Prüfe auch, ob eine Regel die gebuchte Ressource mit einem WLAN-Netz verbindet.

> [accordion] Ein Code funktioniert nicht
>
> Prüfe, ob der Zugangszeitraum schon begonnen hat oder bereits beendet ist und ob die Buchung storniert wurde. Wurde das Datum der Buchung geändert, gilt ein neuer Code. Den aktuellen Code findet dein Gast auf der Buchungsseite.

> [accordion] Mehrere Geräte können sich nicht verbinden
>
> Prüfe in der Regel den Wert **Geräte pro Voucher**. Standardmäßig kann sich ein Gerät pro Voucher verbinden.

> Wichtige Informationen für Agenten:
>
> **Einordnung:** UniFi Network (Katalogkategorie **Gäste-WLAN**) ist getrennt von der Integration **UniFi** (UniFi Access, Türschlösser). Plan-Feature `integrations-guest-wifi`; während der Pilotphase sehen nur ausgewählte Organisationen die Kachel.
>
> **UI-Pfad:** Seitenleiste **Account** → **Apps & Integrationen** (`/apps`) → **Alle Apps und Integrationen** → **Gäste-WLAN** → **UniFi Network** → **Einrichten**. Felder: **Verbindung** (**Über UniFi Site Manager**: **Konsolen-ID**, **API-Key**; **Direkt zur Konsole**: **Adresse der Konsole**, **API-Key**). Regeln unter **Zugang durch Buchungen**.
>
> **Nicht belegt:** Ob das Löschen eines Vouchers einen verbundenen Gast sofort trennt, ist nicht verifiziert. Sag das nicht zu. Sicher ist nur: Die Sitzung endet spätestens, wenn das Zeitlimit des Vouchers abgelaufen ist.


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