Formulários

O formulário coleta dados estruturados de quem é membro e de quem ainda não é: o pedido de demonstração do seu site, a inscrição num programa, a candidatura a uma vaga, o cadastro de interesse num curso que ainda vai abrir. Cada envio chega por e-mail aos responsáveis e fica numa lista de envios, um a um, com status de atendimento, filtros e CSV, dentro da comunidade, sem Google Forms nem Typeform.

Formulários é um módulo de espaço, na aba Comunidade de Adicionar Espaço, com a descrição "Colete dados de membros e visitantes, com lista de envios". Todo formulário mora num espaço de Formulários.

#Formulário ou pesquisa

#Criar o espaço

1. Na barra lateral, Adicionar Espaço, aba Comunidade, Formulários.
2. Em Como o espaço funciona, escolha:
   • Um formulário: "O espaço é o próprio formulário e abre direto nele." O próximo passo da mesma janela pede o Título do formulário (e uma Introdução, opcional); Criar formulário termina no editor dele.
   • Vários formulários: "Uma lista: crie quantos formulários quiser neste espaço." O espaço abre na lista, com Novo formulário.
3. O formulário nasce como Rascunho: "ninguém vê até você publicar", nem pelo link.

#Quem cria

Quem o espaço deixa postar: a opção Quem pode postar do espaço (ver Espaços). O proprietário e o administrador sempre podem. Num espaço de Vários formulários, quem não está na seleção não vê Novo formulário (e a API responde 403). Num espaço de Um formulário, o formulário nasce com o espaço, por quem o criou.

Um membro que cria um formulário o gerencia como a equipe, com uma diferença: as opções Qualquer pessoa com o link e Salvar como membro são só da equipe (proprietário, administrador, moderador e financeiro). O membro não as vê no editor, e a API recusa com 403 se ele tentar ligá-las.

#O editor

O editor já é a tela que quem preenche vê: você escreve o título e a introdução no lugar, e cada campo aparece como vai aparecer.

• Etapas. O formulário se divide em etapas (seções), cada uma com título e descrição; quem preenche avança com Próximo. Nova etapa cria outra; Remover etapa remove a etapa e os campos dela (os envios já recebidos continuam com as respostas). Até 20 etapas.
• Campos. Adicionar campo ou o + entre dois campos insere no lugar. Até 100 campos por formulário. Arraste para reordenar, ou use Subir, Descer e Mover para a etapa.
• Propriedades. Clique num campo para abrir o painel Campo: Tipo, Obrigatório, Texto de exemplo no campo e, no número, Mínimo e Máximo. O rótulo e o Texto de ajuda você escreve no próprio campo. Duplicar e Remover ficam no painel.
• Salvar. O topo mostra Alterações não salvas ou Tudo salvo; Salvar grava.
• Prévia. Prévia mostra o formulário Como membro (com nome, e-mail e telefone de exemplo vindos de um perfil) ou Como visitante, sem salvar nada; no fim, ela mostra a mensagem de agradecimento ou para onde a pessoa iria.

#Os 14 tipos de campo

Nome, e-mail, telefone, empresa e cargo entram uma vez cada por formulário: são eles que formam o contato (na lista, na busca, nos e-mails e no Salvar como membro).

#Travar no perfil

Nos campos Nome, E-mail e Telefone, o membro logado já encontra o valor do perfil preenchido. Com Travar no perfil ligado ("Para membro logado, o valor vem do perfil e não se edita"), ele não muda o valor no formulário, e o campo mostra "Vem do seu perfil." Desligado, o valor vem preenchido e a pessoa pode trocar. Para o visitante, o campo é comum.

#Configurações

Configurações, no topo do editor, abre quatro abas. Elas valem quando você salva o formulário.

#Quem preenche

Marque pelo menos uma das duas primeiras. Um formulário aberto a visitantes sempre tem o campo Consentimento (LGPD): o editor o coloca sozinho e não deixa removê-lo.

#Depois do envio

• Mostrar uma mensagem: a Mensagem de agradecimento na própria tela. Sem uma escrita, aparece "Recebemos seu envio. Obrigado! Suas respostas chegaram à equipe."
• Levar para um site: a pessoa vai para o Link de destino, que precisa começar com https://.

#Prazo e limite

• Encerrar em: a data e a hora em que o formulário fecha sozinho, no fuso da comunidade (a sigla aparece ao lado). Sem data, fica aberto até você encerrar. Remover o prazo limpa.
• Limite de envios: "Ao chegar no limite, o formulário encerra sozinho." O limite é conferido no próprio envio: dois envios ao mesmo tempo nunca passam dele. Sem número, Sem limite.

