Personnalisez votre widget de réservation TIMIFY: paramètres avancés
Voici ce que vous devez savoir
Si vous voulez juste savoir comment intégrer notre widget de réservation, consultez notre article Comment intégrer le widget de réservation TIMIFY dans votre site web ou CMS?
Dans cet article, nous allons dans les détails et vous montrons comment réaliser des personnalisations qui donnent des résultats vraiment impressionnants. Nous vous donnons le script dont vous avez besoin pour modifier la couleur de votre widget, présélectionner un service ou pré-remplir les coordonnées du client.
Voici comment l'article est structuré:
Options de personnalisation pour une superposition de widgets de réservation
Options de personnalisation pour un widget de réservation comme iFrame
Faites défiler la page vers le bas jusqu'à l'option de votre choix et nous vous guiderons à travers les personnalisations que nous vous proposons:
1. Options de personnalisation d'une superposition de widgets de réservation
ÉTAPE 1:
Dans TIMIFY, allez dans Intégration -> Widget de réservation -> Bouton de réservation/superposition, et sélectionnez "position flexible".
ÉTAPE 2:
La position flexible n'inclut pas l'attribut "data-id", car votre identifiant de réservation se trouve dans l'élément HTML que vous venez de définir comme bouton de réservation.
Comme vous allez modifier l'apparence et le positionnement du bouton, le paramètre "data-position" doit avoir la valeur "flexible".
Collez le code du snippet juste avant la balise </head> ou </body> de votre modèle.
ÉTAPE 3:
Définissons maintenant l'élément HTML de votre site web qui permet au navigateur d'ouvrir le widget. Vous disposez généralement de l'un des éléments HTML suivants:
Cependant, vous pouvez choisir n'importe quelle autre balise HTML pour votre bouton. Veuillez toujours noter que vous devez le faire:
ajouter une classe "timify-button" pour l'élément auquel l'extrait fait référence
ajoutez l'attribut "data-account-id=" à votre numéro d'enregistrement TIMIFY dans le champ "".
Attributs que vous pouvez ajouter à votre code pour personnaliser le widget et/ou le processus de réservation
Utilisez la liste d'attributs ci-dessous (nous avons ajouté des explications pratiques !) pour ajuster votre widget, afin de le faire apparaître exactement comme vous le souhaitez. Les attributs peuvent être intégrés aux boutons existants comme suit.
Supposons que vous souhaitiez présélectionner un service lorsqu'un certain bouton de réservation de votre page est cliqué. Dans ce cas, vous devez placer l'attribut data-service-id="5f6cbdb98e434611ef5bbf73" dans votre élément de bouton:
<div class="timify-button" data-account-id="5f6cbd042e148e11ac2acaad" data-service-id="5f6cbdb98e434611ef5bbf73">Book a massage</div>Si vous souhaitez présélectionner un service globalement pour tous vos boutons via votre code JavaScript, il vous suffit d'ajouter l'attribut au snippet TIMIFY JS snippet:
<script async
src="//book.timify.com/widget/widget.min.js"
id="timify-widget"
data-position="flexible"
data-account-id="5f6cbd042e148e11ac2acaad"
data-service-id="5f6cbdb98e434611ef5bbf73">
</script>Voici une liste de tous les attributs pris en charge pour l'intégration du widget de réservation TIMIFY en tant que superposition:
1.1 Attributs généraux et liés à la mise en page
Attributs | Description | Exemple |
data-account-id | Utilisez cette fonction pour charger votre compte ou une branche spécifique du widget. |
|
data-is-external-id | Utilisez-le pour charger une branche spécifique de votre directeur de succursale dans le widget en utilisant un identifiant externe prédéfini. data-enterprise-id. |
|
data-enterprise-id | Utilisez cette fonction pour charger le localisateur comme première étape de votre widget. Ne fonctionne que si vous avez un compte TIMIFY Branch Manager avec plus d'un emplacement. Remarque: Si vous voulez charger le localisateur, vous ne devez pas inclure l'attribut |
|
data-hide-close-button | Utilisez cette fonction pour masquer le bouton de fermeture du widget. C'est un "booléen". La valeur peut être seulement vraie ou fausse. |
|
data-fullscreen | Utilisez ceci pour ouvrir le widget en mode plein écran. C'est un "booléen". La valeur peut être seulement vraie ou fausse. |
|
data-overlay-color | Utilisez cette fonction pour modifier la couleur de fond de la couche qui recouvre votre site web lorsque le widget est déclenché (la couleur de fond derrière le widget). |
|
data-overlay-opacity | Utilisez cette fonction pour modifier l'opacité de la couleur de fond de la superposition. |
|
data-locale | Utilisez cette fonction pour présélectionner une langue spécifique pour le widget de réservation. Codes de langue disponibles: Allemand: de-de Anglais: en-gb Français: fr-fr Italien: it-it Espagnol: es-es Catalan: ca-es Néerlandais: nl-nl Danois: da-dk Norvégien: nn-no Finnois: fi-fi Suédois: sv-se Bulgare: bg-bg Polonais: pl-pl Estonien: et-ee Cymraeg (écossais): cy-gb |
|
data-position | Utilisez cette fonction pour permettre de positionner plusieurs boutons sur la même page. |
|
data-custom-button-image | Utilisez cette fonction pour remplacer le bouton standard TIMIFY qui apparaît à droite ou à gauche de votre site web par un bouton graphique individuel de votre choix. |
|
data-button-attribute | Utilisez ceci pour permettre à l'attribut |
|
data-show-company-name-in-header | Utilisez cette fonction si vous disposez de plusieurs comptes/locaux via le gestionnaire d'agence TIMIFY pour afficher le nom du lieu sélectionné dans l'outil de recherche de lieux. Il s'agit d'un booléen. |
|
1.2 Attributs liés aux services
Attributs | Description | Exemple |
data-show-services | Utilisez cette fonction pour afficher uniquement un certain nombre de services prédéfinis dans la première étape du widget de réservation. Veillez à utiliser l'identifiant du service concerné - vous le trouverez sur la page des détails du service. Vous pouvez utiliser plusieurs identifiants de service - assurez-vous simplement de les séparer par des virgules. |
|
data-show-services-external-ids | Cet attribut a la même fonction que data-show-services, mais en utilisant l’Id externe des services |
|
data-hide-services | Utilisez cette fonction pour masquer certains services prédéfinis dans la première étape du widget de réservation. Veillez à utiliser l'identifiant du service concerné - vous le trouverez sur la page des détails du service. Vous pouvez utiliser plusieurs identifiants de service - assurez-vous simplement de les séparer par des virgules. |
|
data-hide-services-external-ids | Cet attribut a la même fonction que data-hide-services, mais en utilisant l’Id externe des services |
|
data-service-id | Utilisez cette fonction pour présélectionner un service de votre choix et sautez la première étape du widget en utilisant l'identifiant du service dans TIMIFY |
|
data-service-external-ids | Utilisez cette fonction pour présélectionner un service de votre choix et sautez la première étape du widget en utilisant l'identifiant externe que vous avez défini pour celui-ci. |
|
data-course-id | Utilisez cette fonction pour présélectionner un service de groupe de votre choix et sautez la première étape du widget en utilisant l'ID du groupe. |
|
1.3 Attributs liés aux ressources
Attributs | Description | Exemple |
data-resource-id | Utilisez cette fonction pour présélectionner automatiquement une ressource de votre choix à l'aide de son ID. Remarque: Si vous utilisez cette fonction en combinaison avec l'attribut data-service-id, assurez-vous que la ressource présélectionnée est réellement affectée à ce service. |
|
data-resource-externalids | Utilisez cette fonction pour présélectionner automatiquement une ressource de votre choix à l'aide de l'identifiant externe que vous avez défini pour celle-ci. |
|
data-filter-resources | Utilisez cette fonction pour filtrer les ressources dans le widget de réservation et n'afficher que les ressources sélectionnées à l'aide de leur ID TIMIFY. |
|
data-filter-resources-by-external-id | Utilisez cette fonction pour filtrer les ressources dans le widget de réservation et n'afficher que les ressources sélectionnées à l'aide de l'ID externe que vous avez défini pour elles. |
|
data-show-selected-resource-only | Utilisez cette fonction pour afficher uniquement la ressource présélectionnée dans la vue d'ensemble des ressources. Il s'agit d'un booléen.
|
|
data-show-resources | Utilisez cette option pour écraser le paramètre de widget qui cache les ressources par défaut. Pour que cela fonctionne, vous devez d'abord aller dans Paramètres > Réservations > Widget de réservation et, de là, activer la boîte de dialogue dans la section Affichage des ressources. Cela aura pour effet de masquer par défaut vos ressources à tous les clients qui voient votre widget. Lorsque vous utilisez cet attribut, vous pouvez écraser ce paramètre et afficher le composant de sélection des ressources dans certains cas à vos clients. |
|
1.4 Attributs liés à la date
Attributs | Description | Exemple |
data-date | Utilisez cette fonction pour pré-remplir et afficher automatiquement les créneaux libres à une date précise. Remarque: Le format de la date est AAAA-MM-JJ |
|
data-date-range | Utilisez cette fonction pour filtrer une période prédéfinie pour la sélection de la date et afficher UNIQUEMENT les créneaux disponibles dans cette période. Remarque: Le format de la date est AAAA-MM-JJ:AAAA-MM-JJ. |
|
data-disable-other-dates | Utilisez cette fonction pour empêcher l'utilisateur de sélectionner une autre date que celle qui est pré-remplie. Il s'agit d'un booléen. |
|
1.5 Attributs liés au client
Attributs | Description | Exemple |
data-show-guest-booking-form | Utilisez cette fonction pour afficher uniquement la réservation d'un invité comme méthode d'authentification pour vos réservistes. Il s'agit d'un booléen. |
|
data-skip-customerfields-section | Utilisez cette fonction pour ne pas afficher le formulaire de réservation des invités et afficher directement la vue de confirmation de la réservation. |
|
data-hide-filled-fields | Utilisez cette option pour masquer les champs de données pré-remplis dans la vue d'ensemble de la réservation. Remarque : cette option fonctionne pour tous les champs de données, à l'exception des champs de données à cases à cocher. |
|
data-external-customer-id | Utilisez cette fonction pour présélectionner un client déjà existant dans TIMIFY en fournissant son identifiant externe. |
|
data-guest-firstname | Utilisez cette fonction pour pré-remplir automatiquement le prénom du réservataire dans le formulaire des invités. |
|
data-guest-lastname | Utilisez cette fonction pour pré-remplir automatiquement le nom de famille du réservataire dans le formulaire des invités. |
|
data-guest-email | Utilisez cette fonction pour pré-remplir automatiquement l'e-mail du booker dans le formulaire des invités. |
|
data-guest-phone | Utilisez cette fonction pour pré-remplir automatiquement le numéro de téléphone du réservataire dans le formulaire des invités. |
|
data-guest-phonecountry | Utilisez cette fonction pour pré-remplir automatiquement l'indicatif téléphonique du pays du réservataire dans le formulaire des invités. |
|
data-customer-field-1 | Utilisez cette fonction pour pré-remplir tout champ de données personnalisé que vous avez activé dans le formulaire de réservation. Le format est data-customer-field-1="<ID>-<VALUE>" où <ID> est l'identifiant de votre champ de données dans TIMIFY et <VALUE> est la valeur pré-remplie pour ce champ. Supposons que vous ayez un ID de membre VIP dans un champ et que vous vouliez le pré-remplir. Dans ce cas, le code ressemblera à: Si vous avez plusieurs champs de données personnalisés que vous souhaitez pré-remplir, il est important de donner à chacun d'eux un nom d'attribut unique. Ainsi, dans l'exemple ci-dessus, si je veux maintenant pré-remplir un autre champ, où je demande à mon agent de réservation quel aliment il préfère, puisque nous utilisons déjà le nom d'attribut |
|
1.6 Attributs liés à la personnalisation
Attributs | Description | Exemple |
data-customisation-id | Utilisez cette fonction pour remplacer la personnalisation par défaut du widget d'entreprise ou de société. Par exemple, vous pouvez déclencher une personnalisation spéciale du widget lorsqu'un service ou une ressource spécifique est pré-rempli. |
|
data-template-customisation-id | Utilisez cette fonction pour remplacer la personnalisation par défaut du modèle de courriel de l'entreprise ou de la société. Par exemple, vous pouvez déclencher une personnalisation spéciale du modèle d'e-mail lorsqu'un service spécifique est pré-rempli ou que vous déclenchez le widget à partir d'un support différent - disons que vous avez un widget personnalisé pour votre site web et un autre pour votre application mobile. |
|
1.7 Déclencher la reprogrammation d'une réservation spécifique
Si vous utilisez l'API TIMIFY REST et que vous souhaitez afficher tous les rendez-vous réservés qui auront lieu à l'avenir dans la section client de votre application ou site web, vos clients pourront facilement reprogrammer une réservation particulière à partir de là. Vous pouvez déclencher un processus de reprogrammation pour une réservation spécifique en fournissant à la fois l'API data-event-id and data-secret de la réservation. En général, vous les obtiendrez si vous vous êtes inscrit pour recevoir un webhook avec la portée EVENT-CREATED. Le secret pour l'annulation ou le report d'une réservation ne peut être obtenu que par le biais d'un webhook et peut être trouvé dans le metadata.
Attributs | Description | Exemple |
data-event-id | C'est l'identifiant de la réservation dans TIMIFY. |
|
data-secret | C'est le secret de la réservation dans TIMIFY. |
|
1.8 Afficher les créneaux de réservation cachés d'une pré-réservation
Dans TIMIFY, actuellement disponible uniquement via l'application Booking Links, vous pouvez pré-réserver un créneau spécifique ou une série de créneaux dans une fourchette de dates et les mettre à disposition uniquement aux clients qui ont un accès spécial à votre widget qui les révèle en analysant une clé secrète de cette pré-réservation. L'utilisation de la data-pre-reservation-key vous pouvez analyser ce secret pour le gadget et révéler les créneaux horaires autrement cachés. Imaginons que vous souhaitiez mettre le jeudi 25 octobre 2021 entre 15h00 et 17h00 à la disposition de certains de vos clients uniquement. Vous pouvez créer une pré-réservation pour ce jour et cette plage horaire et vous la bloquerez pour tous vos clients réguliers. Ensuite, en analysant la clé secrète de la pré-réservation dans votre widget de réservation, vous pouvez rendre cette date et ces plages horaires visibles uniquement pour les quelques clients sélectionnés.
Attributs | Description | Exemple |
data-pre-reservation-key | La clé secrète pour la pré-réservation. |
|
1.9 Suivi des conversions des campagnes de marketing
Si vous souhaitez savoir de quelle source, de quel média ou de quelle campagne provient une réservation, vous pouvez le faire en analysant vos paramètres UTM dans le widget de réservation. Les données seront alors affichées dans les statistiques de réservation de votre compte. Voici une liste des attributs actuellement pris en charge:
Attributs | Description | Exemple |
data-meta-utmcontent | Utilisez cet attribut pour analyser et enregistrer le contenu UTM avec la réservation. Il s'agit généralement d'un champ facultatif. Si vous avez plusieurs liens dans la même campagne, comme deux liens dans le même courriel, vous pouvez remplir cette valeur pour pouvoir les différencier. |
|
data-meta-utmsource | Utilisez cet attribut pour analyser et enregistrer la source UTM avec la réservation. Il s'agit généralement d'un paramètre obligatoire et il est utilisé pour identifier le site qui a envoyé le trafic et effectué la conversion. |
|
data-meta-utmmedium | Utilisez cet attribut pour analyser et enregistrer le support UTM avec la réservation. Il est généralement utilisé pour identifier le type de lien utilisé, par exemple le coût par clic ou par e-mail. |
|
data-meta-utmcampaign | Utilisez cet attribut pour analyser et enregistrer la campagne UTM avec la réservation. Cet attribut est généralement utilisé pour identifier une promotion de produit spécifique ou une campagne stratégique. |
|
data-meta-utmterm | Utilisez cet attribut pour analyser et enregistrer le terme de recherche UTM avec la réservation. Cet attribut est généralement utilisé pour identifier le terme de recherche dans les annonces Google. |
|
2. Options de personnalisation pour un widget de réservation iFrame
Pour voir un exemple en direct de la façon dont un utilisateur a personnalisé son widget iFrame, cliquez here
L'extrait de code pour l'iFrame devrait ressembler à ceci:
<iframe src="https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideCloseButton=true" style="border:0px #ffffff none;" name="myTimifyWidget" scrolling="no" frameborder="0" marginheight="0px" marginwidth="0px" height="800px" width="700px" allowfullscreen></iframe>Copiez et collez ce code dans le HTML de la page où vous souhaitez que le widget apparaisse sur votre page. N'oubliez pas d'ajuster l'URL dans l'attribut "src" en fonction de votre compte en utilisant le accountId individuel de votre compte TIMIFY. Vous pouvez également modifier la hauteur et la largeur de l'iFrame en changeant les valeurs des paramètres ("height" ou "width") dans le code ci-dessus.
Grâce aux paramètres suivants, vous pouvez effectuer des personnalisations supplémentaires dans votre widget et adapter parfaitement le processus de réservation à vos besoins.
Un paramètre est toujours ajouté avec un "&" à l'URL du widget existant. Supposons que vous souhaitiez masquer le bouton de fermeture du widget lorsqu'un de vos clients ouvre le lien du widget. Dans ce cas, vous devez ajouter le paramètre &hideCloseButton=true. Voici à quoi ressemblerait votre lien:
https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideCloseButton=true2.1 Paramètres généraux et relatifs à la mise en page
Paramètres | Description | Exemple |
accountId | Utilisez cette fonction pour charger votre compte ou une branche spécifique du widget. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad |
companyExternalId | Utilisez cette fonction pour charger une branche spécifique de votre compte de directeur de branche dans le widget en utilisant un identifiant externe prédéfini. Remarque: Il doit toujours être combiné avec le paramètre "enterpriseId". | https://book.timify.com/services?enterpriseId=5c79487bed89503cfac758b3&companyExternalId=branch07 |
enterpriseId | Utilisez cette fonction pour charger le localisateur comme première étape de votre widget. Ne fonctionne que si vous disposez d'un compte TIMIFY Branch Manager avec plus d'une localisation. | https://book.timify.com/locations?enterpriseId=5c79487bed89503cfac758b3 |
showLocations | Utilisez cette option pour charger des lieux spécifiques dans la recherche de lieux du widget. | |
hideCloseButton | Utilisez cette fonction pour masquer le bouton de fermeture du widget. C'est un "booléen". La valeur peut être seulement true ou false. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideCloseButton=true |
fullscreen | Utilisez ceci pour ouvrir le widget en mode plein écran. C'est un "booléen". La valeur ne peut être que true ou false. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&fullscreen=true |
overlayColor | Utilisez cette fonction pour changer la couleur de fond derrière le widget. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368 |
overlayOpacity | Utilisez cette fonction pour modifier l'opacité de la couleur de fond derrière le widget. | |
locale | Utilisez cette fonction pour présélectionner une langue spécifique pour le widget de réservation. Français: Italien: Espagnol: Néerlandais: Danois: Bulgare: | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&locale=da-dk |
showCompanyNameInHeader | Utilisez cette fonction si vous disposez de plusieurs comptes/locaux via le gestionnaire d'agence TIMIFY pour afficher le nom du lieu sélectionné dans l'outil de recherche de lieux. Il s'agit d'un booléen. | https://book.timify.com/locations?enterpriseId=5c79487bed89503cfac758b3&showCompanyNameInHeader=true |
2.2 Paramètres liés aux services
Paramètres | Description | Exemple |
showServices | Utilisez cette fonction pour afficher uniquement un certain nombre de services prédéfinis dans la première étape du widget de réservation. Veillez à utiliser l'identifiant du service concerné - vous le trouverez sur la page des détails du service. Vous pouvez utiliser plusieurs identifiants de service - assurez-vous simplement de les séparer par des virgules. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&showServices=5f6cbdb98e434611ef5bbf73 |
showServicesExternalIds | Cet attribut a la même fonction que showServices, mais en utilisant l’Id externe des services | |
hideServices | Utilisez cette fonction pour masquer certains services prédéfinis dans la première étape du widget de réservation. Veillez à utiliser l'identifiant du service concerné - vous le trouverez sur la page des détails du service. Vous pouvez utiliser plusieurs identifiants de service - assurez-vous simplement de les séparer par des virgules. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideServices=5f6d9ceeda9f6046487ed20b |
hideServicesExternalIds | Cet attribut a la même fonction que hideServices, mais en utilisant l’Id externe des services | |
serviceId | Utilisez cette fonction pour présélectionner un service de votre choix et passer la première étape du widget. | |
serviceExternalIds | Utilisez cette fonction pour présélectionner un service de votre choix et sautez la première étape du widget en utilisant l'identifiant externe que vous avez défini pour celui-ci. | https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&serviceExternalIds=service03 |
courseId | Utilisez cette fonction pour présélectionner un service de groupe de votre choix et sautez la première étape du widget en utilisant l'ID du groupe. |
2.3 Paramètres liés aux ressources
Paramètres | Description | Exemple |
resourceId | Utilisez cette fonction pour présélectionner automatiquement une ressource de votre choix. | |
resourceExternalIds | Utilisez cette fonction pour présélectionner automatiquement une ressource de votre choix à l'aide de l'identifiant externe que vous avez défini pour celle-ci. Remarque: si vous l'utilisez en combinaison avec l'attribut | https://book.timify.com/conflict?accountId=5f6cbd042e148e11ac2acaad&resourceExternalIds=room02 |
filterResources | Utilisez cette fonction pour filtrer les ressources dans le widget de réservation et n'afficher que les ressources sélectionnées à l'aide de leur ID TIMIFY. | |
filterResourcesbyExternalId | Utilisez cette fonction pour filtrer les ressources dans le widget de réservation et n'afficher que les ressources sélectionnées à l'aide de l'ID externe que vous avez défini pour elles. | |
showSelectedResourcesOnly | Utilisez cette fonction pour afficher uniquement la ressource présélectionnée dans la vue d'ensemble des ressources. Il s'agit d'un booléen. | |
showResources | Utilisez cette option pour écraser le paramètre de widget qui cache les ressources par défaut. Pour que cela fonctionne, vous devez d'abord aller dans Paramètres > Réservations > Widget de réservation et, de là, activer la boîte de dialogue dans la section Affichage des ressources. Cela aura pour effet de masquer par défaut vos ressources à tous les clients qui voient votre widget. Lorsque vous utilisez cet attribut, vous pouvez écraser ce paramètre et afficher le composant de sélection des ressources dans certains cas à vos clients. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&showResources=true |
2.4 Paramètres liés à la date
Paramètres | Description | Exemple |
date | Utilisez cette fonction pour pré-remplir et afficher automatiquement les créneaux libres à une date précise. | https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&date=2021-08-17 |
dateRange | Utilisez cette fonction pour filtrer une période prédéfinie pour la sélection de la date et afficher UNIQUEMENT les créneaux disponibles dans cette période. Remarque: Le format de la date est AAAA-MM-JJ:AAAA-MM-JJ. | |
disableOtherDates | Utilisez cette fonction pour empêcher l'utilisateur de sélectionner une autre date que celle qui est pré-remplie. Il s'agit d'un booléen. |
2.5 Paramètres liés aux clients
Paramètres | Description | Exemple |
showGuestBookingForm | Utilisez cette fonction pour afficher uniquement la réservation d'un invité comme méthode d'authentification pour vos réservistes. Il s'agit d'un booléen. | https://book.timify.com/customer-fields?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true |
skipCustomerFieldsSection | Utilisez cette fonction pour ne pas afficher le formulaire de réservation des invités et afficher directement la vue de confirmation de la réservation. | |
hideFilledFields | Utilisez cette option pour masquer les champs de données pré-remplis dans la vue d'ensemble de la réservation. Remarque : cette option fonctionne pour tous les champs de données, à l'exception des champs de données à cases à cocher. | |
externalCustomerId | Utilisez cette fonction pour présélectionner un client déjà existant dans TIMIFY en fournissant son identifiant externe. | https://book.timify.com/success?accountId=5f6cbd042e148e11ac2acaad&externalCustomerId=customer-123 |
hideExternalCustomerFields | Vous pouvez utiliser ce paramètre pour masquer les champs de données de votre formulaire de réservation. Format : hideExternalCustomerFields=externalId1,externalId2,... Vous pouvez utiliser une séparation par virgule pour lister tous les champs de données externes que vous souhaitez masquer. Les champs de données activés comme obligatoires dans le formulaire de réservation ne seront pas masqués. | |
guestFirstName | Utilisez cette fonction pour pré-remplir automatiquement le prénom du réservataire dans le formulaire des invités. | |
guestLastName | Utilisez cette fonction pour pré-remplir automatiquement le nom de famille du réservataire dans le formulaire des invités. | |
guestEmail | Utilisez cette fonction pour pré-remplir automatiquement l'e-mail du booker dans le formulaire des invités. | |
guestPhone | Utilisez cette fonction pour pré-remplir automatiquement le numéro de téléphone du réservataire dans le formulaire des invités. | |
guestPhoneCountry | Utilisez cette fonction pour pré-remplir automatiquement le code pays du téléphone de l'appelant dans le formulaire de l'invité: | |
customerField[ID] | Utilisez cette fonction pour pré-remplir tout champ de données personnalisé que vous avez activé dans le formulaire de réservation. | |
hideCustomerFields | Vous pouvez utiliser ce paramètre pour masquer les champs de données de votre formulaire de réservation. Format : hideCustomerFields=ID1,ID2,... Vous pouvez utiliser une séparation par virgule pour lister tous les champs de données que vous souhaitez masquer. Les champs de données activés comme obligatoires dans le formulaire de réservation ne seront pas masqués. |
2.6 Paramètres liés aux personnalisations
Paramètres | Description | Exemple |
customisationId | Utilisez cette fonction pour remplacer la personnalisation par défaut du widget d'entreprise ou de société. Par exemple, vous pouvez déclencher une personnalisation spéciale du widget lorsqu'un service ou une ressource spécifique est pré-rempli. | |
templatesCustomisationId | Utilisez cette fonction pour remplacer la personnalisation par défaut du modèle de courriel de l'entreprise ou de la société. Par exemple, vous pouvez déclencher la personnalisation d'un modèle d'e-mail spécial lorsqu'un service spécifique est pré-rempli ou lorsque vous déclenchez le widget à partir d'un support différent - disons que vous avez un widget personnalisé pour votre site web et un autre pour votre application mobile. |
2.7 Déclencher la reprogrammation d'une réservation spécifique
Si vous utilisez l'API TIMIFY REST et que vous souhaitez afficher tous les rendez-vous réservés qui auront lieu à l'avenir dans la section client de votre application ou site web, vos clients pourront facilement reprogrammer une réservation particulière à partir de là. Vous pouvez déclencher un processus de reprogrammation pour une réservation spécifique en fournissant à la fois eventId et secret de la réservation. En général, vous les obtiendrez si vous vous êtes inscrit pour recevoir un webhook avec la portée EVENT-CREATED. Le secret de l'annulation ou de la reprogrammation ne peut être obtenu que via le webhook et se trouve dans les metadata.
Paramètres | Description | Exemple |
eventId | C'est l'identifiant de la réservation dans TIMIFY. Ce paramètre ne fonctionne qu'en combinaison avec | |
secret | C'est le secret de la réservation dans TIMIFY. Ce paramètre ne fonctionne qu'en combinaison avec |
2.8 Afficher les créneaux de réservation cachés d'une pré-réservation
Dans TIMIFY, actuellement disponible uniquement via l'application Booking Links, vous pouvez pré-réserver un créneau spécifique ou une série de créneaux dans une fourchette de dates et les mettre à disposition uniquement aux clients qui ont un accès spécial à votre widget qui les révèle en analysant une clé secrète de cette pré-réservation. L'utilisation de la preReservationKey vous pouvez analyser ce secret pour le gadget et révéler les créneaux horaires autrement cachés. Imaginons que vous souhaitiez mettre le jeudi 25 octobre 2021 entre 15h00 et 17h00 à la disposition de certains de vos clients uniquement. Vous pouvez créer une pré-réservation pour ce jour et cette plage horaire et vous la bloquerez pour tous vos clients réguliers. Ensuite, en analysant la clé secrète de la pré-réservation dans votre widget de réservation, vous pouvez rendre cette date et ces plages horaires visibles uniquement pour les quelques clients sélectionnés.
Paramètres | Description | Exemple |
preReservationKey | La clé secrète pour la pré-réservation. |
2.9 Suivi des conversions des campagnes de marketing
Si vous souhaitez savoir de quelle source, de quel média ou de quelle campagne provient une réservation, vous pouvez le faire en analysant vos paramètres UTM dans le widget de réservation. Les données seront alors affichées dans les statistiques de réservation de votre compte ou si vous utilisez notre outil Branch Manager dans le tableau de bord des statistiques. Voici une liste des attributs actuellement pris en charge:
Paramètres | Description | Exemple |
meta[utmcontent] | Utilisez cet attribut pour analyser et enregistrer le contenu UTM avec la réservation. Il s'agit généralement d'un champ facultatif. Si vous avez plusieurs liens dans la même campagne, comme deux liens dans le même courriel, vous pouvez remplir cette valeur pour pouvoir les différencier. | https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&meta[utmcontent]=HeaderLink |
meta[utmsource] | Utilisez cet attribut pour analyser et enregistrer la source UTM avec la réservation. Il s'agit généralement d'un paramètre obligatoire et il est utilisé pour identifier le site qui a envoyé le trafic et effectué la conversion. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmsource]=Google |
meta[utmmedium] | Utilisez cet attribut pour analyser et enregistrer le support UTM avec la réservation. Il est généralement utilisé pour identifier le type de lien utilisé, par exemple le coût par clic ou par e-mail. | https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmmedium]=cpc |
meta[utmcampaign] | Utilisez cet attribut pour analyser et enregistrer le Campagin UTM avec la réservation. Cet attribut est généralement utilisé pour identifier une promotion de produit spécifique ou une campagne stratégique. | |
meta[utmterm] | Utilisez cet attribut pour analyser et enregistrer le terme de recherche UTM avec la réservation. Cet attribut est généralement utilisé pour identifier le terme de recherche dans les annonces Google. |
3. Options de personnalisation grâce à notre API REST
Pour une conception individuelle du widget de réservation en fonction de votre charte graphique et des flux de réservation, ainsi que pour une intégration (profonde) dans votre infrastructure informatique, nous offrons la possibilité de construire et de personnaliser le widget de réservation TIMIFY via l'interface API.
Comme vous avez accès à notre plate-forme de développement et aux références API pertinentes qu'elle contient, une formation au produit avec notre équipe informatique est nécessaire au préalable.