Formulário de visitante
O formulário de visitante é a única página no GCM que você vai compartilhar mais do que qualquer outra. Ele vive numa URL pública — normalmente impressa no verso do seu boletim, num cartão com QR code no balcão de boas-vindas, ou linkada do site da sua igreja — e deixa um primeiro convidado entrar seus próprios dados pelo celular em cerca de noventa segundos.
Tudo que é enviado aterrissa na sua lista de Membros com tipo de membro Visitante. A partir daí, seu fluxo de acompanhamento assume — workflows podem mandar SMS de boas-vindas, atribuir um pastor de cuidado para acompanhamento, enfileirar o visitante para o check-in do próximo domingo, ou fazer os três.

Por que isso existe como módulo
O padrão "auto-cadastro" importa porque o workflow antigo — uma prancheta, um cartão de papel, e um voluntário digitando nomes no banco na segunda — vaza visitantes. Cartões se perdem. A caligrafia é ilegível. Terça vira sexta, o lead esfria e a segunda visita nunca acontece.
O formulário de visitante remove a etapa de digitação inteiramente. O celular do visitante é o dispositivo de entrada de dados. Eles tiram uma selfie, preenchem sete campos, tocam enviar — antes de sentarem de novo, o registro existe no GCM e (se você configurou) um WhatsApp de "obrigado por visitar" já foi.
O que você pode configurar
Abra Configurações → Formulário de visitante para acessar esta página. Você vai encontrar dois cartões:
- Acesso e link — liga ou desliga o formulário atrás de uma senha, mostra a URL para compartilhar, copia para sua área de transferência.
- Campos do formulário — controla quais campos aparecem, em que ordem, como são chamados, a que etapas pertencem e se são obrigatórios.
Você não precisa tocar em nenhum dos dois cartões para ter um formulário funcionando. Os padrões pedem nome, telefone, e-mail, foto e o básico — isso é o suficiente para a maioria das igrejas começando. Personalize quando os padrões ficarem pequenos.
O caminho dos dados
Celular do visitante → /visitor (página pública)
│
▼
submit_visitor_form RPC
│
┌──────────────┼──────────────┬─────────────────┐
▼ ▼ ▼ ▼
tabela members attendances valores de atribuição
(visitante) (se marcado) campos custom de org_unit
│
▼
trigger_workflow_member_created
│
▼
workflows disparam — SMS de boas-vindas, etc.Como o formulário é anônimo, todas as escritas passam por uma função Postgres SECURITY DEFINER (submit_visitor_form). RLS rejeitaria inserts anônimos de outra forma. A função roda do lado do servidor, valida o código de acesso da org se um estiver configurado, e insere as linhas relacionadas atomicamente — ou o membro, a foto, a linha de presença e a atribuição de unidade todos aterrissam, ou nenhum deles aterrissa.
Onde os visitantes aparecem
Depois que um visitante envia, eles aparecem em três lugares imediatamente:
- Membros → Todos os membros, com tipo de membro Visitante e um carimbo de "registrado hoje".
- Presença → Serviços de hoje, se eles marcaram a caixa de presença (o formulário sugere automaticamente o culto de domingo se eles estão preenchendo num domingo).
- Painel → widget Novos visitantes, com a foto deles e o nome de quem convidou (se eles digitaram um no campo "Quem te convidou?").
A etapa "graduar de visitante para membro" é manual — seus pastores de cuidado decidem, no próprio tempo, quando alguém cruzou a linha de ser membro. Mude o tipo de membro no perfil, ou dispare a partir de um workflow de marco de presença.
Para onde ir em seguida
- Ativando o formulário e compartilhando o link — coloque a URL na mão dos visitantes.
- Personalizando os campos exibidos — escolha o que você pergunta e onde.
- Proteção por código de acesso — quando você quer travar o formulário para uso apenas no local.
- Atribuição de hierarquia e presença — roteando visitantes para o campus ou pequeno grupo certo.
- Campos personalizados e foto — além dos campos embutidos.
- O que acontece depois do envio — gatilhos de workflow, acompanhamento, conversão para membro.
