Die KleverKey Zapier App bietet derzeit 1 Trigger und 3 Aktionen, aber wir begrüßen Anfragen für zusätzliche Trigger und Aktionen. Die derzeit vorhandenen Aktionen konzentrieren sich auf die Integration von Buchungsplattformen und Coworking Management Services.
KleverKey bietet auch eine API und Webhooks für Anwendungsfälle, für die die Zapier-App nicht geeignet ist.
Trigger
New Lock Activity
Dieses Ereignis wird jedes Mal ausgelöst, wenn ein Schloss Ihrer Organisation eine neue Schlossaktivität erstellt.
Der Zapier-Trigger empfängt Schlossaktivitäten mit Eigenschaften wie Aktivitätszeit, Typ und Status sowie Benutzer-, Geräte- und Schlossinformationen. Eine detaillierte Beschreibung finden Sie in der Dokumentation Web-Event.
Aktionen
Create, Update or Cancel Booking
Wenn Ihr Dienst eine Buchungsplattform ist, können Sie mit dieser Aktion Buchungen an KleverKey übermitteln.
Die daraus resultierenden Einladungen und Berechtigungen enthalten einen zeitlich begrenzten Zutritt, welcher der Buchung entspricht.
Die Benutzerreferenz-ID erstellt eine Identitätszuordnung in KleverKey, die auf der E-Mail-Adresse basiert. Diese Identitätszuordnung kann später abgerufen werden, um Daten zurück an die Buchungsplattform zu senden, wenn diese die ursprüngliche Benutzer-ID benötigt. Diese Identitätszuordnung wird auch verwendet, um die Verbindung zwischen den Diensten aufrechtzuerhalten, selbst wenn sich die E-Mail-Adresse des Nutzers ändert.
Die Buchungsreferenz-ID muss eine eindeutige ID in der Buchungsplattform sein. Sie wird zur Identifizierung von Zeitfenstern in KleverKey-Berechtigungen verwendet.
Die IDs der Buchungssperren verweisen auf die Sperren, die der gebuchten Ressource entsprechen (z. B. Tagungs-/Hotelzimmer, Wohnung usw.). Für gebuchte Ressourcen, die mehr als ein Schloss haben (z. B. mehrere Türen, Aufzug, Haupttür usw.), unterstützt diese Eigenschaft eine Liste von IDs. Normalerweise werden diese IDs von der gebuchten Ressourcen-ID in einer früheren Zapier-Aktion zugeordnet (z. B. Raum 101 → KleverKey Lock 5, Raum 102 → KleverKey Lock 6 usw.)
Create, Update or Cancel Access Plan
Wenn Ihr Dienst Access Plans unterstützt, können Sie mit dieser Aktion Access Plans an KleverKey übermitteln.
Die daraus resultierenden Einladungen und Berechtigungen enthalten ein Zeitprofil, das diesen Access Plans entspricht.
Die Benutzerreferenz-ID erstellt in KleverKey eine Identitätszuordnung auf der Grundlage der E-Mail-Adresse. Diese Identitätszuordnung kann später abgerufen werden, um Daten an den Dienst zurückzusenden, wenn dieser die ursprüngliche Benutzer-ID benötigt. Diese Identitätszuordnung wird auch verwendet, um die Verbindung zwischen den Diensten aufrechtzuerhalten, selbst wenn sich die E-Mail-Adresse ändert.
Die Referenz-ID des Access Plans muss eine eindeutige ID im Dienst sein.
Die Lock-IDs der Access Plans verweisen auf die Schlösser, die der Ressource entsprechen, auf die zugegriffen werden soll (z. B. Haupteingang, Cafeteria, Büro usw.). In der Regel werden diese IDs von der Referenz-ID des Zutrittsplans in einer früheren Zapier-Aktion zugeordnet (z. B. Einfacher Zutritt → KleverKey-Schloss 1-5, Voller Zutritt → KleverKey-Schloss 1-10, usw.)
Access Plans werden als tägliche Zeitfenster definiert, die sich jede Woche wiederholen. Das folgende Beispiel erlaubt den Zugriff montags, dienstags und mittwochs zwischen 8:00 und 18:00 Uhr.
Unten sehen Sie eine JSON-Zugangsplan-Definition für das obige Beispiel. Der Wochentag beginnt am Sonntag (mit 0) und die Start-/Endzeit beginnt um Mitternacht (mit 0) und ist in Minuten definiert (die maximale endTime ist 1440).
[{ "dayOfWeek": 1, "startTime": 480, "endTime": 1080 }, { "dayOfWeek": 2, "startTime": 480, "endTime": 1080 }, { "dayOfWeek": 3, "startTime": 480, "endTime": 1080 } ]
Access Plans werden in der Regel anhand der Access-Plan-Referenz-ID in einem vorherigen Schritt zugeordnet oder sie können aus den Access Plan daten des Dienstes in einer Zapier-Code-Aktion erstellt werden.
Find Identity Mapping
Diese Aktion ruft Identitätszuordnungen ab, die manuell oder durch die Aktionen "Buchung erstellen, aktualisieren oder stornieren" oder "Access Plan erstellen, aktualisieren oder stornieren" erstellt wurden.
Diese Aktion ist nützlich, wenn ein Zap durch ein KleverKey-Ereignis ausgelöst wurde, das eine Benutzer-ID enthält, und der Zieldienst die ursprüngliche Benutzer-ID benötigt (z. B. Check-in in Coworking-Management-Diensten).
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.