#Avisos

• Responsáveis: quem recebe um e-mail a cada envio e vê a lista de envios, até 20 pessoas (busque pelo nome). Quem cria o formulário entra como responsável.
• Confirmação a quem enviou: ligada por padrão, manda o e-mail "Recebemos seu envio" para o endereço do campo de e-mail (para o membro logado, o e-mail da conta). O texto é fixo: diz só que a comunidade recebeu o envio, com a cor da comunidade, sem repetir as respostas.

#Publicar, encerrar e apagar

• Publicar pede pelo menos um campo além do consentimento. Se o formulário aceita membros, a publicação feita pela equipe avisa por e-mail quem tem acesso ao espaço, uma vez, 10 minutos depois, na categoria Formulários (ver E-mails desta comunidade). A publicação feita por um membro não manda e-mail.
• Encerrar para de aceitar envios; os recebidos continuam na lista. Reabrir abre de novo (com prazo vencido ou limite atingido, mude-os antes).
• Apagar remove o link do ar e o formulário some da lista. Os envios continuam guardados para o proprietário.
• Dá para editar o formulário em qualquer status. Cada envio guarda uma cópia do que foi enviado, com o rótulo do campo na hora.

#O link público

Copiar link, no editor, copia o endereço do formulário, no domínio da comunidade: clube.memberfy.net/f/…. O código do link é longo e não dá para adivinhar.

• Membro logado preenche pelo link ou pela lista do espaço, sem verificação anti-robô.
• Visitante (com Qualquer pessoa com o link ligado) preenche sem conta. Antes de enviar, o navegador resolve uma verificação anti-robô, invisível na maioria das vezes; há também um limite de envios por endereço de internet a cada 10 minutos. Passou do limite, a tela pede para esperar.
• Num formulário só para membros, quem não está logado vê "Entre para preencher. Este formulário é só para membros da comunidade."
• Com senha, a tela pede a Senha de acesso antes de mostrar os campos. Errar várias vezes bloqueia novas tentativas por alguns minutos, e depois de muitas senhas erradas no mesmo formulário em 1 hora, quem abre passa por uma verificação anti-robô antes de tentar de novo; o formulário não fica bloqueado. Se o acesso expirar enquanto a pessoa preenche, ela digita a senha de novo e as respostas continuam ali.

Os erros aparecem no próprio campo: "Preencha este campo.", "Digite um e-mail válido.", "Marque o consentimento para enviar.", "O mínimo é …".

#Incorporar no seu site

O botão Incorporar, ao lado de Copiar link, abre dois códigos para colar no HTML do seu site, onde o formulário deve aparecer:

• Script (recomendado): a altura se ajusta sozinha, sem barra de rolagem.
• iframe: para sites que não aceitam script; a altura é fixa (ajuste o height se precisar).

Os dois usam o domínio do link público do formulário (o domínio próprio da comunidade, quando ela tem um). Incorporado, o formulário aparece compacto, nas cores da comunidade; os links abrem numa nova aba, e o redirecionamento depois do envio leva a página onde ele está incorporado. Num formulário só para membros, o login abre numa nova aba. O resto funciona como pelo link: verificação anti-robô, senha de acesso, limites e Salvar como membro.

O idioma do formulário incorporado segue o data-lang do script (por exemplo, data-lang="pt-BR"; no link, ?lang=) e, sem ele, o idioma da comunidade, nunca o do navegador de quem visita. A janela Incorporar já preenche o data-lang com o idioma da comunidade.

#Consentimento (LGPD)

Quando o formulário aceita visitantes, a comunidade passa a coletar dados de quem não é membro e é a controladora desses dados. Por isso:

• o campo Consentimento (LGPD) é obrigatório e não se remove; o texto padrão é "Concordo com o uso destes dados para que a equipe entre em contato comigo.", e você pode reescrevê-lo;
• ao lado aparece o link da Política de privacidade que você informou (sem ela, os termos de uso da Memberfy) e o aviso "Seus dados vão para a equipe de …";
• cada envio guarda a prova do consentimento: o texto aceito, o link da política e a data e a hora. O envio aparece com Consentimento: Sim, "Aceito em …".

Os envios ficam guardados até alguém da equipe apagá-los; não há apagamento automático.

#Os envios

