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 {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}",
  "source": "nueform"
}

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