timum

Intégration générique de site web

Intégration de calendriers de réservation spécifiques via des canaux de réservation (Booking Channel)

Dans timum, vous pouvez créer autant de widgets de site web et de liens de réservation configurés individuellement que vous le souhaitez. Un tel ensemble de configuration, qui comprend toujours un lien de réservation individuel ainsi qu'un extrait de code pour l'intégration au site web, s'appelle canal de réservation ou Booking Channel. La configuration peut être adaptée à tout moment dans timum. Les modifications prennent effet immédiatement sur les pages de réservation via le lien existant ou dans le widget du site web – sans aucune mise à jour du site web ou du lien.

Les canaux de réservation sont créés et modifiés dans timum, dans le calendrier de fournisseur, sur la page Réservation de rendez-vous (voir Booking Channels).

Widget d'intégration générique pour l'attribution dynamique de la ressource réservable

Pour la réservation de rendez-vous sur des sites web à contenu générique, comme des annonces immobilières, timum propose un code de widget générique. Celui-ci est intégré dans le modèle de site web pour contenu générique et configuré automatiquement pour la ressource de réservation concernée en transmettant des paramètres spécifiques.

L'intégration se compose des éléments suivants :

  1. Extrait de script générique pour le calendrier de fournisseur concerné
  2. Transmission des paramètres via un paramètre URL ou via un objet global sur la page
  3. Configuration de la mise en page et des fonctionnalités dans timum

Extrait de script générique

Vous trouverez l'extrait de code générique dans les paramètres du calendrier de fournisseur concerné :

  1. Ouvrez timum et connectez-vous.
  2. Ouvrez le calendrier de fournisseur pour lequel l'intégration au site web doit être configurée.
  3. Ouvrez Paramètres dans le menu principal.
  4. Dans la section Profil du fournisseur, vous trouverez l'encadré Intégration du site web du fournisseur. Cliquez sur Afficher le code d'intégration et sélectionnez JS Widget (ou Iframe).
  5. Cliquez sur Copier.
  6. Insérez l'extrait à l'endroit souhaité sur votre site web.

Utilisation avancée

La documentation complète pour les développeurs décrit l'extrait de script général avec toutes les options de configuration :

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

Spécification par référence de ressource et ID de personne

La transmission du paramètre de référence d'au moins une ressource timum réservable est obligatoire. Plusieurs ressources sont également possibles. Les références peuvent être générées à partir des ID de bien du système CRM ou enregistrées sous forme d'UUID timum.

De plus, l'ID de la personne provenant d'un système CRM peut être transmis en option au widget de réservation. Les clients dont les données figurent déjà dans le CRM n'ont alors plus besoin de saisir de données personnelles et peuvent réserver directement. Il est possible de demander des informations supplémentaires en configurant le formulaire de réservation. Les données collectées sont automatiquement associées à la fiche dans le CRM. Outre l'identifiant de contact (personId), un identifiant de plateforme pour le CRM concerné doit être transmis.

  • ressource réservable (ref) – obligatoire
  • client pré-identifié (pData) – facultatif
    • plateforme (système CRM)
    • personId

Liens de réservation personnalisés pour les plugins de site web intégrés

Si le lien de réservation doit être personnalisé pour chaque destinataire individuel, de sorte que la personne soit automatiquement reconnue et associée de manière fiable à la fiche dans le CRM, ajoutez des paramètres URL :

Transmission des paramètres

Il existe deux possibilités pour la transmission des paramètres, décrites ci-dessous.

Option 1 : paramètre URL

Transmission de la référence de ressource timum pour le responsable du contact (agent immobilier) et de l'ID du client (AddressID) en tant que paramètres URL vers votre propre site web, sur lequel le widget timum est intégré.

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

Exemple :

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

Option 2 : objet global sur la page

Transmission des paramètres (référence du responsable du contact et ID d'adresse) via un objet global sur le site 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' } } },
   },
 };

Configuration de la mise en page et des fonctionnalités

Lors de l'intégration en tant que widget générique, où la ressource effectivement réservable dépend du contenu d'un site web dynamique, la configuration s'effectue dans le calendrier de fournisseur sous Paramètres → Mise en page de réservation.

Niveaux et priorisation des paramètres de mise en page

Un large éventail d'options de configuration est disponible directement via l'interface utilisateur de timum. Les paramètres de configuration peuvent être définis de manière hiérarchique dans différentes zones.

Il existe une cascade de priorités pour l'application des configurations (le niveau supérieur l'emporte sur le niveau inférieur) :

  1. Paramètres URL
  2. Entrées spécifiques à l'instance dans l'objet global (clé bookingjs-<Channel-UUID>)
  3. Objet global timumBookingConfig
  4. Configuration du type de rendez-vous
  5. Configuration du canal de réservation (Booking Channel)
  6. Valeur par défaut du calendrier de fournisseur
  7. Valeur par défaut du compte

Documentation complète sur npm

Au-delà des options de configuration disponibles dans l'interface timum – ou indépendamment de celles-ci – la configuration peut également être effectuée par des développeurs web directement au sein de l'intégration elle-même.

Documentation de la configuration timum : www.npmjs.com/package/@timum/booking