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é:

  1. Options de personnalisation pour une superposition de widgets de réservation

  2. Options de personnalisation pour un widget de réservation comme iFrame

  3. Options de personnalisation grâce à notre API REST

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-account-id="5f6cbd042e148e11ac2acaad"

data-is-external-id
OU
data-company-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.
Remarque: Fonctionne uniquement en combinaison avec l'attribut

data-enterprise-id.

data-is-external-id="branch07"

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-account-id

data-enterprise-id="5c79487bed89503cfac758b3"

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-hide-close-button="true"

OR

data-hide-close-button="false"

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-fullscreen="true"

OR

data-fullscreen="false"

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).

Remarque: utilisez toujours les codes de couleur HEX. Si vous ne connaissez pas votre code HEX, vous pouvez en générer un à partir d'ici.

data-overlay-color="#F09368"

data-overlay-opacity

Utilisez cette fonction pour modifier l'opacité de la couleur de fond de la superposition.

data-overlay-opacity="0.2"

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-locale="fr-fr"

data-position

Utilisez cette fonction pour permettre de positionner plusieurs boutons sur la même page.

data-position="multiple"

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.

Remarque: le graphique doit être téléchargé sur un serveur FTP et l'URL doit être ajoutée comme valeur à cet attribut.

data-custom-button-image="https://www.yourwebsite.com/images/button.jpg"

data-button-attribute

Utilisez ceci pour permettre à l'attribut data-account-id pour être renommé. Par exemple, vous pouvez remplacer data-account-id=“your-TIMIFY-Company-ID" avec timify-id="your-TIMIFY-Company-ID”

data-button-attribute="data-account-id"

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.

data-show-company-name-in-header=“true”

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="5f6cbdb98e434611ef5bbf73"

OU

data-show-services="5f6cbdb98e434611ef5bbf73,5f6cc872471ac511d7e7afe4"

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-show-services-external-ids="service01,service03"

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="5f6cbdb98e434611ef5bbf73"

OR

data-hide-services="5f6cbdb98e434611ef5bbf73,5f6cc872471ac511d7e7afe4"

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-hide-services-external-ids="service01,service03"

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-id="5f6cbdb98e434611ef5bbf73"

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-service-external-ids="service03"

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.

data-course-id="5f6d9ceeda9f6046487ed20b"

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-id="5f6ebc35533f6711c4c2e545"

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.
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="room1"

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="5f72f486cfaace11d20d64bd,5f6cbe07d07c8611aae6b1dd"

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-filter-resources-by-external-id="room01,room03"

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.


Remarque: ne fonctionne qu'en combinaison avec data-resource-id et data-resource-externalids.

data-show-selected-resource-only="true"

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.

data-show-resources="true"

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="2021-05-17"

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-date-range="2021-05-17:2021-05-23"

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.

data-disable-other-dates="true"

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-show-guest-booking-form="true"

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.
Remarque: Cela ne fonctionne que si vous avez pré-rempli tous les champs de données nécessaires dans le formulaire en utilisant les paramètres ci-dessous. Si l'un des champs de données n'est pas pré-rempli (même s'il n'est pas obligatoire), le formulaire s'affiche et l'agent de réservation est invité à remplir les informations.

data-skip-customerfields-section="true"

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-hide-filled-fields="true"

data-external-customer-id

Utilisez cette fonction pour présélectionner un client déjà existant dans TIMIFY en fournissant son identifiant externe.

data-external-customer-id="CONT-19991882-CRM2"

data-guest-firstname

Utilisez cette fonction pour pré-remplir automatiquement le prénom du réservataire dans le formulaire des invités.

data-guest-firstname="Max"

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-lastname="Smith"

data-guest-email

Utilisez cette fonction pour pré-remplir automatiquement l'e-mail du booker dans le formulaire des invités.

data-guest-email="maxsmithdemotest@gmail.com"

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.
Remarque: N'incluez pas de 0 ou de + ni d'espaces vides, mais seulement le nombre sans le code du pays. Si vous avez un code d'opérateur local / mobile, par exemple 0179 77 88 99, la valeur doit ressembler à ceci 179778899

data-guest-phone="1786655322"

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.

Ce sont les valeurs actuellement autorisées par la norme ISO 3166-1 Alpha-2-code:

