BillyDocumentation
Intégrer votre widget

Intégrer le widget Billy sur Webflow

Ajoutez la billetterie Billy à un site Webflow, directement dans la page ou dans une fenêtre pop-up.

Vous avez un site web créé avec Webflow ? Bonne nouvelle, ajouter votre billetterie Billy est simple et rapide !

Le widget Billy permet à vos fans d'acheter leurs billets directement sur votre site, sans redirection, sans confusion et sans prise de tête technique.

Vous avez deux options d'intégration

Option 1 : Intégration directe (sur une page)

Le module de paiement Billy apparaît directement sur votre page événement, afin que vos fans puissent consulter et acheter leurs billets au même endroit.

La billetterie Billy intégrée directement dans une page événement Webflow

Option 2 : Fenêtre pop-up

Le module de paiement Billy s'ouvre dans une fenêtre pop-up élégante lorsque les visiteurs cliquent sur le bouton "Acheter maintenant", idéal pour garder une mise en page simple et claire.

La billetterie Billy ouverte dans une fenêtre pop-up au-dessus d'une page Webflow

Quelle que soit l'option choisie, vos fans peuvent finaliser leur achat sans quitter votre site web.

Résultat :

  • Une expérience d'achat fluide
  • Un meilleur taux de conversion
  • Une image de marque plus forte et plus professionnelle

Prêt à commencer ? Suivez le guide, cela ne prend que quelques minutes.

Avant de commencer…

Où trouver votre Sales Channel ID

Publiez d'abord votre Sales Channel

Important : vous ne verrez PAS de Sales Channel ID tant que votre Sales Channel n'aura pas été publié. Si le canal est encore en brouillon, le lien et l'ID n'existent pas encore.

Ouvrez vos Sales Channels

  • Allez dans Studio → Events → Sales Channels
  • Sélectionnez le canal que vous souhaitez utiliser
  • Descendez en bas de la page et cliquez sur le bouton Share
Le bouton Share en bas de la page d'un canal de vente dans le studio Billy

Récupérez votre Sales Channel ID

  • Le Sales Channel ID est simplement le long code situé à la fin de l'URL.
  • Exemple d'URL : https://events.billyapp.live/12b8b09a-eb23-4d65-ba92-f6059cb18648 → Ici, 12b8b09a-eb23-4d65-ba92-f6059cb18648 est votre Sales Channel ID.
La fenêtre de partage affichant l'URL du canal de vente terminée par le Sales Channel ID

Option 1: Intégrer le checkout directement sur une page

Vous pouvez insérer le widget Billy directement sur votre site. Vos participants pourront acheter leurs billets ou produits sans être redirigés vers un service tiers. Une expérience fluide qu'ils retiendront.

En 2 étapes seulement, c'est prêt :

Animation montrant le widget Billy intégré sur une page Webflow

Avant de commencer, assurez-vous que votre site Webflow comporte au moins deux pages prêtes :

  • Une page d'accueil avec un bouton sur lequel vos visiteurs pourront cliquer
  • Une autre page contenant le widget Billy, vers laquelle les visiteurs seront redirigés après avoir cliqué sur le CTA

Étape 1. Ajouter les éléments Webflow

L'ajout de blocs et d'éléments est une étape obligatoire, et la toute première pour tout créateur de site Webflow.

Vous pouvez placer n'importe quel contenu dans un Div Block : texte, image, code, etc.

  1. Ouvrez le panneau des éléments (Add Elements Panel) situé à gauche
  2. Ajoutez, dans cet ordre, les deux éléments suivants à votre page de paiement : un Div Block, puis un Code Embed à l'intérieur
Le panneau d'éléments Webflow avec l'élément Div Block Le panneau d'éléments Webflow avec l'élément Code Embed

Astuce : vous pouvez modifier la position du widget en déplaçant simplement le Div Block vers le haut ou vers le bas dans le panneau.

Étape 2. Copier-coller le code du widget

  1. Double-cliquez sur Code Embed pour ouvrir l'éditeur de code.
  2. Copiez-collez ensuite le code suivant dans l'éditeur :
<iframe src="[EVENT URL]" allow="payment" width="100%" height="1000px"></iframe>

