- 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
Verfügbar ab dem Professional-Plan.
Typische Anwendungsfälle
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:- 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.
- 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.
- Trifft eine Regel zu, sendet anny den Befehl (Ein- oder Ausschalten) an den zugeordneten Shelly-Schalter.
- Die Aktion wird im Aktivitätsprotokoll der Buchung dokumentiert.
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)
- 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
1
Autorisieren
Ö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.2
Konfigurieren
Lege Regeln an, um Buchungsereignisse mit Schaltaktionen zu verknüpfen:
- Klicke auf Hinzufügen.
- Wähle die Ressource (z. B. Court 6).
- Lege das Buchungs-Ereignis als Auslöser fest (z. B. „Buchung ist eingecheckt“).
- Wähle den Shelly-Schalter, der zu dieser Ressource gehört.
- Wähle unter Zustand ändern zu die Aktion (z. B. „Eingeschaltet“).
- 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).
- Speichere die Regel.
- Erstelle für die Gegenaktion eine zweite Regel (z. B. „Buchung ist ausgecheckt“ → „Ausgeschaltet“).
- Aktiviere die gesamte Integration über den Toggle, damit die Regeln live ausgeführt werden.
Einstellungen & Optionen
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
Beides findest du unter Integrationen: Deaktivieren über den Toggle oben rechts, Löschen über die drei Punkte → Löschen.FAQ
Brauche ich für jeden Shelly-Schalter eine eigene Regel?
Brauche ich für jeden Shelly-Schalter eine eigene Regel?
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.
Was passiert, wenn zwei Buchungen direkt hintereinander liegen?
Was passiert, wenn zwei Buchungen direkt hintereinander liegen?
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.
Wie ändere ich die Zugangsdaten (Shelly URL / API-Schlüssel)?
Wie ändere ich die Zugangsdaten (Shelly URL / API-Schlüssel)?
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.
Kann ich sehen, ob ein Schaltbefehl ausgeführt wurde?
Kann ich sehen, ob ein Schaltbefehl ausgeführt wurde?
Ja. Alle ausgeführten und übersprungenen Aktionen werden im Aktivitätsprotokoll der Buchung dokumentiert.
Welche Shelly-Geräte werden unterstützt?
Welche Shelly-Geräte werden unterstützt?
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
Mein Schalter reagiert nicht auf Buchungsereignisse
Mein Schalter reagiert nicht auf Buchungsereignisse
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.
Die Authentifizierung schlägt fehl
Die Authentifizierung schlägt fehl
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.Das Licht geht am Ende der Buchung nicht aus
Das Licht geht am Ende der Buchung nicht aus
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.
Ein neu registriertes Gerät erscheint nicht in der Auswahl
Ein neu registriertes Gerät erscheint nicht in der Auswahl
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.