Intégrer le widget à votre site
Cette page s’adresse à qui construit votre site. Au-delà de l’intégration en un copier-coller décrite dans Installer le widget sur votre site, le widget s’ouvre depuis vos propres boutons, se pré-remplit avec un contexte de réservation et peut ramener le client sur votre site après la réservation.
Ces intégrations relèvent du code. Leur référence complète — l’API JavaScript
ServiceWidget, les attributs data-*, les paramètres d’URL, les événements et la
reconnaissance d’un client déjà connecté — vit dans la documentation développeur,
et non ici. Confiez cette page à la personne qui gère votre site.
La documentation développeur
Section intitulée « La documentation développeur »Tout est rassemblé sur docs.useservice.app :
- Ajouter le widget en JavaScript
— charger le widget par script ou le piloter avec
ServiceWidget.create(), l’ouvrir et le fermer depuis vos boutons. - Choisir une intégration — comparer les modes d’affichage et ce que chacun peut porter.
- Transmettre un contexte — pré-positionner la date, l’heure, le nombre de personnes ou la zone.
- Liens profonds — porter ce même contexte dans une URL, pour un email, un SMS ou un QR code.
- Reconnaître le client — signer un jeton pour que le widget sache qui réserve, et gérer les domaines de retour vers votre site.
- Événements — réagir dans votre code quand une réservation est créée ou confirmée.
Ne faites jamais transiter de coordonnées personnelles dans une URL : le nom, l’email et le téléphone passent par le canal signé décrit dans Reconnaître le client.