Veillez à remplacer [EVENT URL] par l'URL unique du widget de votre événement. Vous trouverez cette information dans la section canaux de distribution de votre événement dans le studio Billy. Votre URL doit ressembler à https://events.billyapp.live/fr/3f532137-dae9-4f16-870b-f3739dfa761a.

  1. Cliquez sur Save & Close. Votre nouvelle page contenant le widget est maintenant prête !

Étape 3. Relier votre bouton à la page du widget

  1. Cliquez sur votre bouton pour ouvrir les paramètres de lien (Link Settings).
  2. Sélectionnez la page que vous venez de créer avec le widget Billy.
  3. Enregistrez ou publiez, et voilà !
Le panneau Link Settings de Webflow pour un bouton Animation de l'intégration terminée du widget dans une page Webflow

Vous avez maintenant un flux de paiement intégré directement sur votre site Webflow. Félicitations ! Vous pouvez publier la nouvelle version de votre site et tester l'expérience utilisateur.

Option 2: Afficher le checkout dans une pop-up

Vous pouvez également afficher le flux de paiement dans une fenêtre pop-up sur une seule page. Suivez simplement les 4 étapes ci-dessous pour mettre cela en place.

Animation montrant la billetterie Billy s'ouvrant en pop-up sur un site Webflow

Avant de commencer, assurez-vous d'avoir une page avec au moins un CTA (bouton d'appel à l'action) sur lequel vos visiteurs pourront cliquer. Au clic, une fenêtre pop-up s'ouvrira directement dans la page, sans redirection externe.

Étape 1. Ajouter les éléments Webflow

L'ajout de blocs et d'éléments est obligatoire avant d'insérer le code. Dans un Div Block, vous pouvez placer n'importe quel contenu : texte, image, code, etc.

  1. Ouvrez le panneau des éléments à gauche.
  2. Ajoutez les deux éléments suivants dans votre page actuelle : un Div Block, puis un Code Embed à l'intérieur
Le panneau d'éléments Webflow, ajout d'un Div Block à la page courante Le panneau d'éléments Webflow, ajout d'un Code Embed à la page courante

Étape 2. Copier-coller le script obligatoire

  1. Double-cliquez sur l'élément Code Embed pour ouvrir l'éditeur.
  2. Copiez-collez ce script :
<script type="text/javascript"
        defer src="https://events.billyapp.live/embed.js"
        data-host="https://events.billyapp.live"></script>
  1. Cliquez sur Save & Close pour valider.

Astuce : vous pouvez placer ces deux éléments n'importe où dans la page. Néanmoins, la bonne pratique consiste à les mettre à la fin de la balise Body.

Étape 3. Personnaliser les attributs du bouton

  1. Sélectionnez votre bouton CTA (par exemple Buy Now).
  2. Dans la barre latérale droite, cliquez sur Settings.
La barre latérale de réglages Webflow pour le bouton Buy Now
  1. Ajoutez les trois attributs personnalisés suivants :
  • (Name) aria-haspopup = (Value) dialog
  • (Name) aria-controls = (Value) billy-dialog-[YOUR_SALES_CHANNEL_ID]
  • (Name) aria-expanded = (Value) false

La variable [YOUR_SALES_CHANNEL_ID] doit être remplacée par l'ID unique de votre widget. Vous trouverez cette information dans la section canaux de distribution de votre événement dans le studio Billy. Exemple : c0f35f0d-e408-4a38-a4ba-7c563dc0f995.

Étape 4. Connecter le bouton Buy Now à la pop-up

Une fois la pop-up configurée, il reste à lier le bouton pour que le widget s'affiche immédiatement au clic.

  1. Cliquez sur le bouton que vous souhaitez connecter.
  2. Sélectionnez Mouse click (tap).
  3. Sous On 1st click, choisissez Start an animation.
  4. Ajoutez une New Timed AnimationHide/Show. Et voilà !
Animation de l'intégration terminée de la pop-up de paiement dans Webflow

Félicitations ! Votre flux de paiement en pop-up est maintenant intégré à votre site Webflow. Publiez votre site pour tester l'expérience en direct.

Sur cette page