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.
| Proveedor | Origen del esquema de destino |
|---|---|
| Brevo | Atributos de contacto de la cuenta de Brevo conectada. |
| Webhook | Ninguno: las claves de destino son libres. |
| Google Sheets | La fila de encabezado de la hoja seleccionada. |
| HubSpot | Propiedades de contacto de la cuenta de HubSpot conectada. |
| Mailchimp | Campos de combinación (merge fields) de la audiencia seleccionada. |
| Notion | Propiedades de la base de datos seleccionada. |
| Airtable | Campos 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.
| Campo | Descripción |
|---|---|
| Dirección de email del encuestado. | |
| name | Nombre completo. |
| first_name | Nombre. |
| last_name | Apellido. |
| company | Nombre de la empresa, si se recogió. |
| score | Puntuació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_score | Puntuación máxima posible (desplazada de la misma forma en quizzes con puntos negativos). |
| score_percent | Puntuación en porcentaje. |
| tier | Etiqueta del rango de puntuación asignado. |
| outcome | Clave del resultado principal asignado (motor de resultados de Pro). |
| tags | La etiqueta del rango, como lista de un solo elemento, que se usa como destino de etiquetas en los proveedores que admiten etiquetado. |
| submitted_at | Fecha y hora del envío. |
| quiz_name | Nombre del quiz. |
| country | Actualmente no se recoge; siempre está vacío. |
| phone | Respuesta a la pregunta de teléfono del quiz. |
| outcomes | Claves de todos los resultados asignados, como lista. |
| disqualified | "Yes" o "No". |
| all_answers | Todas las preguntas y respuestas en un solo bloque de texto, útil para un único campo de texto largo. |
| pdf_url | Enlace al PDF de respuestas (lo pueden abrir el propietario del quiz y los miembros del espacio de trabajo). |
| dashboard_url | Enlace a las respuestas del quiz en el panel de FluoTest. |
| results_url | Enlace a la página pública de resultados del encuestado. |
| submission_id | El 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.
| Tipo | Descripción |
|---|---|
| none | Envía el valor de origen sin cambios. |
| lowercase | Pasa un valor de texto a minúsculas. |
| uppercase | Pasa un valor de texto a mayúsculas. |
| concat | Une varios campos y/o texto literal con un separador. |
| json_path | Lee un valor anidado del objeto answers o scores de la respuesta mediante una ruta con puntos. |
| constant | Envía siempre un valor fijo, sin tener en cuenta ningún campo de origen. |
| computed | Obtiene un valor que calcula FluoTest: full_name, score_fraction (por ejemplo, "8/10") o score_percent. |
| custom | Una 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.
| Estado | Significado |
|---|---|
| success | Entregado sin errores. |
| failed | El último intento falló; aún puede reintentarse. |
| retrying | En cola para otro intento a una hora programada. |
| dead | Se 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.