Mapeo de campos y reintentos de sincronización

Brevo, los webhooks, Google Sheets, HubSpot, Mailchimp, Notion y Airtable comparten un mismo sistema de mapeo de campos: cada campo de destino se mapea desde un origen del lado del quiz, se transforma opcionalmente y se valida antes de cada intento de sincronización. Slack no admite mapeo de campos: envía en su lugar un mensaje con un formato fijo.

Última actualización

¿Cómo funciona el mapeo de campos en las integraciones de FluoTest?

Cada campo de destino se mapea desde un campo estándar del quiz, una pregunta concreta o un valor calculado, con una transformación, una condición y un valor de reserva opcionales. El esquema del destino se lee en directo desde la cuenta conectada. Los intentos de sincronización fallidos se registran y se reintentan automáticamente con espera progresiva antes de marcarse como muertos.

Proveedores con mapeo de campos#

Los siguientes proveedores admiten el mapeo de campos. Cada uno lee su esquema de destino en directo desde la cuenta o el recurso conectado; un webhook no tiene esquema que obtener, así que sus claves de destino son libres.

ProveedorOrigen del esquema de destino
BrevoAtributos de contacto de la cuenta de Brevo conectada.
WebhookNinguno: las claves de destino son libres.
Google SheetsLa fila de encabezado de la hoja seleccionada.
HubSpotPropiedades de contacto de la cuenta de HubSpot conectada.
MailchimpCampos de combinación (merge fields) de la audiencia seleccionada.
NotionPropiedades de la base de datos seleccionada.
AirtableCampos de la tabla seleccionada.

Campos de origen#

Todos los quizzes ofrecen el mismo conjunto de campos de origen estándar, más un campo por pregunta.

CampoDescripción
emailDirección de email del encuestado.
nameNombre completo.
first_nameNombre.
last_nameApellido.
companyNombre de la empresa, si se recogió.
scorePuntuación total. En quizzes con puntos negativos se desplaza hacia arriba según la puntuación más baja posible (consulta la referencia del payload del webhook).
max_scorePuntuación máxima posible (desplazada de la misma forma en quizzes con puntos negativos).
score_percentPuntuación en porcentaje.
tierEtiqueta del rango de puntuación asignado.
outcomeClave del resultado principal asignado (motor de resultados de Pro).
tagsLa etiqueta del rango, como lista de un solo elemento, que se usa como destino de etiquetas en los proveedores que admiten etiquetado.
submitted_atFecha y hora del envío.
quiz_nameNombre del quiz.
countryActualmente no se recoge; siempre está vacío.
phoneRespuesta a la pregunta de teléfono del quiz.
outcomesClaves de todos los resultados asignados, como lista.
disqualified"Yes" o "No".
all_answersTodas las preguntas y respuestas en un solo bloque de texto, útil para un único campo de texto largo.
pdf_urlEnlace al PDF de respuestas (lo pueden abrir el propietario del quiz y los miembros del espacio de trabajo).
dashboard_urlEnlace a las respuestas del quiz en el panel de FluoTest.
results_urlEnlace a la página pública de resultados del encuestado.
submission_idEl ID de la respuesta.
hidden:<name>Un campo oculto del enlace del quiz (un origen por cada nombre definido en el quiz, por ejemplo hidden:website), que aparece en Campos ocultos. Vacío cuando el enlace no lo incluía.

Cada pregunta del quiz también está disponible como campo de origen, etiquetada con el texto de la pregunta. Las respuestas de selección múltiple se envían como lista (así rellenan columnas de selección múltiple en Notion y Airtable, y en los demás casos se unen con comas), y los archivos subidos se envían como enlace al archivo. En Notion, Airtable, Google Sheets y webhooks, "Mapear todas las preguntas" añade un campo por pregunta con un solo clic; las columnas que faltan se crean en la primera sincronización.

Tipos de transformación#

Un mapeo puede aplicar una de las siguientes transformaciones al valor de origen resuelto antes de enviarlo.

TipoDescripción
noneEnvía el valor de origen sin cambios.
lowercasePasa un valor de texto a minúsculas.
uppercasePasa un valor de texto a mayúsculas.
concatUne varios campos y/o texto literal con un separador.
json_pathLee un valor anidado del objeto answers o scores de la respuesta mediante una ruta con puntos.
constantEnvía siempre un valor fijo, sin tener en cuenta ningún campo de origen.
computedObtiene un valor que calcula FluoTest: full_name, score_fraction (por ejemplo, "8/10") o score_percent.
customUna plantilla de texto con marcadores {field_key} que se sustituyen por los campos de origen.

Mapeo condicional#

Un mapeo puede llevar una condición: solo se aplica cuando una comparación con un campo de origen (igual a, distinto de, mayor que, menor que o contiene) resulta verdadera. Así, un mismo campo de destino puede rellenarse de forma distinta, o no rellenarse, según las respuestas o la puntuación del quiz.

Valores de reserva#

Si el valor resuelto de un mapeo está vacío, se usa en su lugar su valor de reserva (si lo tiene). Un mapeo con valor de reserva y sin campo de origen envía siempre ese valor de reserva.

Campos obligatorios y validación#

Un campo de destino que el esquema marca como obligatorio debe resolverse a un valor no vacío desde algún mapeo (un origen, una constante o un valor de reserva); si no, la sincronización no supera la validación antes de intentarse. Los fallos de validación no se reintentan automáticamente, ya que reintentar sin cambiar el mapeo da el mismo resultado; hay que corregir el mapeo.

Entrega, reintentos y fallos#

Cada intento de sincronización (tanto si tiene éxito, como si falla o se reintenta) se registra. Un intento fallido (salvo un fallo de validación) se pone en cola para reintentarse con espera progresiva.

EstadoSignificado
successEntregado sin errores.
failedEl último intento falló; aún puede reintentarse.
retryingEn cola para otro intento a una hora programada.
deadSe agotaron todos los reintentos o el fallo fue un error de validación; no habrá más intentos automáticos.

Los reintentos se programan 1 minuto, 5 minutos y 30 minutos después de cada intento fallido (hasta 3 reintentos además del primer intento, 4 intentos en total). Una tarea en segundo plano busca reintentos pendientes cada minuto. Una sincronización en cola o marcada como muerta también se puede reintentar manualmente desde el panel de Integraciones del quiz.

Preguntas frecuentes#

¿Qué integraciones admiten el mapeo de campos?

Brevo, webhooks, Google Sheets, HubSpot, Mailchimp, Notion y Airtable. Slack envía en su lugar un mensaje con formato fijo y no usa el mapeo de campos.

¿De dónde sale la lista de campos de destino?

Se lee en directo desde la cuenta o el recurso conectado (por ejemplo, las propiedades de contacto de HubSpot o la fila de encabezado de una hoja de Google Sheets), en lugar de ser una lista fija, así que incluye los campos personalizados.

¿Qué pasa si un campo de destino obligatorio no tiene mapeo?

La sincronización no supera la validación y no se intenta ni se reintenta. Se resuelve mapeando un campo de origen, una constante o un valor de reserva al campo obligatorio.

¿Cuántas veces reintenta FluoTest una sincronización fallida?

Hasta 3 intentos adicionales después del primero, con esperas de 1, 5 y 30 minutos. Después de eso, o inmediatamente en caso de fallo de validación, la sincronización se marca como muerta y se puede reintentar manualmente.