Brevo-integratie
Het koppelen van Brevo aan een quiz maakt bij elke inzending een contact aan of werkt dit bij in een Brevo-lijst. Deze pagina documenteert wat er standaard wordt gesynchroniseerd, welke contactattributen FluoTest aanmaakt in het Brevo-account, en hoe veldkoppeling verandert wat er wordt verstuurd.
Laatst bijgewerkt
Wat gebeurt er als ik Brevo aan een quiz koppel?
FluoTest maakt 4 aangepaste contactattributen aan in het Brevo-account (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) en maakt bij elke inzending een Brevo-contact aan of werkt dit bij op basis van e-mailadres, met de naam van de respondent en die scoreattributen — of met gekoppelde velden, als veldkoppeling is geconfigureerd.
Configuratie
Een Brevo-integratie wordt geconfigureerd met een API-sleutel uit het Brevo-account (Account settings → API Keys), een optioneel Brevo-lijst-ID om contacten aan toe te voegen, en een optioneel scoreniveau dat beperkt welke respondenten worden gesynchroniseerd. De API-sleutel wordt server-side opgeslagen.
Automatisch aangemaakte attributen
Het koppelen van een Brevo-API-sleutel maakt de volgende aangepaste contactattributen aan in het Brevo-account, als deze nog niet bestaan. Dit gebeurt eenmalig, bij het koppelen van de sleutel — de attributen verschijnen daarna in de Brevo-contactinterface, zelfs voordat een quiz is ingestuurd.
| Attribuut | Type | Beschrijving |
|---|---|---|
| FLUOTEST_SCORE | float | De totaalscore van de respondent. |
| FLUOTEST_MAX_SCORE | float | De maximaal mogelijke score van de quiz. |
| FLUOTEST_SCORE_PERCENT | float | De score uitgedrukt als percentage. |
| FLUOTEST_QUIZ | text | De naam van de quiz waar het contact vandaan komt. |
Standaard gesynchroniseerde velden (zonder veldkoppeling)
Zonder geconfigureerde veldkoppeling maakt elke inzending een Brevo-contact aan of werkt dit bij op basis van het e-mailadres van de respondent als identifier (een bestaand contact met dat e-mailadres wordt bijgewerkt in plaats van een fout te veroorzaken) en worden de volgende attributen verstuurd:
| Veld | Bron |
|---|---|
| FIRSTNAME | Voornaam van de respondent, of volledige naam als er geen aparte voor- en achternaam is verzameld. |
| LASTNAME | Achternaam van de respondent, indien verzameld. |
| FLUOTEST_SCORE | Totaalscore. |
| FLUOTEST_MAX_SCORE | Maximaal mogelijke score. |
| FLUOTEST_SCORE_PERCENT | Scorepercentage. |
| FLUOTEST_QUIZ | Naam van de quiz. |
Gesynchroniseerde velden met veldkoppeling
Als er veldkoppeling is geconfigureerd voor de Brevo-integratie (zie Veldkoppeling & sync-herhalingen), wordt het gekoppelde EMAIL-veld gebruikt als contactidentifier in plaats van het e-mailadres van de respondent, en wordt elk ander gekoppeld veld verstuurd als Brevo-attribuut in plaats van de 4 standaardvelden hierboven. Het doelschema dat wordt aangeboden voor koppeling wordt live uitgelezen uit de contactattributen van het Brevo-account, zodat aangepaste attributen die al in Brevo zijn aangemaakt beschikbaar zijn als koppelingsdoel.
Lijstkeuze
Een lijst-ID op quizniveau overschrijft de standaardlijst op accountniveau, zodat verschillende quizzen die aan hetzelfde Brevo-account zijn gekoppeld, contacten aan verschillende lijsten kunnen toevoegen.
IP-autorisatiefouten
Als het Brevo-account "Authorised IPs" heeft ingeschakeld onder Security, wijst Brevo synchronisatieverzoeken af omdat de servers van FluoTest roterende IP-adressen gebruiken die niet aan een vaste toegestane lijst kunnen worden toegevoegd. Deze mislukking wordt als permanent beschouwd en niet opnieuw geprobeerd. Het verwijderen van de IP-beperking in Brevo (Security → Authorised IPs) lost dit op.
Veelgestelde vragen
Maakt het koppelen van Brevo nieuwe velden aan in mijn Brevo-account?
Ja. Het koppelen van een Brevo-API-sleutel maakt 4 aangepaste contactattributen aan (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) in het Brevo-account, als deze nog niet bestaan.
Welk e-mailadres wordt gebruikt om het Brevo-contact aan te maken?
Standaard het e-mailadres van de respondent, of het veld dat is gekoppeld aan het EMAIL-doel van Brevo als veldkoppeling is geconfigureerd.
Waarom mislukken mijn Brevo-synchronisaties met een IP-autorisatiefout?
Dit gebeurt als het Brevo-account IP-beperkingen heeft ingeschakeld onder Security → Authorised IPs. De servers van FluoTest gebruiken roterende IP's die niet op een witte lijst kunnen worden gezet, dus moet de beperking worden verwijderd om de synchronisatie te laten slagen.
Kan ik bepalen welke respondenten naar Brevo worden gesynchroniseerd?
Ja. Een Brevo-integratie kan worden beperkt tot een specifiek scoreniveau, zodat alleen respondenten in dat niveau worden gesynchroniseerd.