Correspondance des champs et nouvelles tentatives de synchronisation
Brevo, les webhooks, Google Sheets, HubSpot, Mailchimp, Notion et Airtable partagent un même système de correspondance des champs : chaque champ de destination est associé à une source côté quiz, éventuellement transformé, puis validé avant chaque tentative de synchronisation. Slack ne prend pas en charge la correspondance des champs : il envoie à la place un message au format fixe.
Dernière mise à jour
Comment fonctionne la correspondance des champs dans les intégrations FluoTest ?
Chaque champ de destination est associé à un champ standard du quiz, à une question précise ou à une valeur calculée, avec une transformation, une condition et une valeur de repli facultatives. Le schéma de destination est lu en direct depuis le compte connecté. Les tentatives de synchronisation échouées sont journalisées et relancées automatiquement avec un délai croissant avant d'être marquées comme abandonnées.
Services compatibles avec la correspondance des champs#
Les services suivants prennent en charge la correspondance des champs. Chacun lit son schéma de destination en direct depuis le compte ou la ressource connectée ; un webhook n'a pas de schéma à récupérer, ses clés cibles sont donc libres.
| Service | Source du schéma de destination |
|---|---|
| Brevo | Les attributs de contact du compte Brevo connecté. |
| Webhook | Aucune : les clés cibles sont libres. |
| Google Sheets | La ligne d'en-tête de la feuille sélectionnée. |
| HubSpot | Les propriétés de contact du compte HubSpot connecté. |
| Mailchimp | Les merge fields de l'audience sélectionnée. |
| Notion | Les propriétés de la base de données sélectionnée. |
| Airtable | Les champs de la table sélectionnée. |
Champs sources#
Chaque quiz expose le même ensemble de champs sources standard, plus un champ par question.
| Champ | Description |
|---|---|
| Adresse e-mail du répondant. | |
| name | Nom complet. |
| first_name | Prénom. |
| last_name | Nom de famille. |
| company | Nom de l'entreprise, s'il a été collecté. |
| score | Score total. Dans les quiz avec des points négatifs, il est décalé vers le haut du score le plus bas possible (voir la référence du payload des webhooks). |
| max_score | Score maximal possible (décalé de la même façon dans les quiz avec des points négatifs). |
| score_percent | Score en pourcentage. |
| tier | Libellé du palier de score correspondant. |
| outcome | Clé du résultat principal correspondant (moteur de résultats Pro). |
| tags | Le libellé du palier, sous forme de liste à un élément, utilisé comme cible tags pour les services qui gèrent les tags. |
| submitted_at | Horodatage de l'envoi. |
| quiz_name | Nom du quiz. |
| country | Non collecté actuellement ; toujours vide. |
| phone | Réponse à la question de téléphone du quiz. |
| outcomes | Clés de tous les résultats correspondants, sous forme de liste. |
| disqualified | « Yes » ou « No ». |
| all_answers | Toutes les questions et réponses sous forme d'un seul bloc de texte, pratique pour un unique champ de texte long. |
| pdf_url | Lien vers le PDF des réponses (accessible au propriétaire du quiz et aux membres de l'espace de travail). |
| dashboard_url | Lien vers les réponses du quiz dans le tableau de bord FluoTest. |
| results_url | Lien vers la page publique de résultats du répondant. |
| submission_id | L'ID de la réponse. |
| hidden:<name> | Un champ caché du lien du quiz (une source par nom défini sur le quiz, par ex. hidden:website), listé sous Champs cachés. Vide si le lien ne le contenait pas. |
Chaque question du quiz est aussi disponible comme champ source, avec le texte de la question comme libellé. Les réponses à sélection multiple sont envoyées sous forme de liste (elles remplissent donc les colonnes à sélection multiple dans Notion et Airtable, et sont jointes par des virgules ailleurs), et les envois de fichiers sont transmis sous forme de lien vers le fichier. Sur Notion, Airtable, Google Sheets et les webhooks, « Associer toutes les questions » ajoute un champ par question en un seul clic ; les colonnes manquantes sont créées lors de la première synchronisation.
Types de transformation#
Une correspondance peut appliquer l'une des transformations suivantes à la valeur source obtenue avant son envoi.
| Type | Description |
|---|---|
| none | Envoyer la valeur source sans modification. |
| lowercase | Mettre une valeur texte en minuscules. |
| uppercase | Mettre une valeur texte en majuscules. |
| concat | Joindre plusieurs champs et/ou du texte littéral avec un séparateur. |
| json_path | Lire une valeur imbriquée dans l'objet answers ou scores de la réponse à l'aide d'un chemin à points. |
| constant | Toujours envoyer une valeur fixe, en ignorant tout champ source. |
| computed | Obtenir une valeur calculée par FluoTest : full_name, score_fraction (par ex. "8/10") ou score_percent. |
| custom | Un modèle de texte dont les espaces réservés {field_key} sont remplacés par les champs sources. |
Correspondance conditionnelle#
Une correspondance peut porter une condition : elle ne s'applique que si une comparaison avec un champ source (égal à, différent de, supérieur à, inférieur à ou contient) est vraie. Un même champ de destination peut ainsi être rempli différemment, ou pas du tout, selon les réponses au quiz ou le score.
Valeurs de repli#
Si la valeur obtenue par une correspondance est vide, sa valeur de repli (si elle est définie) est utilisée à la place. Une correspondance avec une valeur de repli et sans champ source envoie toujours cette valeur de repli.
Champs obligatoires et validation#
Un champ de destination que le schéma marque comme obligatoire doit recevoir une valeur non vide d'une correspondance (une source, une constante ou une valeur de repli), sinon la synchronisation échoue à la validation avant même d'être tentée. Les échecs de validation ne sont pas relancés automatiquement, car relancer sans modifier la correspondance donnerait le même résultat ; il faut corriger la correspondance.
Livraison, nouvelles tentatives et échecs#
Chaque tentative de synchronisation (qu'elle réussisse, échoue ou soit relancée) est journalisée. Une tentative échouée (hors échec de validation) est mise en file d'attente pour une nouvelle tentative avec un délai croissant.
| Statut | Signification |
|---|---|
| success | Livrée sans erreur. |
| failed | La dernière tentative a échoué ; elle peut encore être relancée. |
| retrying | En file d'attente pour une nouvelle tentative à une heure planifiée. |
| dead | Toutes les nouvelles tentatives sont épuisées, ou l'échec était une erreur de validation : plus aucune tentative automatique. |
Les nouvelles tentatives sont planifiées 1 minute, 5 minutes et 30 minutes après chaque tentative échouée (jusqu'à 3 nouvelles tentatives après la première, soit 4 tentatives au total). Une tâche en arrière-plan vérifie chaque minute les nouvelles tentatives à effectuer. Une synchronisation en file d'attente ou abandonnée peut aussi être relancée manuellement depuis le tableau de bord Intégrations du quiz.
Questions fréquentes#
Quelles intégrations prennent en charge la correspondance des champs ?
Brevo, les webhooks, Google Sheets, HubSpot, Mailchimp, Notion et Airtable. Slack envoie à la place un message au format fixe et n'utilise pas la correspondance des champs.
D'où vient la liste des champs de destination ?
Elle est lue en direct depuis le compte ou la ressource connectée (par exemple les propriétés de contact de HubSpot, ou la ligne d'en-tête d'une feuille Google Sheets), plutôt que d'une liste fixe : elle inclut donc les champs personnalisés.
Que se passe-t-il si un champ de destination obligatoire n'a pas de correspondance ?
La synchronisation échoue à la validation et n'est ni tentée ni relancée. Associer un champ source, une constante ou une valeur de repli au champ obligatoire règle le problème.
Combien de fois FluoTest relance-t-il une synchronisation échouée ?
Jusqu'à 3 tentatives supplémentaires après la première, avec des délais de 1, 5 et 30 minutes. Ensuite, ou immédiatement en cas d'échec de validation, la synchronisation est marquée comme abandonnée et peut être relancée manuellement.