Envios, no editor (com o contador de Envios recebidos e quantos são novos), abre a lista. Cada linha traz a data, a origem (Membro ou Visitante), o nome, o e-mail e o status.

Quem vê: quem criou o formulário, a equipe (proprietário, administrador, moderador e financeiro) e os responsáveis. Os outros membros não abrem a lista, o envio nem o CSV (403).

• Status: Novo ("Ninguém falou com esta pessoa ainda."), Em contato e Concluído, em qualquer ordem, em Gerenciar envio.
• Filtros: status, origem, período (De e Até) e a busca "Buscar por nome, e-mail ou resposta".
• O envio: todas as respostas, a data, o membro (quando logado), o resultado do Salvar como membro e a prova do consentimento.
• Exportar CSV: os envios do filtro atual, uma coluna por campo, com status, origem e datas no fuso da comunidade.
• Apagar um envio o remove da lista e do CSV; os outros não mudam (e o limite de envios não reabre).

#Salvar como membro

Com Salvar como membro ligado, cada envio vira um contato dentro da comunidade:

• A tag tem o nome do formulário e é criada sozinha no primeiro envio (ver Tags).
• Sem senha no formulário. O formulário nunca pede senha de conta: a pessoa entra pelo e-mail de convite, como qualquer convidado (ver Convidar membros).
• Com a opção desligada, o envio fica só na lista do formulário.

#E-mails

Um mesmo endereço recebe no máximo um e-mail (confirmação ou convite) por formulário a cada 24 horas; os envios seguintes são guardados sem novo e-mail. Todos os e-mails saem pela fila, em segundo plano.

#Limites

#Integrações

Cada envio dispara o evento form.submitted ("Um formulário foi enviado", família Formulários): o formulário, o envio, a origem, o membro (quando logado), cada campo com o rótulo e a resposta e o consentimento. O endereço de internet de quem enviou nunca vai. Ver Eventos de webhook.

• Webhooks e Zapier, Make e n8n: assine form.submitted ou form.*.
• HubSpot: cria o contato com nome, e-mail, telefone, empresa, cargo e o consentimento.
• RD Station: registra a conversão "Enviou o formulário …" e, com o consentimento, a base legal.

Duas regras protegem os contatos que você já tem:

• Um visitante nunca altera um contato existente. Qualquer pessoa pode digitar o e-mail de outra num formulário aberto. Por isso, só o envio de um membro logado com o e-mail do próprio perfil mexe num contato que já está no CRM; o de um visitante vira uma nota no contato (HubSpot) ou só a conversão (RD Station). Ver os detalhes no artigo de cada app.
• Quem já ligou o HubSpot ou o RD Station precisa marcar o evento. As instalações existentes não ganham form.submitted sozinhas: abra a integração, marque Um formulário foi enviado e salve. Uma instalação nova já vem com ele.

#Pelo assistente

O assistente monta, publica e acompanha formulários com 17 ferramentas, com as mesmas regras do app (quem cria, opções só da equipe, quem vê os envios). Antes de publicar, ele chama publish_form com dry_run e mostra quantas pessoas recebem o aviso por e-mail e o que cada envio faz (com Salvar como membro, o convite); só publica depois do seu sim. Apagar um formulário ou um envio pede confirmação. O assistente só marca o consentimento ao preencher um formulário depois que você leu o texto e disse sim.

No Claude, a receita Coletar com um formulário faz o caminho inteiro. Ver Ferramentas · Membros e Receitas.

#Na API

As rotas da equipe ficam em /api/forms (com o X-CommunityId), e as de quem preenche pelo link em /api/public/forms/{token}. A lista completa, com exemplos, está na Referência da API, gerada da própria API.

#Perguntas frequentes

Dá para colocar o formulário no meu site? Sim: Incorporar, ao lado de Copiar link, dá os códigos para colar no seu site. Ver Incorporar no seu site. Também dá para colocar o endereço …/f/… num botão.

Dá para receber um arquivo ou cobrar no formulário? Não. Para cobrar, use um produto; para receber arquivos, um espaço de Suporte ou de Chamada de trabalhos.

Quem vê os dados de um visitante? Quem criou o formulário, a equipe e os responsáveis. A pessoa que preencheu é avisada disso na tela ("Seus dados vão para a equipe de …").

Apaguei o formulário. Perdi os envios? Não: eles continuam guardados para o proprietário, até ele apagar cada um.

#Relacionados

• Pesquisas
• Criar e organizar espaços
• Tags
• E-mails desta comunidade
• HubSpot · RD Station