timum

Integrazione generica del sito web

Integrazione di calendari di prenotazione specifici tramite canali di prenotazione (Booking Channel)

In timum è possibile creare un numero qualsiasi di widget per il sito web e link di prenotazione configurati individualmente. Un pacchetto di configurazione di questo tipo, che comprende sempre un link di prenotazione individuale insieme a uno snippet di codice per l'integrazione nel sito web, si chiama canale di prenotazione o Booking Channel. La configurazione può essere adattata in timum in qualsiasi momento. Le modifiche diventano immediatamente effettive sulle pagine di prenotazione tramite il link esistente o nel widget del sito web, senza alcun aggiornamento del sito web o del link.

I canali di prenotazione vengono creati e modificati in timum, nel calendario del fornitore, nella pagina Prenotazione appuntamenti (si veda Booking Channels).

Widget di integrazione generico per l'assegnazione dinamica della risorsa prenotabile

Per la prenotazione di appuntamenti su siti web con contenuti generici, come ad esempio annunci immobiliari, timum mette a disposizione un codice widget generico. Questo viene integrato nel modello di sito web per contenuti generici e configurato automaticamente per la relativa risorsa di prenotazione tramite la trasmissione di parametri specifici.

L'integrazione si compone dei seguenti elementi:

  1. Snippet di script generico per il rispettivo calendario del fornitore
  2. Trasmissione dei parametri tramite parametro URL o tramite un oggetto globale sulla pagina
  3. Configurazione del layout e delle funzionalità in timum

Snippet di script generico

Lo snippet di codice generico si trova nelle impostazioni del rispettivo calendario del fornitore:

  1. Apra timum ed effettui l'accesso.
  2. Apra il calendario del fornitore per cui deve essere configurata l'integrazione con il sito web.
  3. Apra Impostazioni nel menu principale.
  4. Nella sezione Profilo fornitore troverà il riquadro Integrazione sito web del fornitore. Clicchi su Mostra codice di incorporamento e selezioni JS Widget (o Iframe).
  5. Clicchi su Copia.
  6. Inserisca lo snippet nel punto desiderato del suo sito web.

Utilizzo avanzato

La documentazione completa per sviluppatori descrive lo snippet di script generale con tutte le opzioni di configurazione:

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

Specifica tramite riferimento risorsa e ID persona

È obbligatorio trasmettere il parametro di riferimento di almeno una risorsa timum prenotabile. Sono possibili anche più risorse. I riferimenti possono essere generati dagli ID proprietà del sistema CRM oppure salvati come UUID di timum.

Inoltre, l'ID persona proveniente da un sistema CRM può essere trasmesso facoltativamente al widget di prenotazione. I clienti i cui dati sono già presenti nel CRM non devono più inserire dati personali, ma possono prenotare direttamente. È possibile richiedere ulteriori informazioni configurando il modulo di prenotazione. I dati raccolti vengono assegnati automaticamente al record nel CRM. Oltre all'identificativo di contatto (personId), deve essere trasmesso un identificativo di piattaforma per il rispettivo CRM.

  • risorsa prenotabile (ref) – obbligatoria
  • cliente preidentificato (pData) – facoltativo
    • piattaforma (sistema CRM)
    • personId

Link di prenotazione personalizzati per plugin del sito web integrati

Se il link di prenotazione deve essere personalizzato per ciascun singolo destinatario, in modo che la persona venga riconosciuta automaticamente e associata in modo affidabile al record nel CRM, aggiunga parametri URL:

Trasmissione dei parametri

Per la trasmissione dei parametri esistono due possibilità, descritte di seguito.

Opzione 1: parametro URL

Trasmissione del riferimento risorsa timum per il responsabile del contatto (agente immobiliare) e dell'ID del cliente (AddressID) come parametri URL al proprio sito web, in cui è integrato il widget timum.

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

Esempio:

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

Opzione 2: oggetto globale sulla pagina

Trasmissione dei parametri (riferimento del responsabile del contatto e ID indirizzo) tramite un oggetto globale nel sito 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' } } },
   },
 };

Configurazione del layout e delle funzionalità

Nell'integrazione come widget generico, in cui la risorsa effettivamente prenotabile dipende dal contenuto di un sito web dinamico, la configurazione avviene nel calendario del fornitore in Impostazioni → Layout di prenotazione.

Livelli e priorità delle impostazioni di layout

Un'ampia gamma di opzioni di configurazione è disponibile direttamente tramite l'interfaccia utente di timum. Le impostazioni di configurazione possono essere definite gerarchicamente in diverse aree.

Esiste una cascata di priorità per l'applicazione delle configurazioni (il livello superiore prevale su quello inferiore):

  1. Parametri URL
  2. Voci specifiche dell'istanza nell'oggetto globale (chiave bookingjs-<Channel-UUID>)
  3. Oggetto globale timumBookingConfig
  4. Configurazione del tipo di appuntamento
  5. Configurazione del canale di prenotazione (Booking Channel)
  6. Impostazione predefinita del calendario del fornitore
  7. Impostazione predefinita dell'account

Documentazione completa su npm

Oltre alle opzioni di configurazione disponibili nell'interfaccia di timum – o indipendentemente da esse – la configurazione può essere effettuata anche dagli sviluppatori web direttamente all'interno dell'integrazione stessa.

Documentazione della configurazione timum: www.npmjs.com/package/@timum/booking