Nodos de Datos

Los Nodos de Datos permiten que tus formularios realicen llamadas HTTP a APIs durante el flujo del formulario. Son invisibles para los encuestados — se ejecutan automaticamente y pueden obtener datos de APIs externas, validar respuestas contra tu backend o activar acciones.

Agregar un Nodo de Datos

1. Abre tu formulario en el constructor.
2. Haz clic en + para agregar una nueva pregunta.
3. Selecciona Data Node de la categoria Avanzado.
4. Configura la solicitud HTTP en las propiedades de la pregunta.

Configuracion

Metodo HTTP

Elige entre GET, POST, PUT o DELETE segun tu endpoint de API.

URL

La URL del endpoint a llamar. Soporta interpolacion de variables — usa {variableName} para insertar valores de variables del formulario.

Ejemplo: https://api.example.com/users/{email}

Si el encuestado ingreso jane@example.com en una pregunta de correo electronico anterior almacenada como la variable email, la solicitud real se dirige a https://api.example.com/users/jane@example.com.

Encabezados

Objeto JSON de encabezados de solicitud. La interpolacion de variables tambien es compatible aqui.

Ejemplo:

{
  "Authorization": "Bearer {secret.API_TOKEN}",
  "Content-Type": "application/json"
}

Cuerpo de la Solicitud

Para solicitudes POST y PUT, proporciona una plantilla de cuerpo JSON. La interpolacion de variables es compatible.

Ejemplo:

{
  "name": "{{full_name}}",
  "email": "{{email}}",
  "api_key": "{{secret.API_KEY}}",
  "source": "nueform"
}

Secretos de Conexión

Nunca pegues una clave de API directamente en una URL, un encabezado o un cuerpo — guarda las credenciales como secretos de conexión y haz referencia a ellas por nombre.

1. En el constructor de formularios, abre Configuración → Secretos de conexión.
2. Haz clic en Añadir secreto, dale un nombre (letras, números, guiones bajos) y pega el valor.
3. Haz referencia a él en un Nodo de Datos como {secret.NAME} en la URL o los encabezados, o {{secret.NAME}} en el cuerpo JSON.

Los secretos:

• Están cifrados en reposo y se resuelven solo en nuestros servidores cuando se ejecuta la solicitud — nunca se envían al navegador del encuestado.
• Son de solo escritura — una vez guardado, el valor de un secreto nunca se vuelve a mostrar. Puedes reemplazar el valor o eliminarlo, pero no verlo.
• Son por formulario — viajan con el formulario cuando lo duplicas, pero se eliminan cuando publicas o usas una plantilla, o exportas el formulario (el nuevo propietario añade los suyos).

Manejo de Respuesta

Almacenar la Respuesta

Establece el campo Response Variable para guardar la respuesta JSON completa como una variable del formulario. Luego puedes hacer referencia a estos datos en preguntas posteriores usando la sintaxis {variableName}.

Ejemplo: Si estableces la variable de respuesta como user_data y la API devuelve {"name": "Jane", "plan": "pro"}, puedes hacer referencia a {user_data} en preguntas siguientes.

Opciones de Visualizacion

Texto de Carga

Personaliza el mensaje de carga mostrado mientras la solicitud esta en progreso. Por defecto: "Loading..."

Modo Silencioso

Activa Silent mode para realizar la solicitud en segundo plano sin indicador de carga. El formulario continua sin esperar. Util para escenarios de dispara-y-olvida como pings de analitica o activadores de webhooks.

Modo de Depuracion

Activa Debug mode para mostrar un panel con los detalles completos de la solicitud y respuesta. Util durante el desarrollo del formulario — desactivalo antes de publicar.

Puerta de Validacion

Activa Validation gate para usar el Nodo de Datos como validador de la pregunta anterior. Si la solicitud API falla (respuesta no-2xx), el encuestado no puede avanzar y se muestra un error.

Caso de uso: Validar un codigo de cupon, verificar disponibilidad de correo electronico o verificar un codigo de acceso contra tu backend.

Tiempo de Espera

Configura el tiempo de espera de la solicitud en segundos (por defecto: 10 segundos). Si la solicitud tarda mas, falla y el formulario muestra un error (a menos que este en modo silencioso).

Ejemplos

Ejemplo 1: Validar un Codigo de Cupon

1. Agrega una pregunta de Texto Corto pidiendo un codigo de cupon (almacena la respuesta como variable coupon).
2. Agrega un Nodo de Datos despues con:
   • Metodo: GET
   • URL: https://api.yoursite.com/coupons/{coupon}
   • Puerta de validacion: activada
   • Variable de respuesta: coupon_data
3. Si el cupon es invalido, la API devuelve un 404 y el encuestado ve un error.
4. Si es valido, la informacion del descuento se almacena en {coupon_data} para uso posterior.

Ejemplo 2: Enriquecer Datos del Usuario

1. Agrega una pregunta de Email (almacena la respuesta como variable email).
2. Agrega un Nodo de Datos:
   • Metodo: GET
   • URL: https://api.yoursite.com/users/{email}
   • Modo silencioso: activado
   • Variable de respuesta: user_info
3. Las preguntas posteriores pueden hacer referencia a {user_info} para prellenar campos o personalizar la experiencia.

Ejemplo 3: Enviar al CRM

1. Al final del formulario, agrega un Nodo de Datos:
   • Metodo: POST
   • URL: https://api.yourcrm.com/leads
   • Cuerpo: {"name": "{{name}}", "email": "{{email}}", "phone": "{{phone}}"}
   • Modo silencioso: activado
2. El lead se crea en tu CRM como parte del flujo del formulario — sin retraso de webhook.

Relacionado

• Variables — Como funciona la sustitucion de variables
• Saltos Logicos — Ramificacion condicional basada en respuestas
• Webhooks — Alternativa para integraciones post-envio