Integración con Brevo
Conectar Brevo a un quiz crea o actualiza un contacto en una lista de Brevo cada vez que se envía el quiz. Esta página documenta qué se sincroniza por defecto, los atributos de contacto que FluoTest crea en la cuenta de Brevo y cómo el mapeo de campos cambia lo que se envía.
Última actualización
¿Qué pasa cuando conecto Brevo a un quiz?
FluoTest crea 4 atributos de contacto personalizados en la cuenta de Brevo (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) y, en cada respuesta, crea o actualiza un contacto de Brevo por email con el nombre del encuestado y esos atributos de puntuación, o con los campos mapeados, si hay un mapeo de campos configurado.
Configuración#
Una integración con Brevo se configura con una clave API de la cuenta de Brevo (Account settings → API Keys), un ID de lista de Brevo opcional al que añadir los contactos y un rango de puntuación opcional que limita qué encuestados se sincronizan. La clave API se guarda en el servidor.
Atributos creados automáticamente#
Al conectar una clave API de Brevo se crean los siguientes atributos de contacto personalizados en la cuenta de Brevo, si todavía no existen. Esto ocurre una sola vez, al conectar la clave. A partir de entonces, los atributos aparecen en la interfaz de contactos de Brevo incluso antes de que se envíe ningún quiz.
| Atributo | Tipo | Descripción |
|---|---|---|
| FLUOTEST_SCORE | float | La puntuación total del encuestado. |
| FLUOTEST_MAX_SCORE | float | La puntuación máxima posible del quiz. |
| FLUOTEST_SCORE_PERCENT | float | La puntuación expresada como porcentaje. |
| FLUOTEST_QUIZ | text | El nombre del quiz del que procede el contacto. |
Campos sincronizados por defecto (sin mapeo de campos)#
Sin mapeo de campos configurado, cada respuesta crea o actualiza un contacto de Brevo usando el email del encuestado como identificador (los contactos existentes con ese email se actualizan en lugar de provocar un error) y envía los siguientes atributos:
| Campo | Origen |
|---|---|
| FIRSTNAME | Nombre del encuestado, o nombre completo si no se recogieron nombre y apellido por separado. |
| LASTNAME | Apellido del encuestado, si se recogió. |
| FLUOTEST_SCORE | Puntuación total. |
| FLUOTEST_MAX_SCORE | Puntuación máxima posible. |
| FLUOTEST_SCORE_PERCENT | Porcentaje de puntuación. |
| FLUOTEST_QUIZ | Nombre del quiz. |
Campos sincronizados con mapeo de campos#
Si la integración con Brevo tiene un mapeo de campos configurado (consulta Mapeo de campos y reintentos de sincronización), el campo EMAIL mapeado se usa como identificador del contacto en lugar del email del encuestado, y todos los demás campos mapeados se envían como atributos de Brevo en lugar de los 4 campos por defecto de arriba. El esquema de destino disponible para el mapeo se lee en directo de los atributos de contacto de la cuenta de Brevo, así que los atributos personalizados ya creados en Brevo están disponibles como destinos del mapeo.
Elección de la lista#
Un ID de lista a nivel de quiz sustituye a la lista por defecto de la cuenta, así que distintos quizzes conectados a la misma cuenta de Brevo pueden añadir contactos a listas diferentes.
Errores de autorización de IP#
Si la cuenta de Brevo tiene activadas las "Authorised IPs" en Security, Brevo rechaza las solicitudes de sincronización porque los servidores de FluoTest usan direcciones IP rotativas que no se pueden añadir a una lista de permitidas fija. Este fallo se considera permanente y no se reintenta. Se resuelve eliminando la restricción de IP en Brevo (Security → Authorised IPs).
Preguntas frecuentes#
¿Conectar Brevo crea campos nuevos en mi cuenta de Brevo?
Sí. Al conectar una clave API de Brevo se crean 4 atributos de contacto personalizados (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) en la cuenta de Brevo si todavía no existen.
¿Qué dirección de email se usa para crear el contacto de Brevo?
Por defecto, el email del encuestado, o el campo mapeado al destino EMAIL de Brevo si hay un mapeo de campos configurado.
¿Por qué mis sincronizaciones con Brevo fallan con un error de autorización de IP?
Ocurre cuando la cuenta de Brevo tiene restricciones de IP activadas en Security → Authorised IPs. Los servidores de FluoTest usan IP rotativas que no se pueden añadir a una lista de permitidas, así que hay que eliminar la restricción para que la sincronización funcione.
¿Puedo controlar qué encuestados se sincronizan con Brevo?
Sí. Una integración con Brevo se puede limitar a un rango de puntuación concreto, para que solo se sincronicen los encuestados de ese rango.