Migration: Von Timum zum kyl.immo Terminierungsfeature
So migrieren Sie Ihre Einladungs-E-Mail-Vorlage vom externen Terminierungs-Tool "Timum" auf das integrierte kyl.immo-Terminierungsfeature — inklusive Schnell-Diagnose und typischer Fehlerbilder.
Migration: Vom Timum-Tool zum kyl.immo Terminierungsfeature
Das externe Tool Timum wurde durch das integrierte Terminierungsfeature von kyl.immo abgelöst. Wenn Sie vor der Umstellung Timum für Ihre Besichtigungstermine genutzt haben, müssen Ihre Einladungs-E-Mail-Vorlagen angepasst werden — sonst verweisen Ihre Interessenten weiterhin auf den alten Timum-Dienst, können aber keinen Termin buchen.
Die Migration selbst ist einfach: In der betroffenen E-Mail-Vorlage wird der alte Buchungslink durch den neuen kyl.immo-Link ersetzt. Dieser Artikel führt Sie durch den Check, die Umstellung und die typischen Stolpersteine danach.
Schnell-Diagnose: Sind Sie von der Migration betroffen?
Die einfachste Prüfung: Öffnen Sie Ihre Einladungsvorlage in onOffice und schauen Sie sich den hinterlegten Buchungslink an.
| Domain im Link enthält | Bedeutung | Aktion |
|---|---|---|
timum |
Alter Timum-Link — Vorlage nicht migriert | Link ersetzen |
kyl.immo / kyl.immo-Buchungsdomain |
Neuer Link — Vorlage ist migriert | Keine Aktion nötig |
| Kein Link sichtbar | Vorlage enthält keinen Buchungslink | Neuen Link einfügen — siehe Buchungslink in E-Mail-Vorlagen einfügen |
Migration durchführen: Link in der Vorlage ersetzen
Der neue kyl.immo-Buchungslink
Fügen Sie in der betroffenen E-Mail-Vorlage folgenden Link ein — er ersetzt den alten Timum-Link vollständig:
https://onoffice-app.kyl.immo/appointment/_Uuidaddress-_Uuidestate
Der Link enthält die beiden Platzhalter _Uuidaddress und _Uuidestate (getrennt durch einen Bindestrich), die automatisch mit den Daten des jeweiligen Interessenten und der Immobilie befüllt werden. Beide Platzhalter müssen exakt so erhalten bleiben — inklusive der führenden Unterstriche und des Bindestrichs dazwischen. Andernfalls schlägt die Einsetzung fehl und der Link führt ins Leere.
E-Mail-Vorlage anpassen
Kurzfassung für die Migration:
- In onOffice den Bearbeiten-Modus öffnen → „Vorlagen/Dateien" → Tab „E-Mail-Vorlagen"
- Die betroffene Einladungsvorlage auswählen (Standardname: „kyl.immo - 02 - B - Einladung zur Besichtigung" — der Name kann je nach Installation abweichen)
- Alten Timum-Link vollständig entfernen
- Neuen kyl.immo-Buchungslink (siehe oben) einfügen
- Speichern
https:// prüfen: Der neue Link beginnt zwingend mit https://. Ohne das Protokoll schlägt der Link je nach Mail-Client fehl oder wird nicht als klickbarer Hyperlink dargestellt.Nach der Migration: Zeitfenster freischalten
Damit Interessenten tatsächlich einen Termin buchen können, müssen Sie im Vermietungs-Agenten für die betroffenen Objekte Zeitfenster anlegen. Nach einer Migration sind bei bestehenden Objekten in der Regel keine Slots vorbelegt — fehlen sie, landen Interessenten beim Klick auf den Link auf einer Warteseite, und Sie bekommen Rückmeldungen wie „Ich kann keinen Termin finden".
Verifikation: Funktioniert der neue Link?
- In der Vorlage prüfen: Nach dem Speichern die Vorlage im Vorschau-Modus öffnen. Der Buchungslink muss auf die kyl.immo-Domain zeigen, nicht auf
timum. - Testanfrage durchspielen: Einen Test-Interessenten an ein Objekt mit freigeschalteten Slots senden. Die Einladungs-Mail muss einen klickbaren Link enthalten, der zur kyl.immo-Buchungsseite führt.
- Buchung durchführen: Auf der Buchungsseite sollte mindestens ein freier Slot sichtbar sein. Wenn „keine Termine verfügbar" angezeigt wird, fehlen Zeitfenster — siehe vorigen Abschnitt.
Häufige Fehlerbilder nach der Migration
Fehlerbild 1: „Interessenten können keinen Termin buchen / bekommen eine Fehlerseite"
Häufigste Ursache: Die Einladungsvorlage wurde nicht aktualisiert und verweist noch auf Timum. Timum existiert als Dienst nicht mehr in dieser Form — der Link funktioniert nicht.
Lösung: Schnell-Diagnose oben durchgehen, Link ersetzen.
Fehlerbild 2: „Ich habe den Link getauscht, aber trotzdem geht nichts"
Häufigste Ursache: In onOffice existieren mehrere Kopien der Einladungsvorlage, und die aktive Vorlage wurde nicht bearbeitet.
Lösung: Alle Einladungsvorlagen durchgehen, jede einzeln auf den neuen Link prüfen. Nicht mehr benötigte Alt-Kopien löschen oder archivieren, damit die Situation übersichtlich bleibt.
Fehlerbild 3: „Der Link öffnet sich, aber es gibt keine Termine"
Häufigste Ursache: Für das Objekt sind keine Zeitfenster im Vermietungs-Agenten freigeschaltet.
Lösung: In den Objekt-Einstellungen Zeitfenster anlegen.
Fehlerbild 4: „Die Platzhalter werden im Link nicht ersetzt — Interessenten sehen _Uuidaddress im Link"
Häufigste Ursache: Beim Einfügen des neuen Links wurde ein Platzhalter entfernt oder falsch geschrieben (z. B. _UuidAddress mit Großbuchstaben, _Uuid_address mit Unterstrich).
Lösung: Link exakt so einfügen, wie er in diesem Artikel oben dokumentiert ist. Die Platzhalter sind case-sensitive.
Quick-Reference: Symptom → Ursache → Lösung
| Symptom | Ursache | Lösung |
|---|---|---|
Einladungsvorlage enthält timum in der Link-Domain |
Nicht migriert | Alten Link vollständig entfernen, neuen kyl.immo-Link einfügen |
| Mehrere Einladungsvorlagen vorhanden — nicht klar, welche aktiv ist | Kopien aus früheren Anpassungen | Jede Vorlage einzeln auf den neuen Link prüfen; Alt-Kopien löschen oder archivieren |
| Link führt auf Warteseite / „keine Termine" | Zeitfenster fehlen pro Objekt | In den Objekt-Einstellungen Zeitfenster anlegen |
| Platzhalter im Link nicht ersetzt | Platzhalter fehlerhaft übernommen | Link 1:1 aus KB-Artikel kopieren, Platzhalter-Schreibweise prüfen |
Link ohne https:// |
Protokoll fehlt | Link mit vollständigem https://-Präfix einfügen |