Ein Webhook liefert Ihnen keine Daten schneller, wenn Ihre empfangende Seite nicht darauf ausgelegt ist. Genau hier scheitern die meisten Belegungsprojekte: Der Zählsensor ist präzise, aber das BMS quittiert eingehende POST-Requests mit einer Verzögerung von mehreren Sekunden oder verwirft sie unter Last. Bevor wir also über Payload-Formate reden, sollten Sie wissen, dass die Integrationsqualität selten am Sensor hängt, sondern an der Architektur dahinter.
Ein typischer Webhook-Event enthält keine Bilder und keine personenbezogenen Merkmale. Er transportiert aggregierte Zählwerte: aktuelle Belegung einer Zone, Ein- und Ausgänge über ein Zeitfenster, ein Zeitstempel und eine Zonen- oder Sensor-ID. Bei Vemco ist das ein bewusster Designentscheid – die Personenzählung ist DSGVO-konform, ohne Identifikation, mit Ausschluss des eigenen Personals und ausschließlich als aggregierte Zahl. Ihr JSON-Payload enthält also einen count, eine zone_id und einen timestamp, nicht mehr, nicht weniger.
Webhooks sind ereignisgesteuert. Sie eignen sich, wenn eine Aktion sofort ausgelöst werden soll: Lüftung hochfahren, wenn eine Zone einen Schwellwert überschreitet, digitale Beschilderung umschalten, Reinigungspläne anstoßen. Wenn Sie hingegen historische Auswertungen oder Dashboards füttern, ist eine REST-API mit Polling oft stabiler, weil sie idempotent abfragbar ist und keine verlorenen Events kennt.
In der Praxis kombinieren viele Integratoren beides: Webhook für die Echtzeitsteuerung, API für den nächtlichen Datenabgleich.
Das ist die Frage, die zu selten früh gestellt wird. Ihr Endpunkt wird irgendwann nicht erreichbar sein – wegen eines Deployments, eines Netzwerkfehlers oder eines überlasteten Servers. Klären Sie deshalb vor der Integration:
Ein praktischer Hinweis aus der Umsetzung: Behandeln Sie Ihren Empfangs-Endpunkt immer als idempotent. Retries führen fast zwangsläufig dazu, dass dasselbe Event doppelt ankommt. Wenn Ihre Steuerlogik jeden Eingang blind verarbeitet, lösen Sie Aktionen mehrfach aus. Speichern Sie die Event-ID und verwerfen Sie Wiederholungen – das erspart Ihnen unerklärliche Doppelschaltungen im Betrieb.
Ein offener Webhook-Endpunkt ist eine Einladung. Erwarten Sie mindestens eine Signatur-Prüfung: Der Absender signiert die Payload mit einem geteilten Secret, Sie verifizieren den HMAC-Header, bevor Sie den Inhalt verarbeiten. Ergänzen Sie das durch TLS, eine IP-Allowlist, wo möglich, und eine Prüfung des Zeitstempels gegen Replay-Angriffe. Da die übertragenen Daten aggregiert und anonym sind, ist das Risiko personenbezogener Datenlecks gering – aber die Steuerbefehle, die daraus folgen, sollten Sie trotzdem schützen.
Ein Webhook überträgt nur so verlässlich, wie der Sensor zählt. Vemco garantiert vertraglich eine Genauigkeit von mindestens 96 %, in der Praxis liegen die Werte typischerweise bei 98–99 %, sofern Beleuchtung, Ladenlayout und Besucherverhalten passen. Rechnen Sie in Ihrer Automationslogik mit dieser Toleranz. Wenn eine Zone eine vertragliche Kapazitätsgrenze knapp erreicht, sollten Sie einen Puffer einplanen, statt auf den exakten Zählwert zu schalten – gerade bei sicherheitsrelevanten Steuerungen wie Zutrittsbegrenzung.
Das ist für viele Facility-Teams die entscheidende Frage. Vemco bietet sowohl gehostete als auch Private-Cloud-Modelle und integriert sich in bestehende IT-Systeme. Für Webhook-Szenarien heißt das: Sie können Events direkt aus der gehosteten Umgebung empfangen oder die Verarbeitung innerhalb Ihrer eigenen Infrastruktur halten. Klären Sie mit Ihrer IT früh, ob eingehende Verbindungen aus der Cloud erlaubt sind oder ob ein Reverse-Proxy in der DMZ nötig wird.
Erwarten Sie keine Millisekunden-Reaktion. Zwischen dem physischen Ereignis und dem eintreffenden Webhook liegen die Sensorverarbeitung, das Zeitfenster für die Aggregation und die Netzwerkübertragung. Für die meisten Gebäudeanwendungen – Lüftung, Beschilderung, Belegungsanzeigen – ist das mehr als ausreichend. Wenn Ihre Anwendung eine harte Echtzeitgrenze im Sekundenbereich hat, definieren Sie diese Anforderung vor der Vertragsunterschrift und testen Sie sie unter realer Last, nicht im leeren Gebäude.