> ## 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. # Shelly mit anny verbinden > Schalte Geräte wie Beleuchtung automatisch per Buchungsereignis ein und aus. [Shelly](https://www.shelly.com) ist ein Hersteller kompakter, WLAN-fähiger Schaltrelais (Switches), die direkt in der Stromleitung vor einem Gerät oder hinter einem Lichtschalter verbaut werden. Mit der Integration steuert anny deine Shelly-Schalter automatisch basierend auf Buchungsereignissen. Mit Shelly kannst du in anny: * Geräte wie Beleuchtung oder Lüftung automatisch ein- und ausschalten, wenn eine Buchung beginnt oder endet * Schaltbefehle an den Check-In oder Check-Out einer Buchung koppeln * Jede Ressource mit einem eigenen Shelly-Schalter verknüpfen und über Regeln individuell steuern Besonders praktisch ist die Integration, wenn du Räume oder Plätze betreibst, deren Ausstattung nur während aktiver Buchungen laufen soll, z. B. Sportplatz-Beleuchtung, Studio-Technik oder Meetingraum-Displays. Verfügbar ab dem Professional-Plan. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | :------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Platzbeleuchtung im Sportzentrum | **Licht geht automatisch an, sobald Spieler:innen einchecken.** Nach der Buchung schaltet es sich wieder aus. Kein manuelles Eingreifen und kein unnötiger Stromverbrauch zwischen Buchungen. | | Meetingraum-Ausstattung | **Displays und Lüftung starten mit Buchungsbeginn.** Geräte laufen nur, wenn der Raum tatsächlich gebucht ist, und schalten sich am Ende automatisch ab. | | Außenbereiche und Flutlicht | **Flutlicht für Padel-Courts oder Tennisplätze wird per Check-In aktiviert.** Betreiber:innen sparen Energiekosten, weil die Beleuchtung exakt an die Buchungszeit gekoppelt ist. | ## Wie die Shelly-Verbindung funktioniert Die Verbindung wird über den API-Schlüssel deines Shelly-Kontos hergestellt. Du gibst in anny die Shelly URL und den API-Schlüssel ein. anny authentifiziert sich damit bei Shelly und kann anschließend Schaltbefehle an deine registrierten Geräte senden. Der Ablauf einer Schaltaktion: 1. Ein Buchungsereignis tritt ein (z. B. Buchung ist eingecheckt). Nur **bestätigte** Buchungen lösen Schaltaktionen aus. Angefragte, abgelehnte oder stornierte Buchungen lösen keine Schaltaktionen aus. 2. anny prüft, ob eine Regel für die betroffene Ressource und das Ereignis existiert und ob die Regel laut ihrem aktiven Zeitplan gerade gilt. 3. Trifft eine Regel zu, sendet anny den Befehl (Ein- oder Ausschalten) an den zugeordneten Shelly-Schalter. 4. Die Aktion wird im Aktivitätsprotokoll der Buchung dokumentiert. Schaltbefehle werden mit kurzem Abstand nacheinander gesendet. Wenn viele Regeln gleichzeitig feuern (z. B. mehrere Buchungen starten zur vollen Stunde), können sich einzelne Schaltungen um wenige Sekunden verzögern. ## Shelly verbinden ### Voraussetzungen Bevor du Shelly verbindest, stelle sicher, dass du Folgendes hast: * Ein Shelly-Konto mit registrierten Geräten und Zugriff auf den API-Schlüssel * WLAN-fähige Shelly-Schalter, die im Netzwerk erreichbar sind (Empfehlung: [Shelly 1 Gen3](https://www.shelly.com/products/shelly-1-gen3)) * Für jeden schaltbaren Bereich ist klar, welcher Shelly-Schalter zuständig ist (Empfehlung: 1 Ressource = 1 Schalter; mehrere Ressourcen können sich aber auch einen Schalter teilen) * Admin-Rechte in deinem anny Account ### Verbindung einrichten Öffne aus der Menüleiste die **Integrationen** und gehe zu **Shelly**. Trage die **Shelly URL** ein (mit `https://` am Anfang) und füge den **API-Schlüssel** aus deinem Shelly-Konto ein. Klicke auf **Authentifizierung überprüfen**, bis die Verbindung als erfolgreich angezeigt wird. Lege Regeln an, um Buchungsereignisse mit Schaltaktionen zu verknüpfen: 1. Klicke auf **Hinzufügen**. 2. Wähle die **Ressource** (z. B. Court 6). 3. Lege das **Buchungs-Ereignis** als Auslöser fest (z. B. „Buchung ist eingecheckt“). 4. Wähle den **Shelly-Schalter**, der zu dieser Ressource gehört. 5. Wähle unter **Zustand ändern zu** die Aktion (z. B. „Eingeschaltet“). 6. Optional: Begrenze die Regel über den **Aktivitäts-Modus** auf ein tägliches Zeitfenster (z. B. Flutlicht nur außerhalb von 08:00–18:00 einschalten). 7. Speichere die Regel. 8. Erstelle für die Gegenaktion eine zweite Regel (z. B. „Buchung ist ausgecheckt“ → „Ausgeschaltet“). 9. Aktiviere die gesamte Integration über den **Toggle**, damit die Regeln live ausgeführt werden. Sobald die Integration aktiv ist, werden Schaltbefehle bei jedem passenden Buchungsereignis automatisch an deine Shelly-Geräte gesendet. Teste die Integration mit einer Testbuchung: Lege eine Buchung an, löse den Auslöser aus (z. B. Einchecken) und prüfe, ob der Schalter reagiert. Im Aktivitätsprotokoll der Buchung siehst du, welche Aktionen ausgeführt oder übersprungen wurden. ### Einstellungen & Optionen | Einstellung | Beschreibung | | :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Buchungs-Ereignis | Bestimmt, welches Buchungsereignis die Regel auslöst: **Buchung beginnt**, **Buchung endet**, **Buchung ist eingecheckt**, **Buchung ist ausgecheckt**. | | Zustand ändern zu | Der Befehl an den Shelly-Schalter: **Eingeschaltet** oder **Ausgeschaltet**. | | Ressource | Die Ressource, für die die Regel gilt. Jede Regel ist an genau eine Ressource gebunden. Eine Regel auf einer übergeordneten Ressource greift auch bei Buchungen ihrer Unterressourcen. | | Shelly-Schalter | Das Zielgerät, das den Befehl empfängt. Pro Regel wird ein Schalter zugeordnet. | | Aktiver Zeitplan | Begrenzt die Regel auf ein tägliches Zeitfenster: **Immer aktiv**, **Innerhalb der Start- und Endzeit** oder **Außerhalb der Start- und Endzeit** (Zeiten in 5-Minuten-Schritten, maßgeblich ist die Zeitzone der Ressource). Beispiel: Flutlicht nur außerhalb von 08:00–18:00 einschalten, tagsüber bleibt die Regel wirkungslos. | | Aufeinanderfolgende Buchungen | anny überspringt das Ausschalten automatisch, solange noch eine andere bestätigte Buchung läuft, die denselben Schalter nutzt: etwa wenn eine Buchung nahtlos an die vorherige anschließt oder wenn sich mehrere Ressourcen einen Schalter teilen. Das Gerät bleibt durchgehend eingeschaltet, bis keine laufende Buchung den Schalter mehr benötigt; übersprungene Aktionen stehen im Aktivitätsprotokoll. | Die Auslöser „Buchung ist eingecheckt“ und „Buchung ist ausgecheckt“ setzen voraus, dass für die Ressource ein QR-Code-Ticket aktiviert ist (Feature: Check-In & Check-Out). ## Einschränkungen Die Shelly-Integration unterstützt nicht: * **Statusabfrage:** anny kann den aktuellen Zustand eines Schalters (ein/aus) nicht abfragen, sondern nur Befehle senden. * **Dimmen oder Zwischenstufen:** Es werden ausschließlich die Aktionen „Eingeschaltet“ und „Ausgeschaltet“ unterstützt. * **Automatische Geräteerkennung:** Shelly-Geräte müssen im Shelly-Konto registriert und über die Shelly URL erreichbar sein, bevor sie in anny zugeordnet werden können. * **Automatische Wiederholung:** Schlägt ein Schaltbefehl fehl (z. B. weil das Gerät gerade offline ist), wird er nicht automatisch erneut versucht. Der Schaltzustand bleibt dann unverändert. ## Verbindung trennen Wenn du die Integration deaktivierst, reagiert Shelly nicht mehr auf Buchungsereignisse. Das gilt auch für bereits bestehende Buchungen. Beim Löschen werden alle gespeicherten Regeln entfernt, weitere Schritte sind nicht erforderlich. Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**. ## FAQ Ja. Jede Regel verknüpft genau eine Ressource mit einem Schalter und einem Auslöser. Wenn du beim Einchecken einschalten und beim Auschecken ausschalten möchtest, brauchst du zwei Regeln pro Ressource. anny überspringt das Ausschalten, solange noch eine andere bestätigte Buchung läuft, die denselben Schalter nutzt: z. B. eine nahtlos anschließende Buchung oder eine parallele Buchung auf einer Ressource, die sich den Schalter teilt. Das Gerät bleibt durchgehend eingeschaltet und wird erst am Ende der letzten Buchung ausgeschaltet. Deaktiviere die Integration zuerst über den **Toggle**, denn solange sie aktiv ist, lassen sich die Zugangsdaten nicht ändern. Trage danach beide Felder neu ein und klicke auf **Authentifizierung überprüfen**. Schlägt die Prüfung fehl, verwirft anny die eingegebenen Daten; fülle in dem Fall beide Felder erneut aus. Ja. Alle ausgeführten und übersprungenen Aktionen werden im Aktivitätsprotokoll der Buchung dokumentiert. Alle WLAN-fähigen Shelly-Schaltrelais, die über die Shelly Cloud API erreichbar sind. In der Schalter-Auswahl erscheinen nur Geräte der Kategorie Relais (keine Sensoren o. Ä.); Geräte mit mehreren Schaltkanälen können pro Kanal angesteuert werden. Empfohlen wird das Modell Shelly 1 Gen3. ## Troubleshooting Die Integration ist möglicherweise deaktiviert oder die Regel ist nicht korrekt gespeichert. Prüfe, ob der Toggle der Integration aktiv ist und ob die Regel der richtigen Ressource und dem richtigen Schalter zugeordnet ist. Kontrolliere außerdem, ob der Shelly-Schalter im WLAN erreichbar ist. Stelle sicher, dass die Shelly URL mit `https://` beginnt und der API-Schlüssel korrekt aus dem Shelly-Konto kopiert wurde. Prüfe, ob dein Shelly-Konto aktiv und die Geräte registriert sind. Beachte: Solange die Integration aktiv ist, lassen sich die Zugangsdaten nicht ändern. Deaktiviere sie zuerst über den **Toggle**. Prüfe im Aktivitätsprotokoll, ob die Aktion übersprungen wurde. Häufigste Ursache: Es läuft noch eine andere bestätigte Buchung, die denselben Schalter nutzt (z. B. eine nahtlos anschließende Buchung), und anny überspringt das Ausschalten bewusst (Skip-Logik). Ist keine solche Buchung vorhanden, prüfe die Regel (inklusive aktivem Zeitplan) und die Erreichbarkeit des Schalters. Die Geräteliste wird für einige Minuten zwischengespeichert. Warte bis zu 5 Minuten und lade die Seite neu. Prüfe außerdem, ob das Gerät im Shelly-Konto registriert und ein Schaltrelais ist, denn andere Gerätetypen erscheinen nicht in der Auswahl. > Wichtige Informationen für Agenten: > > Wichtige Informationen für Agenten: > > **Abgrenzung:** Shelly ist KEINE Smart-Lock-Integration (kein Zutritt, kein Remote Open). Es handelt sich um eine IoT-Lösung zur Gerätesteuerung (Schaltrelais ein/aus). Für Zutritt siehe die Smart-Lock-Integrationen (Übersicht Smart-Locks). > > **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Shelly** → Felder „Shelly URL" + „API-Schlüssel" → Button „Authentifizierung überprüfen". Regeln: gleicher Ort, Panel „Regeln" → „Hinzufügen"; Felder: „Ressource", „Buchungs-Ereignis", „Shelly-Schalter", „Zustand ändern zu", „Aktivitäts-Modus" (+ Start-/Endzeit). Regel-Tabelle mit Spalte „Aktiver Zeitplan". Aktivieren/Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen. > > **Quirks:** (1) Skip-Logik: Das Ausschalten wird übersprungen, solange noch eine andere bestätigte Buchung läuft, deren Ressource per Regel mit demselben Schalter verknüpft ist (nahtlose Folgebuchung oder geteilter Schalter über mehrere Ressourcen); der Schalter bleibt an, bis keine laufende Buchung ihn mehr benötigt. (2) Nur bestätigte Buchungen lösen Schaltaktionen aus. (3) Regeln auf einer übergeordneten Ressource greifen auch für deren Unterressourcen. (4) Geräteliste zeigt nur Relais-Geräte und ist ca. 5 Minuten zwischengespeichert; neue Geräte erscheinen verzögert. (5) Fehlgeschlagene Schaltbefehle werden nicht wiederholt. (6) Schaltbefehle sind gedrosselt (ca. 1 Befehl / 2 Sekunden); bei vielen gleichzeitigen Regeln kommt es zu Verzögerungen von Sekunden. (7) Zugangsdaten lassen sich nur bei deaktivierter Integration ändern; nach fehlgeschlagener Prüfung müssen beide Felder neu eingegeben werden. (8) Aktiver Zeitplan wird in der Zeitzone der Ressource ausgewertet. > > **Beziehungen:** Die Auslöser „Buchung ist eingecheckt"/„Buchung ist ausgecheckt" setzen das Check-In-Feature (QR-Code-Ticket der Ressource) voraus, siehe Artikel zu Check-In & Check-Out. Plan-Verfügbarkeit läuft über dasselbe Plan-Feature wie die Smart-Lock-Integrationen (ab Professional-Plan). Aktivitätsprotokoll-Einträge erscheinen in der Buchung („hat {Schalter} eingeschaltet/ausgeschaltet", „hat das Ausschalten … wegen einer Folgebuchung … ausgesetzt").