Das Comydo Schließsystem funktioniert auf der Basis das in der igumbi Hotelsoftware ein 10-stelliger Code generiert wird. Der Code wird als QR-Code per Vorlagen E-Mail und Automailer an den Gast verschickt.
Der Gast hält den QR Code an den Comydo Scanner vor der Tür.
Der Scan löst durch Comydo einen Webhook Call an die igumbi Hotelsoftware aus. Dieser liefert die Antwort ob die Tür geöffnet werden kann. Es ist also bei jeder Türöffnung ein API Webhook Aufruf an igumbi im Spiel.
Freigabe für den Zugang/öffnen der Tür über Webhook Call
Das Scannen des QR Codes löst einen Aufruf von Comydo an den igumbi Server aus.
Mögliche Antworten auf den Webhook Call sind
Tür kann geöffnet werden: das wollen wir währen des Aufenthaltes des Gastes
- OK door open auth
Versuche und Teilerfolg
- TRY found device_id/room
- TRY found accesscode
- TRY code not valid yet
- TRY code not valid anymore
Nichts gefunden
- ERR accesscode not found
- ERR device_id not found
Der postive Fall ist also "OK door open auth".
Die Antworten TRY bedeuten, dass der Code gefunden wurde, aber die Tür noch nicht / nicht mehr geöffnet werden kann.
Comydo in igumbi Einrichten
- 1) Comydo wird vom igumbi Support freigeschalten: Einstellungen accesscode und comydo aktivieren.
- 2) Im Menüpunkt "Setup" im Bereich "Comydo Scanner Schließsystem" die Check-In und Check-Out Zeiten eintragen: Die Zeiten ab dem/bis wann der Zugang erlaubt ist.
- 3) Menüpunkt Zimmer" => "Alle Zimmer"- Button oben in grün anklicken. Bei jedem Zimmer die Comydo DeviceID eintragen. Diese Information zu den verbauten Anlegen/ Schlössern bekommen Sie von Comydo.
Testen mit einer Reservierung
- 1) Reservierung anlegen
- 2) In der Reservierung "Zugangscode" anhaken.
- 3) Code per Vorlagen E-Mail schicken
E-Mail Versand an Gast aufsetzen
- 4) Vorlagen E-Mail "Ihr Zugangscode" anlegen
- 5) Der Textbaustein braucht Element #{accesscode}. Im Falle von Comydo wird das Bild des QR Codes im HTML E-Mail eingebunden
- 6) Vorlagen E-Mail An Gast schicken.
E-Mails automatisieren
Wenn Vorlagen E-Mail mit den Erklärungen für den Gast passt - den gast darauf Vorbereiten dass er den QR Code an einen scanner halten sollte
- 7) Automailer einrichten, mit dem "Datumsfeld" "cki-codes". Versand am Vormittag z.B. um 10:00 uhr 1-2 Tage vor der Anreise.
Der Job der die Codes für die aktuell ankommenden Reservierungen anlegt läuft täglich um 7:30 in der Früh.
Testen mit Curl
- api_key ist der API Key des Comydo Benutzers des jeweiligen Hotels in igumbi
- device_id ist die DeviceID des Comydo scanners
- content ist der 10-stellige Code der von igumbi generiert wurde
curl -X POST "https://api.igumbi.net/webhooks/comydo?api_key=oWzbAzLc6609i09RbvJG0"\
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"device_id": "a465griuzz123",
"content": "11425553736"
}'
Antwort bei Erfolg / Misserfolg
{"success":true,"status":"OK door open auth","error":""}
{"success":false,"status":"TRY code not valid yet","error":"TRY code not valid yet"}
