Booking Links in onOffice und in Webseiten generieren

Diese Seite zeigt, wie Sie Buchungslinks für Ihre Immobilien in onOffice-Vorlagen, Exposés und auf Webseiten generisch zusammensetzen – mit onOffice-Makros, optional personalisiert für einen einzelnen Empfänger und mit wählbarem Layout der Buchungsseite.

Die allgemeine Kalender-Route (Provider-Route)

Routen mit der Provider-UUID als Slug oder dem provider-spezifischen Slug sind Gesamtkalender-Routen in timum:

z.B. https://www.timum.de/4941e100-1111-2222-3333-06ecf2a1ba22 …

oder https://www.timum.de/mein-name

Diese sind für öffentlich buchbare Ressourcen vorgesehen, also z. B. für Beraterinnen in Vertrieb und Beratung. Das ist bewusst so, damit die zentrale Terminbuchung über einen kurzen, einprägsamen Link verfügbar ist, wie z. B. www.timum.de/mein-name.

Damit über diese Standard-Route nicht alle Immobilien erscheinen, ist sie für Immobilien standardmäßig deaktiviert. Man kann einzelne Immobilien für diese Route aktivieren. In der Regel ist das jedoch nicht gewollt.


Die spezifische Route für eine Immobilie

Routen mit dem Slug "page" sind hingegen spezifische Routen für eine einzelne Immobilie (Ressource) und deshalb standardmäßig freigeschaltet, z. B. www.timum.de/page/...

Im Folgenden wird die generische Erzeugung von Links für diese Routen aufgezeigt:

Generischer Bausatz mit onOffice-Makros

A) mit timum Provider-UUID:

https://www.timum.de/page/_Id@providerUuid@onofficeEstate

B) mit onOffice-Mandanten-ID:

https://www.timum.de/page/_Id@web_MdtID@onofficeEstate

Tipp

Den fertigen Bausatz mit Ihrer Provider-UUID finden Sie in timum unter Einstellungen → Integrationen im Abschnitt onOffice ("Generischer Link zur Terminbuchung für Objekte in diesem Kalender") – mit Kopieren-Button.

Konkretes Beispiel

A) mit Provider-UUID:

https://www.timum.de/page/1212@4941e100-1111-2222-3333-06ecf2a1ba22@onofficeEstate

B) mit Mandanten-ID:

https://www.timum.de/page/1212@web6969@onofficeEstate

Die Personalisierung für einen einzelnen Kunden

Wenn der Buchungslink personalisiert für jeden einzelnen Empfänger sein soll, sodass die Person automatisch erkannt wird und zuverlässig zum Datensatz im CRM zugeordnet wird, sind URL-Parameter anzuhängen:

pDataId = address ID der Person 
pDataPlatform = Kennung des CRM

In onOffice-E-Mail-Vorlagen, Web-Exposé oder PDF-Exposé die nachfolgende Zeile über die Link-Funktion einrichten.

Wichtig

Groß- und Kleinschreibung ist absolut relevant in den Makro-Namen und Variablen, z. B. bei „_Id“ mit großem „I“.

Variante mit einfachen URL-Parametern

Bausatz mit onOffice-Makros:

https://www.timum.de/page/_Id@web_MdtID@onofficeEstate?pDataId=_AdrDatensatznummer&pDataPlatform=onoffice

Konkretes Beispiel:

A) mit Provider-UUID:

https://www.timum.de/page/1212@4941e100-1111-2222-3333-06ecf2a1ba22@onofficeEstate?pDataId=149&pDataPlatform=onoffice

B) mit Mandanten-ID:

https://www.timum.de/page/1212@web6969@onofficeEstate?pDataId=149&pDataPlatform=onoffice

Variante mit pData-Objekt

https://www.timum.de/page/_Id@web_MdtID@onofficeEstate?pData=%7B%22platform%22:%22onoffice%22,%22address%22:%22_AdrDatensatznummer%22,%22tenantId%22:%22_MdtID%22%7D

Synonyme für den Parameter address sind: personId || address || partnerId || id


Buchungsansicht: Layout-Varianten

Option 1: über den Slug in der Link-URL

Die Darstellung der Buchungsseite für einzelne Objekte wird durch den URL-Slug bestimmt.

Um die Darstellung der Buchungsseite zu ändern, ersetzen Sie im Link-Bausatz das Schlüsselwort "/page/".

Wichtig

Die Einstellung des Layouts über den URL-Slug kann durch Voreinstellungen des Kalenders oder des Accounts überschrieben werden. Hat eine Änderung des Slugs keine Auswirkung, nutzen Sie Option 2.

Das sind die Schlüsselwörter für die Layout-Varianten – ersetzen Sie in der URL den Slug "/page/" durch eines davon:

ListeKondensiertKalenderwocheMonat-Picker
/list/ · /details-list/ · /list-widget//condensed/ · /details-condensed/ · /condensed-widget//week/ · /details-week/ · /week-widget//month/ · /details-month/ · /month-widget/

Option 2: per URL-Parameter

Diese Option hat Priorität und überschreibt anderslautende Voreinstellungen des Kalenders oder des Booking Channels.

Ergänzen Sie die Link-URL um den Parameter calendarFrontend, zum Beispiel:

https://www.timum.de/page/1212@web6969@onofficeEstate?calendarFrontend=condensedView

Mögliche Werte für den Parameter calendarFrontend sind:

  • fullCalendar, detailsFullCalendar, listView, detailsListView, condensedView, detailsCondensedView, monthView, detailsMonthView
  • aktuelle Liste abrufbar über https://www.timum.de/experten/support?calendarFrontend=