Formulários

O formulário recolhe 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 registo 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 estado de atendimento, filtros e CSV, dentro da comunidade, sem Google Forms nem Typeform.

Formulários é um módulo de espaço, no separador Comunidade de Adicionar Espaço, com a descrição "Colete dados de membros e visitantes, com lista de envios". Todos os formulários vivem num espaço de Formulários.

#Formulário ou inquérito

#Criar o espaço

1. Na barra lateral, Adicionar Espaço, separador 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 passo seguinte 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 publicar: a opção Quem pode publicar do espaço (ver Espaços). O proprietário e o administrador podem sempre. 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, criado por quem criou o espaço.

Um membro que cria um formulário gere-o como a equipa, com uma diferença: as opções Qualquer pessoa com o link e Salvar como membro são só da equipa (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á é o ecrã que quem preenche vê: escreve o título e a introdução no próprio lugar, e cada campo aparece como vai aparecer.

• Etapas. O formulário divide-se em etapas (secções), cada uma com título e descrição; quem preenche avança com Próximo. Nova etapa cria outra; Remover etapa retira 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 escrevem-se no próprio campo. Duplicar e Remover ficam no painel.
• Guardar. O topo mostra Alterações não salvas ou Tudo salvo; Salvar grava.
• Pré-visualização. Prévia mostra o formulário Como membro (com nome, e-mail e telefone de exemplo vindos de um perfil) ou Como visitante, sem guardar nada; no fim, 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 contacto (na lista, na pesquisa, nos e-mails e no Salvar como membro).

#Travar no perfil

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

#Configurações

Configurações, no topo do editor, abre quatro separadores. Valem quando guarda o formulário.

#Quem preenche

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

#Depois do envio

• Mostrar uma mensagem: a Mensagem de agradecimento no próprio ecrã. Sem nenhuma escrita, aparece "Recebemos seu envio. Obrigado! Suas respostas chegaram à equipa."
• Levar para um site: a pessoa vai para o Link de destino, que tem de começar com https://.

#Prazo e limite

• Encerrar em: a data e a hora em que o formulário fecha sozinho, no fuso horário da comunidade (a sigla aparece ao lado). Sem data, fica aberto até o encerrar. Tirar o prazo limpa.
• Limite de envios: "Ao chegar no limite, o formulário encerra sozinho." O limite é verificado no próprio envio: dois envios ao mesmo tempo nunca o ultrapassam. 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 (pesquise pelo nome). Quem cria o formulário entra como responsável.
• Confirmação a quem enviou: ligada por predefinição, envia o e-mail "Recebemos o seu envio" para o endereço do campo de e-mail (para o membro com sessão iniciada, o e-mail da conta). O texto é fixo: diz apenas 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 equipa 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 envia e-mail.
• Encerrar deixa de aceitar envios; os recebidos continuam na lista. Reabrir volta a abri-lo (com o prazo expirado ou o limite atingido, altere-os antes).
• Apagar desliga o link e o formulário desaparece da lista. Os envios continuam guardados para o proprietário.
• O formulário pode ser editado em qualquer estado. Cada envio guarda uma cópia do que foi enviado, com o rótulo do campo nesse momento.

#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 impossível de adivinhar.

• O membro com sessão iniciada preenche pelo link ou pela lista do espaço, sem verificação anti-robô.
• O 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; existe também um limite de envios por endereço de internet a cada 10 minutos. Se o ultrapassar, o ecrã pede para esperar.
• Num formulário só para membros, quem não tem sessão iniciada vê "Inicie sessão para preencher. Este formulário é só para membros da comunidade."
• Com senha, o ecrã pede a Senha de acesso antes de mostrar os campos. Errar várias vezes bloqueia novas tentativas durante 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 escreve a senha de novo e as respostas continuam lá.

Os erros aparecem no próprio campo: "Preencha este campo.", "Escreva 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 ajusta-se sozinha, sem barra de deslocamento.
• 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 tem um). Incorporado, o formulário aparece compacto, nas cores da comunidade; os links abrem num novo separador, e o redirecionamento depois do envio leva a página onde está incorporado. Num formulário só para membros, o início de sessão abre num novo separador. 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-PT"; na ligação, ?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 recolher dados de quem não é membro e é a responsável pelo tratamento desses dados. Por isso:

• o campo Consentimento (LGPD) é obrigatório e não pode ser removido; o texto predefinido é "Concordo com o uso destes dados para que a equipa entre em contacto comigo.", e pode reescrevê-lo;
• ao lado aparece o link da Política de privacidade que indicou (sem ela, os termos de utilização da Memberfy) e o aviso "Seus dados vão para a equipa de …";
• cada envio guarda a prova do consentimento: o texto aceite, 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 equipa os apagar; não há eliminação automática.

#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 estado.

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

• Estado: Novo ("Ninguém falou com esta pessoa ainda."), Em contacto e Concluído, por qualquer ordem, em Gerenciar envio.
• Filtros: estado, origem, período (De e Até) e a pesquisa "Buscar por nome, e-mail ou resposta".
• O envio: todas as respostas, a data, o membro (quando tem sessão iniciada), o resultado do Salvar como membro e a prova do consentimento.
• Exportar CSV: os envios do filtro atual, uma coluna por campo, com estado, origem e datas no fuso horário da comunidade.
• Apagar um envio retira-o 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 passa a ser um contacto dentro da comunidade:

• A tag tem o nome do formulário e é criada automaticamente no primeiro envio (ver Tags).
• Sem senha no formulário. O formulário nunca pede uma 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 apenas 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 ("Foi enviado um formulário", família Formulários): o formulário, o envio, a origem, o membro (quando tem sessão iniciada), cada campo com o rótulo e a resposta e o consentimento. O endereço de internet de quem enviou nunca é incluído. Ver Eventos de webhook.

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

Duas regras protegem os contactos que já tem:

• Um visitante nunca altera um contacto existente. Qualquer pessoa pode escrever o e-mail de outra num formulário aberto. Por isso, só o envio de um membro com sessão iniciada e com o e-mail do próprio perfil mexe num contacto que já está no CRM; o de um visitante passa a ser uma nota no contacto (HubSpot) ou apenas a conversão (RD Station). Ver os detalhes no artigo de cada app.
• Quem já tinha ligado o HubSpot ou o RD Station tem de marcar o evento. As instalações existentes não recebem form.submitted automaticamente: abra a integração, marque Foi enviado um formulário e guarde. 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 da aplicação (quem cria, opções só da equipa, quem vê os envios). Antes de publicar, 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 de ter lido o texto e dito que sim.

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

#Na API

As rotas da equipa 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 a partir da própria API.

#Perguntas frequentes

Dá para pôr 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 pode colocar o endereço …/f/… num botão.

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

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

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

#Relacionados

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