Paramétrer TiBillet
1. Clé API
Dans l'administration de votre espace (https://votrestructure.lespass.tibillet.org/) :
- Cliquez sur "Mon compte" en haut à droite.
- Cliquez sur le bouton rouge "Administration" (icône de clé).
- Dans le menu de gauche, tout en bas, cliquez sur "Formbricks" puis "Configuration".
API Host est l'adresse de base de votre compte Formbricks :
- Par défaut : https://app.formbricks.com
- Si auto-hébergé : https://votrestructure.formbricks.com
Sur votre logiciel Formbricks :
- Allez dans "Configuration" > "Clés API".
- Cliquez sur "Ajouter la clé API de production".
- Donnez-lui un nom et copiez la clé générée (visible une seule fois).
Retournez sur TiBillet :
- Collez la clé dans le champ "API KEY".
- Enregistrez.
Si tout est correct, un indicateur vert affichera "API ok".
2. Environnement
Sur Formbricks :
- Allez dans "Configuration" > "Connexion Site Web & Application".
- Descendez jusqu'à "Votre identifiant d'environnement" et copiez la clé.
Sur TiBillet :
- Cliquez sur le "+" pour ajouter un nouveau formulaire.
- Collez la clé dans le champ "EnvironmentId".
- Renseignez le "Trigger name" (déclencheur d'enquête) :
- Sur Formbricks, ouvrez votre enquête.
- Allez dans "Paramètres" > "Déclencheur d'enquête".
- Supprimez les anciens déclencheurs si nécessaire.
- Cliquez sur "Ajouter une action" > "Capturer une nouvelle action".
- Remplissez les champs obligatoires, notamment "Que fait votre utilisateur ?".
- Créez l'action et copiez la clé générée.
- Collez cette clé dans "Trigger name" sur TiBillet.
Product : sélectionnez les produits associés à ce formulaire (ex : adhésions, panier).
Le trigger lance l'enquête Formbricks uniquement après validation du pré-formulaire TiBillet (nom, prénom, adresse).
Paramétrer Formbricks
3. Rendre l'enquête fixe dans TiBillet
- Ouvrez les paramètres de votre enquête dans Formbricks.
- Activez l'option "Continuer à afficher tant que les conditions correspondent".
- Cochez également :
- "Ignorer le temps d'attente entre les enquêtes"
- "Afficher toujours l'enquête"
Cela permet à l'enquête de rester visible tant que les conditions sont remplies.
4. Mise en page et affichage
- Allez dans "Placement de l'enquête".
- Activez les options suivantes :
- "Surcharge de placement"
- "Modal centré"
- "Couleur de la superposition" (selon vos préférences)
- "Ne pas permettre" (pour empêcher la fermeture de l'enquête en cliquant en dehors du cadre)
Assurez-vous que le "Placement de l'enquête dans l'application" est bien configuré en "Modal centré" et "Ne pas permettre" dans "Configuration" > "Apparence et sensation".
5. Fonctionnalités supplémentaires
Remplissage automatique et champs cachés
TiBillet transmet automatiquement certaines informations à Formbricks :
name
: Nom de l'utilisateuremail
: Emailmembership_uuid
: Numéro d'adhésionproduct_name
: Nom du produitprice_name
: Prix du produit
Utilisation dans Formbricks :
- Allez dans "Questions" de votre enquête.
- Ajoutez des champs cachés pour ces données.
- Utilisez-les dans vos questions avec
@
(ex : Bonjour @name, vous avez choisi @product_name.).
Les champs cachés permettent de personnaliser l'enquête et d'assurer un suivi précis dans les résultats.
Affichage des slugs
Pour que les valeurs des champs cachés apparaissent telles qu'elles sont stockées (espaces remplacés par des tirets), notamment dans les espaces conditionnels des enquêtes utilisez les slugs :
product_slug
price_slug
Pour récupérer les slugs :
- Dans l'administration TiBillet, allez dans "Formbricks".
- Ouvrez votre formulaire.
- Les slugs s'afficheront en bleu en haut de la page.
Un problème de cache sur les serveurs Formbricks peut retarder l'affichage des modifications (~10 minutes).