‘fi’, ‘ae’, ‘ar’, ‘at’, ‘au’, ‘be’, ‘bn’, ‘br’, ‘bg’, ‘ca’, ‘us’, ‘ch’, ‘cn’, ‘cz’, ‘de’, ‘dk’, ‘eg’, ‘es’, ‘ee’, ‘fr’, ‘gb’, ‘gr’, ‘hk’, ‘hr’, ‘hu’, ‘id’, ‘ie’, ‘in’, ‘il’, ‘it’, ‘jp’, ‘kr’, ‘lu’, ‘mo’, ‘mt’, ‘mx’, ‘my’, ‘nl’, ‘no’, ‘ph’, ‘pl’, ‘pt’, ‘ro’, ‘ru’, ‘sa’, ‘sg’, ‘sk’, ‘se’, ‘th’, ‘tr’, ‘tw’, ‘co’, ‘cl’

Pour en savoir plus sur les valeurs des codes pays de l'ISO 3166-1 here.

data-guest-phonecountry="de"

data-customer-field-1
data-customer-field-2
data-customer-field-N

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 à:

data-customer-field-1="5f6cbe62587de011ff6c68f7-MemberID9998881"

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 data-customer-field-1 nous devrons simplement remplacer le numéro à la fin par data-customer-field-2.

Si vous utilisez comme type de champ de données une case à cocher, la valeur doit être remplacée simplement par true.

data-customer-field-1="5f6cbe62587de011ff6c68f7-MemberID9998881"

data-customer-field-2="5f6cbd052e148e11ac2acac1-vegetarian"

data-customer-field-3="5f6cbd052e148e11ac2acab9-true"

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-customisation-id="5dd6a2fcfefe8710f1d45ba6"

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.

data-template-customisation-id="5de4f70480e1ae10f731a56c"

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-event-id="5f748b0296782111e4eed9e9"

data-secret

C'est le secret de la réservation dans TIMIFY.

data-secret="5e1c4da96456f911e04bc18c-xx991882owks00921ms0923109381872m8dn3872nmds983kksiahdhd"

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.

data-pre-reservation-key="882owks00921ms0923109381872m8dn3872nmds983kksi"

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-utmcontent="HeaderLink"

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-utmsource="Google"

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-utmmedium="cpc"

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-utmcampaign="spring_promotion"

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.

data-meta-utmterm="contact lenses+consultation"


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=true

2.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

OU

iscompanyExternalId (déprécié)

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.

Remarque: Si vous voulez charger le localisateur, vous ne devez pas inclure l'attribut data-account-id.

https://book.timify.com/locations?enterpriseId=5c79487bed89503cfac758b3

showLocations

Utilisez cette option pour charger des lieux spécifiques dans la recherche de lieux du widget.

https://book.timify.com/locations?enterpriseId=5c79487bed89503cfac758b3&showLocations=62e7ea9e9756ea5f1dca6176,62e7eb09dd179083b9030a30

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.

Remarque: Utilisez toujours les codes de couleur HEX. Si vous ne connaissez pas votre code HEX, vous pouvez en générer un à partir here.

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.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368&overlayOpacity=0.2

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 (Écosse): cy-gb

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

OR

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&showServices=5f6cbdb98e434611ef5bbf73,5f6cc872471ac511d7e7afe4

showServicesExternalIds

Cet attribut a la même fonction que showServices, mais en utilisant l’Id externe des services

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368&overlayOpacity=0.2&showServicesExternalIds=service01,service03

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

OR

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideServices=5f6d9ceeda9f6046487ed20b,5f6cbdb98e434611ef5bbf73

hideServicesExternalIds

Cet attribut a la même fonction que hideServices, mais en utilisant l’Id externe des services

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368&overlayOpacity=0.2&hideServicesExternalIds=service01,service03

serviceId

Utilisez cette fonction pour présélectionner un service de votre choix et passer la première étape du widget.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&serviceId=5f6cbdb98e434611ef5bbf73

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.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&courseId=5f6d9ceeda9f6046487ed20b

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. data-service-id s'assurer que la ressource présélectionnée est réellement affectée à ce service.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&resourceId=5f6ebc35533f6711c4c2e545

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 data-service-id s'assurer que la ressource présélectionnée est réellement affectée à ce service.

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.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&filterResources=5f72f486cfaace11d20d64bd,5f6cbe07d07c8611aae6b1dd

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.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&filterResourcesbyExternalId=room01,room03

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.

Remarque: ne fonctionne qu'en combinaison avec data-resource-id et data-resource-externalids.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&showSelectedResourcesOnly=true&resourceId=5f6ebc35533f6711c4c2e545

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.
Remarque: Le format de la date est AAAA-MM-JJ

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.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&dateRange=2021-08-05:2021-08-09

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.

