Référencement des entités

Cette page explique comment référencer BookingJs, le widget de réservation timum, avec des ressources et des canaux – via une référence de canal, de ressource ou de produit.

Aperçu

Il existe trois types de références différents que vous pouvez transmettre au widget. Chacun a des effets différents sur les rendez-vous affichés.

Channel Reference

Les Resource Channels sont des entités dans timum, dont chacune stocke une configuration qui modifie l'expérience de réservation pour les clients. Chaque ressource dispose de quatre canaux que les utilisateurs peuvent transmettre à leurs clients via un lien.

timum.init({ ref: 'channel-reference@provider' });

Resource Reference

Une référence qui pointe vers une ressource dont le canal est inconnu. Le canal par défaut (et sa configuration correspondante) est utilisé.

timum.init({ ref: 'resource-reference@provider' });

Resource Reference avec channelKey

Si vous ne disposez pas d'une référence de canal mais souhaitez utiliser un canal autre que celui par défaut, vous pouvez indiquer une combinaison de référence de ressource et de channelKey.

timum.init({
  ref: 'resource-reference@provider',
  channelKey: 'RESOURCE_EXCLUSIVE'
});

Valeurs channelKey disponibles

Priorités des références

Le tableau suivant montre comment BookingJs traite différentes combinaisons de références :

Références de produit (prdRefs)

Avec prdRefs, vous pouvez définir quels produits (types de rendez-vous) sont proposés au choix du client.

timum.init({
  ref: 'resource-reference@provider',
  prdRefs: 'besichtigung' // Afficher uniquement ce produit
});

// Ou plusieurs produits
timum.init({
  ref: 'resource-reference@provider',
  prdRefs: ['besichtigung', 'beratung']
});

Références de créneau (tslRefs)

Pour les scénarios où seuls certains rendez-vous doivent être partagés, vous pouvez utiliser tslRefs.

timum.init({
  tslRefs: ['timeslot-uuid-1', 'timeslot-uuid-2']
});

Multi-Resource Widget

Vous pouvez également proposer plusieurs ressources dans un seul widget :

timum.init({
  ref: ['resource-1@provider', 'resource-2@provider', 'resource-3@provider'],
  allResourcesOption: true // Afficher l'option "Tous"
});

Pour les utilisateurs

• Qu'est-ce qu'une ressource ?
• Qu'est-ce qu'un type de rendez-vous ?
• Resource Channels

Sujets connexes

• Configuration
• Identification du client