timum

Integración genérica de sitio web

Integración de calendarios de reserva específicos a través de canales de reserva (Provider Channel)

En timum, se puede crear cualquier número de widgets de sitio web y enlaces de reserva configurados individualmente. Un paquete de configuración de este tipo, que siempre incluye un enlace de reserva individual y al mismo tiempo un fragmento de código para una integración en un sitio web, se denomina Canal de reservas o también Provider Channel . La configuración puede ajustarse en timum en cualquier momento. Los cambios surten efecto inmediatamente en las páginas de reserva a través del enlace existente o en el widget del sitio web, sin necesidad de actualizar el sitio web ni el enlace.

Los canales de reserva se crean y editan en timum dentro de un calendario de equipo (providers) en la página Reserva de citas.

Widget de integración genérico para la asignación dinámica del recurso reservable

Para la reserva de citas en sitios web con contenido genérico, como anuncios inmobiliarios, timum pone a disposición un código de widget genérico. Este se integra en la plantilla del sitio web para contenidos genéricos y se configura automáticamente para recursos de reserva específicos mediante la transmisión de parámetros específicos.

La integración se compone de los siguientes componentes:

  1. Fragmento de script genérico para el calendario de equipo específico (provider)
  2. Transmisión de parámetros mediante parámetros URL o parámetro de objeto global
  3. Configuración de diseño y funcionalidad en timum

Fragmento de script genérico

El fragmento de código genérico está disponible en los ajustes del provider respectivo (calendario de equipo):

  1. Abra timum e inicie sesión.
  2. Abra el perfil del calendario (calendario de equipo) para el que se va a configurar una integración de sitio web.
  3. Abra los Ajustes en el menú principal.
  4. En la sección Perfil del proveedor (Perfil del calendario), encontrará el cuadro 'Integración del sitio web del proveedor'.
  5. Copie el fragmento de código del widget JS.
  6. Inserte el fragmento de código en el sitio web en el lugar deseado.

Aplicación especial avanzada

El fragmento de script general con todas las opciones de configuración está documentado en la documentación completa para desarrolladores:

https://www.npmjs.com/package/@timum/booking#in-a-script-tag

Especificación mediante referencia de recurso e ID de persona

Es obligatorio transmitir el parámetro de referencia de al menos un recurso timum reservable. También son posibles múltiples recursos. Las referencias pueden generarse a partir de ID de objetos del sistema CRM o almacenarse como UUID en timum.

Además, los ID de persona de un sistema CRM pueden transmitirse opcionalmente al widget de reserva para crear una experiencia personalizada y cómoda para los clientes cuyos datos ya están disponibles en el CRM. No se requiere la introducción de datos personales para la reserva de citas; en su lugar, se puede reservar directamente. La recopilación de datos e información adicionales es posible mediante la configuración del formulario de reserva. Los datos recopilados se asignan automáticamente al registro en el CRM. Además del identificador de contacto (addressid), se debe transmitir un ID de plataforma para el CRM específico.

  • recurso reservable (ref) - obligatorio
  • cliente preidentificado (pData) - opcional
    • plataforma (CRM-System)
    • addressid

Enlaces de reserva personalizados para plugins de sitio web integrados

Si el enlace de reserva debe personalizarse para cada destinatario individual de modo que la persona sea reconocida automáticamente y mapeada de forma fiable al registro en el CRM, se deben añadir parámetros URL:

Transmisión de parámetros

Existen dos opciones generales para la transmisión de parámetros, que se describen a continuación.

Option 1: Url parameter

Transmisión del parámetro de referencia de recurso timum para el gestor de contactos (agente inmobiliario) y el ID del cliente (AddressID) como parámetros URL al propio sitio web en el que está integrado el widget timum.

pDataId = <address ID der Person>
pDataPlatform = <Kennung des CRM>

Ejemplo:

www.meine-webseite.de/terminbuchung?pDataId=0815&pDataPlatform=onoffice

Option 2: In-page global object

Transmisión de los parámetros, referencia del gestor de contactos e ID de dirección a través de un objeto global en el sitio web.

https://www.npmjs.com/package/@timum/booking#global-config-override

window.timumBookingConfig = {
   // Top-level slots — applied to every BookingJS instance on the page
   appConfig: {
	   ref: 'current-resource-ref',
	   pData: {
		   platform : ´onOffice´,
		   personId : ´0815´
		   },
	   culture: 'de' /* … */
	 },
   muiTheme:  { palette: { primary: { main: '#abc' } } },
   fcConfig:  { /* … */ },

   // Per-instance overrides — only applied to the instance whose
   // appConfig.rootElId matches the key. Reserved names 'appConfig',
   // 'muiTheme', 'fcConfig' are never matched even if a rootElId equals one.
   'bookingjs-dd8d32cc-b53b-4ab4-af52-41325000592b': {
     appConfig: { ref: 'special-ref' },
   },
   'bookingjs-{other-channel-uuid}': {
     muiTheme: { palette: { primary: { main: '#def' } } },
   },
 };

Configuración de diseño y funcionalidad

En la integración como widget genérico, donde el recurso realmente reservable depende del contenido de un sitio web dinámico, la configuración se realiza en el área de Ajustes del calendario de equipo (provider) en la subpágina 'Diseño de reserva'.

Niveles y priorización de los ajustes de diseño

Hay disponible un amplio rango de opciones de configuración directamente a través de las interfaces de usuario en timum. Los valores predeterminados de configuración pueden definirse jerárquicamente en diversas áreas.

Existe una cascada de prioridades para la aplicación de las configuraciones:

  1. Url parameters
  2. Special bookingjs-other config via inPage global object (bookingjs-other-uuid)
  3. Global Object timumBookingConfig
  4. Product config
  5. Provider Channel Config
  6. Provider Default Config
  7. Account Default Config

General extended documentation on npm

Más allá de las opciones de configuración dentro de las interfaces de timum, o independientemente de ellas, la configuración también puede realizarse directamente dentro de la propia integración por parte de desarrolladores web.

Documentación de la configuración de timum: www.npmjs.com/package/@timum/booking