https://book.timify.com/auth?accountId=5f6cbd042e148e11ac2acaad&date=2021-08-17&disableOtherDates=true

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.
Remarque: Cela ne fonctionne que si vous avez pré-rempli tous les champs de données nécessaires dans le formulaire en utilisant les paramètres ci-dessous et que vous utilisez le paramètre showGuestBookingForm. Si l'un des champs de données n'est pas pré-rempli (même s'il n'est pas obligatoire), le formulaire sera affiché et le réservataire sera invité à remplir les informations.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestFirstName=Max&guestLastName=Smith&guestEmail=maxsmithdemo@gmail.com&guestPhone=1765544321&guestPhoneCountry=de&customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777&skipCustomerFieldsSection=true

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.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&guestFirstName=Max&=hideFilledFields

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.

https://book.timify.com/accountId=5f6cbd042e148e11ac2acaad&hideExternalCustomerFields=memberid&externalCustomerField[memberid]=MemberID999888777&skipCustomerFieldsSection=true

guestFirstName

Utilisez cette fonction pour pré-remplir automatiquement le prénom du réservataire dans le formulaire des invités.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestFirstName=Max

guestLastName

Utilisez cette fonction pour pré-remplir automatiquement le nom de famille du réservataire dans le formulaire des invités.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestLastName=Smith

guestEmail

Utilisez cette fonction pour pré-remplir automatiquement l'e-mail du booker dans le formulaire des invités.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestEmail=maxsmithdemo@gmail.com

guestPhone

Utilisez cette fonction pour pré-remplir automatiquement le numéro de téléphone du réservataire dans le formulaire des invités.
Remarque: Ne pas inclure de 0 ou de + ou d'espaces vides, mais seulement le nombre sans le code du pays. Si vous avez un code d'opérateur local / mobile, par exemple 0179 77 88 99, la valeur devrait ressembler à ceci 179778899

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestPhone=1765544321&guestPhoneCountry=de

guestPhoneCountry

Utilisez cette fonction pour pré-remplir automatiquement le code pays du téléphone de l'appelant dans le formulaire de l'invité:

‘fi’, ‘ae’, ‘ar’, ‘at’, ‘au’, ‘be’, ‘bn’, ‘br’, ‘bg’, ‘ca’, ‘us’, ‘ch’, ‘cn’, ‘cz’, ‘de’, ‘dk’, ‘eg’, ‘es’, ‘ee’, ‘fr’, ‘gb’, ‘gr’, ‘hk’, ‘hr’, ‘hu’, ‘id’, ‘ie’, ‘in’, ‘il’, ‘it’, ‘jp’, ‘kr’, ‘lu’, ‘mo’, ‘mt’, ‘mx’, ‘my’, ‘nl’, ‘no’, ‘ph’, ‘pl’, ‘pt’, ‘ro’, ‘ru’, ‘sa’, ‘sg’, ‘sk’, ‘se’, ‘th’, ‘tr’, ‘tw’, ‘co’, ‘cl’

Pour en savoir plus sur les valeurs des codes pays de l'ISO 3166-1 here.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestPhone=1765544321&guestPhoneCountry=de

customerField[ID]

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 customerField[ID]=VALUE où <ID> est l'identifiant de votre champ de données dans TIMIFY et la VALUE est la valeur pré-remplie pour ce champ. Supposons que vous ayez un champ VIP Member ID et que vous souhaitiez le pré-remplir. Dans ce cas, le code ressemblera à:

customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777

Si vous utilisez comme type de champ de données une case à cocher, la valeur doit être remplacée simplement par true.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777&skipCustomerFieldsSection=true

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.

https://book.timify.com/accountId=5f6cbd042e148e11ac2acaad&hidelCustomerFields=5f6cbe62587de011ff6c68f7&customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777&skipCustomerFieldsSection=true

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.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&customisationId=5dd3b016a5c46410e5568fac

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.

https://book.timify.com/success?accountId=5f6cbd042e148e11ac2acaad&templatesCustomisationId=5de4f70480e1ae10f731a56c

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.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&eventId=5f75e3295b3aa811f85822e9&secret=3fcd6975-3620-4874-a314-e07d7dd4dd71

secret

C'est le secret de la réservation dans TIMIFY. Ce paramètre ne fonctionne qu'en combinaison avec eventId.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&eventId=5f75e3295b3aa811f85822e9&secret=3fcd6975-3620-4874-a314-e07d7dd4dd71

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.

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.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmcampaign]=spring-promotion

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.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmterm]=contactlenses+consultation


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.