Nós de Dados

Os Nós de Dados permitem que seus formulários façam chamadas de API HTTP durante o fluxo do formulário. Eles são invisíveis para os respondentes — executam automaticamente e podem buscar dados de APIs externas, validar respostas no seu backend ou acionar ações.

Adicionando um Nó de Dados

1. Abra seu formulário no construtor.
2. Clique em + para adicionar uma nova pergunta.
3. Selecione Data Node na categoria Advanced.
4. Configure a requisição HTTP nas propriedades da pergunta.

Configuração

Método HTTP

Escolha entre GET, POST, PUT ou DELETE, dependendo do seu endpoint de API.

URL

A URL do endpoint a ser chamada. Suporta interpolação de variáveis — use {variableName} para inserir valores de variáveis do formulário.

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

Se o respondente digitou jane@example.com em uma pergunta de e-mail anterior armazenada como a variável email, a requisição real vai para https://api.example.com/users/jane@example.com.

Cabeçalhos

Os cabeçalhos da requisição como linhas de chave/valor. Tanto variáveis do formulário ({variable}) quanto segredos de conexão ({secret.NAME}) são suportados.

Exemplo:

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

Corpo da Requisição

Para requisições POST e PUT, forneça um template de corpo JSON. Como o corpo é JSON, variáveis e segredos usam chaves duplas para não colidirem com as próprias { } do JSON — {{variable}} e {{secret.NAME}}.

Exemplo:

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

Segredos do Nó de Dados

Nunca cole uma chave de API diretamente em uma URL, cabeçalho ou corpo — em vez disso, armazene as credenciais como segredos do nó de dados e faça referência a elas pelo nome.

1. No editor do nó de dados (ou em Form Settings), clique em Manage secrets.
2. Clique em Add secret, dê um nome a ele (letras, números, sublinhados) e cole o valor.
3. Faça referência a ele em um Nó de Dados como {secret.NAME} na URL ou nos cabeçalhos, ou como {{secret.NAME}} no corpo JSON.

Os segredos são:

• Criptografados em repouso e resolvidos apenas nos nossos servidores quando a requisição roda — eles nunca são enviados ao navegador do respondente.
• Somente escrita — depois de salvo, o valor de um segredo nunca é mostrado novamente. Você pode substituir o valor ou excluí-lo, mas não pode visualizá-lo.
• Por formulário — eles acompanham o formulário quando você o duplica, mas são removidos quando você publica ou usa um template, ou quando exporta o formulário (o novo proprietário adiciona os seus próprios).

Tratamento da Resposta

Armazenando a Resposta

Defina o campo Response Variable para salvar a resposta JSON completa como uma variável do formulário. Depois, você pode referenciar esses dados em perguntas posteriores usando a sintaxe {variableName}.

Exemplo: Se você definir a variável de resposta como user_data e a API retornar {"name": "Jane", "plan": "pro"}, você pode referenciar {user_data} nas perguntas seguintes.

Opções de Exibição

Texto de Carregamento

Personalize a mensagem de carregamento mostrada enquanto a requisição está em andamento. Padrão: "Loading..."

Modo Silencioso

Ative o Silent mode para fazer a requisição em segundo plano, sem indicador de carregamento. O formulário continua sem esperar. Útil para cenários fire-and-forget, como pings de analytics ou gatilhos de webhook.

Modo de Depuração

Ative o Debug mode para mostrar um painel com os detalhes completos da requisição e da resposta. Útil durante o desenvolvimento do formulário — desative antes de publicar.

Barreira de Validação

Ative a opção Validation gate para usar o Nó de Dados como um validador da pergunta anterior. Se a requisição à API falhar (resposta não-2xx), o respondente é impedido de prosseguir e vê um erro.

Caso de uso: Validar um código de cupom, verificar a disponibilidade de um e-mail ou conferir um código de acesso no seu backend.

Tempo Limite

Configure o tempo limite da requisição em segundos (padrão: 10 segundos). Se a requisição demorar mais, ela falha e o formulário mostra um erro (a menos que esteja em modo silencioso).

Exemplos

Exemplo 1: Validar um Código de Cupom

1. Adicione uma pergunta Short Text pedindo um código de cupom (armazene a resposta como a variável coupon).
2. Adicione um Nó de Dados depois dela com:
   • Method: GET
   • URL: https://api.yoursite.com/coupons/{coupon}
   • Validation gate: ativado
   • Response variable: coupon_data
3. Se o cupom for inválido, a API retorna um 404 e o respondente vê um erro.
4. Se for válido, as informações de desconto são armazenadas em {coupon_data} para uso posterior.

Exemplo 2: Enriquecer Dados do Usuário

1. Adicione uma pergunta Email (armazene a resposta como a variável email).
2. Adicione um Nó de Dados:
   • Method: GET
   • URL: https://api.yoursite.com/users/{email}
   • Silent mode: ativado
   • Response variable: user_info
3. Perguntas posteriores podem referenciar {user_info} para preencher campos automaticamente ou personalizar a experiência.

Exemplo 3: Enviar para o CRM

1. No final do formulário, adicione um Nó de Dados:
   • Method: POST
   • URL: https://api.yourcrm.com/leads
   • Body: {"name": "{{name}}", "email": "{{email}}", "phone": "{{phone}}"}
   • Silent mode: ativado
2. O lead é criado no seu CRM como parte do fluxo do formulário — sem atraso de webhook.

Relacionado

• Variáveis — Como funciona a substituição de variáveis
• Saltos de Lógica — Ramificação condicional com base nas respostas
• Webhooks — Alternativa para integrações pós-envio