timum

Integrazione generica del sito web

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

In timum è possibile creare un numero illimitato di widget per siti web e link di prenotazione configurati individualmente. Un tale pacchetto di configurazione, che comprende sempre un link di prenotazione individuale e allo stesso tempo un frammento di codice per un'integrazione su un sito web, è denominato Canale di prenotazione o anche Provider Channel . La configurazione può essere modificata in timum in qualsiasi momento. Le modifiche hanno effetto immediato 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 all'interno di un calendario di team (providers) nella pagina Prenotazione appuntamenti.

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

Per la prenotazione di appuntamenti su siti web con contenuti generici, come gli annunci immobiliari, timum mette a disposizione un codice widget generico. Questo viene integrato nel modello del sito web per contenuti generici e viene configurato automaticamente per risorse di prenotazione specifiche tramite il passaggio di parametri specifici.

L'integrazione è composta dai seguenti componenti:

  1. Frammento di script generico per il calendario di team specifico (provider)
  2. Passaggio di parametri tramite parametri URL o parametro oggetto globale
  3. Configurazione del layout e delle funzionalità in timum

Frammento di script generico

Il frammento di codice generico è disponibile nelle impostazioni del rispettivo provider (calendario di team):

  1. Apra timum e acceda.
  2. Apra il profilo del calendario (calendario di team) per il quale deve essere configurata un'integrazione con il sito web.
  3. Apra le Impostazioni nel menu principale.
  4. Nella sezione Profilo fornitore (Profilo calendario), troverà il riquadro 'Integrazione del sito web del fornitore'.
  5. Copi il frammento di codice del widget JS.
  6. Inserisca il frammento di codice nel sito web nel punto desiderato.

Applicazione speciale avanzata

Il frammento di script generale con tutte le opzioni di configurazione è documentato nella documentazione completa per gli sviluppatori:

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

Specifica tramite riferimento risorsa e ID persona

È obbligatorio il passaggio del parametro di riferimento di almeno una risorsa timum prenotabile. Sono possibili anche più risorse. I riferimenti possono essere generati dagli ID oggetto del sistema CRM o memorizzati come UUID in timum.

Inoltre, gli ID persona di un sistema CRM possono essere trasmessi facoltativamente al widget di prenotazione per creare un'esperienza personalizzata e comoda per i clienti i cui dati sono già disponibili nel CRM. Non è richiesta l'immissione di dati personali per la prenotazione dell'appuntamento; è possibile prenotare direttamente. La raccolta di dati e informazioni aggiuntivi è possibile tramite la configurazione del modulo di prenotazione. I dati raccolti vengono assegnati automaticamente al record nel CRM. Oltre all'identificatore del contatto (addressid), deve essere trasmesso un ID piattaforma per il CRM specifico.

  • risorsa prenotabile (ref) - obbligatoria
  • cliente preidentificato (pData) - opzionale
    • piattaforma (CRM-System)
    • addressid

Link di prenotazione personalizzati per plugin di siti web integrati

Se il link di prenotazione deve essere personalizzato per ogni singolo destinatario in modo che la persona venga riconosciuta automaticamente e mappata in modo affidabile al record nel CRM, è necessario aggiungere parametri URL:

Passaggio di parametri

Esistono due opzioni generali per il passaggio di parametri, descritte di seguito.

Option 1: Url parameter

Passaggio del parametro di riferimento della risorsa timum per il gestore degli indirizzi (agente immobiliare) e dell'ID 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

Option 2: In-page global object

Passaggio dei parametri, del riferimento del gestore degli indirizzi e dell'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 viene effettuata nell'area Impostazioni del calendario di team (provider) nella sottopagina 'Layout di prenotazione'.

Livelli e prioritizzazione delle impostazioni di layout

Un'ampia gamma di opzioni di configurazione è disponibile direttamente tramite le interfacce utente in timum. Le impostazioni di configurazione predefinite possono essere definite gerarchicamente in varie aree.

Esiste una cascata di priorità per l'applicazione delle configurazioni:

  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

Oltre alle opzioni di configurazione all'interno delle interfacce timum, o indipendentemente da esse, la configurazione può essere eseguita anche direttamente all'interno dell'integrazione stessa da parte di sviluppatori web.

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