timum

Intégration générique de site web

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

Dans timum, il est possible de créer autant de widgets de site web et de liens de réservation configurés individuellement que vous le souhaitez. Un tel package de configuration, qui comprend toujours un lien de réservation individuel et simultanément un extrait de code pour l'intégration sur le site web, s'appelle un canal de réservation ou Provider Channel . La configuration peut être ajusté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 au sein d'un calendrier d'équipe (fournisseurs) sur la page Réservation de rendez-vous.

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

Pour la réservation de rendez-vous sur des sites web à contenu générique, comme les annonces immobilières, un code de widget générique est disponible dans timum. Celui-ci est intégré dans le modèle de site web pour les contenus génériques et configuré automatiquement pour des ressources de réservation spécifiques par la transmission de paramètres spécifiques.

L'intégration se compose des composants suivants :

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

Extrait de script générique

L'extrait de code générique est disponible dans les paramètres du fournisseur respectif (calendrier d'équipe) :

  1. Ouvrez timum et connectez-vous.
  2. Ouvrez le profil du calendrier (calendrier d'équipe) pour lequel une intégration de site web doit être configurée.
  3. Ouvrez les Paramètres dans le menu principal.
  4. Dans la section Profil du fournisseur (Profil du calendrier), vous trouverez le volet « Intégration du site web du fournisseur ».
  5. Copiez l'extrait de code JS Widget.
  6. Insérez l'extrait de code dans le site web à l'emplacement souhaité.

Application spéciale avancée

L'extrait de script général avec toutes les options de configuration est documenté dans la documentation complète pour les développeurs :

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

Spécification via la référence de ressource et l'identifiant de personne

Il est obligatoire de transmettre le paramètre de référence d'au moins une ressource timum réservable. Plusieurs ressources sont également possibles. Les références peuvent être générées à partir des identifiants d'objet du système CRM ou stockées en tant qu'UUID dans timum.

De plus, des identifiants de personne d'un système CRM peuvent optionnellement être transmis au widget de réservation pour créer une expérience personnalisée confortable pour les clients dont les données sont déjà dans le CRM. Aucune saisie de données personnelles n'est requise pour la réservation de rendez-vous ; il est possible de réserver directement. La demande de données et d'informations supplémentaires est possible grâce à la configuration du formulaire de réservation. Les données collectées sont automatiquement assignées à l'enregistrement dans le CRM. En plus de l'identifiant de contact (addressid), un identifiant de plateforme pour le CRM spécifique doit être transmis.

  • ressource réservable (ref) - obligatoire
  • client pré-identifié (pData) - optionnel
    • plateforme (système CRM)
    • addressid

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, afin que la personne soit automatiquement reconnue et reliée de manière fiable à l'enregistrement dans le CRM, des paramètres d'URL doivent être ajoutés :

Transmission de paramètres

Il existe deux options générales pour la transmission de paramètres, qui sont décrites ci-dessous.

Option 1 : Paramètre d'URL

Transmission des paramètres de la référence de ressource timum pour le gestionnaire d'adresse (agent immobilier) et de l'identifiant client (AddressID) en tant que paramètres d'URL vers votre propre site web dans 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 en page

Transmission des paramètres, référence du gestionnaire d'adresse et identifiant d'adresse via un objet global dans 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 la zone Paramètres du calendrier d'équipe (fournisseur) sur la sous-page « 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 les interfaces utilisateur dans timum. Les valeurs par défaut de configuration peuvent être définies hiérarchiquement dans différents domaines.

Il existe une cascade de priorités pour l'application des configurations :

  1. Paramètres d'URL
  2. Configuration spéciale bookingjs-other via l'objet global inPage (bookingjs-other-uuid)
  3. Objet global timumBookingConfig
  4. Product config
  5. Provider Channel Config
  6. Provider Default Config
  7. Account Default Config

Documentation générale étendue sur npm

Au-delà ou indépendamment des options de configuration au sein des interfaces timum, 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