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
) UsecamelCase
ousnake_case
e 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?