Generating Booking Links in onOffice and on Websites

This page shows how to generically assemble booking links for your properties in onOffice templates, property listings, and websites – using onOffice macros, optionally personalized for an individual recipient and with a selectable layout for the booking page.

The General Calendar Route (Provider Route)

Routes with the provider UUID as slug or the provider-specific slug are overall calendar routes in timum:

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

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

These are intended for publicly bookable resources, e.g. for consultants in sales and advisory. This is intentional, so that central appointment booking is available via a short, memorable link, such as www.timum.de/mein-name.

So that not all properties appear via this standard route, it is disabled for properties by default. Individual properties can be enabled for this route. As a rule, however, this is not desired.

The Specific Route for a Property

Routes with the slug "page", on the other hand, are specific routes for an individual property (resource) and are therefore enabled by default, e.g. www.timum.de/page/...

The following shows the generic generation of links for these routes:

Generic Template with onOffice Macros

A) with timum Provider UUID:

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

B) with onOffice client ID:

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

Tip

You can find the ready-made template with your provider UUID in timum under Settings → Integrations in the onOffice section ("Generic link for appointment booking for properties in this calendar") – with a copy button.

Concrete Example

A) with provider UUID:

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

B) with client ID:

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

Personalization for an Individual Customer

If the booking link is to be personalized for each individual recipient, so that the person is automatically recognized and reliably matched to the record in the CRM, URL parameters must be appended:

pDataId = address ID der Person
pDataPlatform = Kennung des CRM

In onOffice email templates, web listing, or PDF listing, set up the following line using the link function.

Important

Capitalization is absolutely relevant in macro names and variables, e.g. for "_Id" with a capital "I".

Variant with Simple URL Parameters

Template with onOffice Macros:

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

Concrete Example:

A) with provider UUID:

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

B) with client ID:

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

Variant with pData Object

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

Synonyms for the parameter address are: personId || address || partnerId || id

Booking View: Layout Variants

Option 1: Via the Slug in the Link URL

The display of the booking page for individual properties is determined by the URL slug.

To change the display of the booking page, replace the keyword "/page/" in the link template.

Important

The layout setting via the URL slug can be overridden by default settings of the calendar or the account. If changing the slug has no effect, use Option 2.

These are the keywords for the layout variants – replace the slug "/page/" in the URL with one of these:

List	Condensed	Calendar Week	Month Picker
/list/ · /details-list/ · /list-widget/	/condensed/ · /details-condensed/ · /condensed-widget/	/week/ · /details-week/ · /week-widget/	/month/ · /details-month/ · /month-widget/

Option 2: Via URL Parameter

This option has priority and overrides any differing default settings of the calendar or the booking channel.

Add the parameter calendarFrontend to the link URL, for example:

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

Possible values for the parameter calendarFrontend are:

fullCalendar, detailsFullCalendar, listView, detailsListView, condensedView, detailsCondensedView, monthView, detailsMonthView
current list available at https://www.timum.de/experten/support?calendarFrontend=