Intégration Brevo
Connecter Brevo à un quiz crée ou met à jour un contact dans une liste Brevo à chaque réponse au quiz. Cette page documente ce qui est synchronisé par défaut, les attributs de contact que FluoTest crée dans le compte Brevo, et comment la correspondance des champs modifie ce qui est envoyé.
Dernière mise à jour
Que se passe-t-il quand je connecte Brevo à un quiz ?
FluoTest crée 4 attributs de contact personnalisés dans le compte Brevo (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) et, à chaque réponse, crée ou met à jour un contact Brevo par e-mail avec le nom du répondant et ces attributs de score, ou avec les champs associés si une correspondance des champs est configurée.
Configuration#
Une intégration Brevo se configure avec une clé API du compte Brevo (Account settings → API Keys), un ID de liste Brevo facultatif auquel ajouter les contacts, et un palier de score facultatif qui limite les répondants synchronisés. La clé API est conservée côté serveur.
Attributs créés automatiquement#
Connecter une clé API Brevo crée les attributs de contact personnalisés suivants dans le compte Brevo, s'ils n'existent pas déjà. Cela se produit une seule fois, au moment où la clé est connectée. Les attributs apparaissent ensuite dans l'interface des contacts de Brevo avant même qu'un quiz ait reçu une réponse.
| Attribut | Type | Description |
|---|---|---|
| FLUOTEST_SCORE | float | Le score total du répondant. |
| FLUOTEST_MAX_SCORE | float | Le score maximal possible du quiz. |
| FLUOTEST_SCORE_PERCENT | float | Le score exprimé en pourcentage. |
| FLUOTEST_QUIZ | text | Le nom du quiz d'où provient le contact. |
Champs synchronisés par défaut (sans correspondance des champs)#
Sans correspondance des champs configurée, chaque réponse crée ou met à jour un contact Brevo en utilisant l'e-mail du répondant comme identifiant (les contacts existants avec cet e-mail sont mis à jour au lieu de provoquer une erreur) et envoie les attributs suivants :
| Champ | Source |
|---|---|
| FIRSTNAME | Prénom du répondant, ou nom complet si le prénom et le nom n'ont pas été collectés séparément. |
| LASTNAME | Nom de famille du répondant, s'il a été collecté. |
| FLUOTEST_SCORE | Score total. |
| FLUOTEST_MAX_SCORE | Score maximal possible. |
| FLUOTEST_SCORE_PERCENT | Pourcentage du score. |
| FLUOTEST_QUIZ | Nom du quiz. |
Champs synchronisés avec la correspondance des champs#
Si une correspondance des champs est configurée pour l'intégration Brevo (voir Correspondance des champs et nouvelles tentatives de synchronisation), le champ EMAIL associé sert d'identifiant du contact à la place de l'e-mail du répondant, et chaque autre champ associé est envoyé comme attribut Brevo à la place des 4 champs par défaut ci-dessus. Le schéma de destination proposé pour la correspondance est lu en direct depuis les attributs de contact du compte Brevo : les attributs personnalisés déjà créés dans Brevo sont donc disponibles comme cibles.
Ciblage des listes#
Un ID de liste défini au niveau du quiz remplace la liste par défaut du compte : différents quiz connectés au même compte Brevo peuvent ainsi ajouter des contacts à des listes différentes.
Erreurs d'autorisation d'IP#
Si le compte Brevo a activé « Authorised IPs » dans Security, Brevo rejette les requêtes de synchronisation, car les serveurs de FluoTest utilisent des adresses IP changeantes qui ne peuvent pas être ajoutées à une liste d'autorisation fixe. Cet échec est considéré comme définitif et n'est pas relancé. Supprimer la restriction d'IP dans Brevo (Security → Authorised IPs) règle le problème.
Questions fréquentes#
Connecter Brevo crée-t-il de nouveaux champs dans mon compte Brevo ?
Oui. Connecter une clé API Brevo crée 4 attributs de contact personnalisés (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) dans le compte Brevo s'ils n'existent pas déjà.
Quelle adresse e-mail sert à créer le contact Brevo ?
Par défaut, l'e-mail du répondant, ou le champ associé à la cible EMAIL de Brevo si une correspondance des champs est configurée.
Pourquoi mes synchronisations Brevo échouent-elles avec une erreur d'autorisation d'IP ?
Cela se produit quand le compte Brevo a activé des restrictions d'IP sous Security → Authorised IPs. Les serveurs de FluoTest utilisent des IP changeantes qui ne peuvent pas être mises en liste blanche : il faut donc supprimer la restriction pour que la synchronisation réussisse.
Puis-je choisir quels répondants sont synchronisés avec Brevo ?
Oui. Une intégration Brevo peut être limitée à un palier de score précis, pour que seuls les répondants de ce palier soient synchronisés.