Skip to main content
Shelly 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

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)
  • 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:
  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

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 PunkteLö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.