Formulário
Os Formulários da Hablla permitem criar interfaces de captura de dados por arrastar e soltar (drag-and-drop). Você monta o layout, configura cada campo e publica para uso em páginas, fluxos e integrações.
Como funciona: escolha os componentes, arraste para a área de edição e ajuste as propriedades nas abas de configuração de cada campo.

Biblioteca de componentes
Basic
Text Field: campo de texto curto (ex.: nome).
Text Area: texto longo (observações).
Number: números inteiros/decimais.
Password: senha (oculta).
Checkbox: verdadeiro/falso.
Select Boxes: múltipla seleção por checkboxes.
Select: lista suspensa (uma opção).
Radio: seleção única por botões de rádio.
Button: botões de ação (Enviar, Voltar etc.).

Advanced
Email • Url • Phone Number
Tags: múltiplos valores com chips.
Address: endereço estruturado.
Date/Time • Day • Time
Currency: valores monetários.
Survey: matriz de perguntas.
Signature: assinatura digital.

Layout
HTML Element: bloco HTML livre.
Content: texto estático/MD.
Columns: colunas responsivas.
Field Set • Panel: agrupar campos.
Table: grade tabular simples.
Tabs: navegação por abas.
Well: caixa de destaque.

Data
Hidden: valor oculto (ex.: UTM).
Container: objeto com subcampos.
Data Map: pares chave/valor dinâmicos.
Data Grid / Edit Grid: listas editáveis (linhas repetíveis).

Premium
File: upload de arquivos.
Nested Form: reaproveitar outro formulário.
Custom: componente de lógica própria.

Configuração de cada campo
Cada componente possui abas de configuração. As mais usadas:
Display (Exibição) Rótulo, placeholder, ajuda (tooltip), posição do rótulo, máscara de entrada e de exibição, CSS de classe, visibilidade.
Data (Dados) Chave interna (
key), valor padrão, fonte de dados (estático, remoto), mapa de valor/rótulo, persistência.Validation (Validação) Obrigatoriedade, tamanho mínimo/máximo, regex, limites numéricos, mensagens de erro personalizadas.
API Nome de propriedade, referência para integrações e webhooks.
Conditional (Condição) Mostrar/ocultar baseado em regras (ex.: “mostrar Telefone se Receber contato por WhatsApp = Sim”).
Logic (Lógica) Ações ao mudar o valor (preencher automático, copiar de outro campo, executar expressão).
Layout Colunas, largura, responsividade e agrupamentos.
Dica: defina
Label(o que o usuário vê) eKey(o identificador técnico) com nomes claros. Ex.:Label: Nome,Key: nome.
Exemplo: campo Nome (JSON)
Abaixo um exemplo minimalista de um Text Field para capturar o nome do contato. Você pode copiar, adaptar e reutilizar.
{
  "label": "Nome",
  "placeholder": "Digite seu nome completo",
  "description": "Informe como deseja ser chamado.",
  "tooltip": "Use apenas letras e espaços.",
  "type": "textfield",
  "key": "nome",
  "autocomplete": "name",
  "input": true,
  "validate": {
    "required": true,
    "minLength": 2,
    "maxLength": 120,
    "pattern": "^[A-Za-zÀ-ÖØ-öø-ÿ'\\- ]+$",
    "customMessage": "Digite um nome válido (apenas letras)."
  },
  "widget": {
    "type": "input"
  },
  "persistent": true,
  "clearOnHide": true,
  "hidden": false
}Melhores práticas
Padronize chaves (
key) UsecamelCaseousnake_casee evite espaços (ex.:telefoneWhatsApp,aceiteTermos).Valide na borda Aplique validações (regex, min/max, required) para reduzir dados inválidos e retrabalho.
Use máscaras quando fizer sentido Ex.: telefone, CPF/CNPJ, CEP. Máscara orienta o preenchimento e reduz erros.
Agrupe o que pertence junto Use Panels, Field Sets ou Tabs para tornar o formulário escaneável.
Condições deixam o fluxo inteligente Exiba campos apenas quando forem relevantes para reduzir atrito.
Teste em dispositivos reais Verifique responsividade e acessibilidade (teclado, leitores de tela, contraste).
Publicação e uso
Salvar e pré-visualizar: confira erros de validação e responsividade.
Integrar em fluxos: use o formulário para capturar leads, abrir tickets, alimentar Pessoas/Organizações ou disparar automações.
Exportar envios: combine com relatórios para analisar conversões e qualidade de dados.
Resumo
Monte formulários por arrastar e soltar.
Configure cada campo pelas abas Display, Data, Validation, API, Conditional, Logic, Layout.
Padronize chaves, valide entradas e use condições para experiências mais rápidas e assertivas.
📌 Dica prática: comece pequeno (Nome, Email, WhatsApp), valide os campos, publique, e só então evolua o formulário com grupos, lógicas e grids conforme o caso de uso.
Atualizado
Isto foi útil?

