Crie Seu Primeiro Formulário — Tutorial Passo a Passo

Este tutorial mostra como criar, publicar e revisar seu primeiro formulário no TimelyChurch. Ao final, você terá um Cartão de Conexão com Visitantes funcionando que pode compartilhar via código QR, link ou e-mail — e terá revisado seu primeiro envio.

Tempo estimado: 10 minutos.

O Que Você Vai Criar

Um cartão de visitante simples que captura:

• Nome e sobrenome
• Endereço de e-mail (mapeado para o perfil de Pessoa para sincronização automática)
• Número de telefone
• Menu suspenso "Como você soube de nós?"
• Comentários opcionais

Quando alguém envia o cartão, um registro de Pessoa é criado automaticamente (ou correspondido se já existir), uma notificação por e-mail vai para seus administradores e o visitante vê uma página "Obrigado!".

Passo 1: Abrir o Módulo de Formulários

1. Entre no portal de administração do TimelyChurch.
2. Na barra lateral esquerda, clique em Formulários.
3. A página da lista de Formulários abre. Se for seu primeiro formulário, a lista estará vazia.

Dica: Se você não vê "Formulários" na barra lateral, seu papel pode não incluir o módulo Formulários. Veja 12-form-permissions.md para configuração de permissões.

Passo 2: Criar o Formulário

Você tem duas opções — escolha uma:

Opção A: Começar de um Modelo (recomendado para iniciantes)

1. Clique em Modelos (canto superior direito).
2. Escolha Cartão de Conexão com Visitantes na galeria.
3. O formulário é criado com todos os campos abaixo pré-montados e prontos para publicar. Pule para o Passo 4.

Veja 11-form-templates.md para a lista completa de modelos.

Opção B: Criar do Zero

1. Clique em Criar Formulário (canto superior direito).
2. Preencha:
   • Nome do Formulário: Cartão de Conexão com Visitantes
   • Descrição: Bem-vindo! Conte um pouco sobre você para podermos entrar em contato.
   • Tipo de Formulário: Formulário de Contato
3. Deixe as configurações nos padrões (Exigir Login: desligado, Permitir Múltiplos Envios: desligado, Enviar E-mail de Confirmação: ligado, Notificar Administradores: ligado).
4. Clique em Criar e Adicionar Campos. Você vai ao editor de campos, com a área do formulário no centro e a paleta de campos à esquerda.

Passo 3: Adicionar Campos

Na paleta à esquerda, clique nestes tipos de campo em ordem. Cada um é adicionado à área do formulário:

Para mapear um campo ao perfil de Pessoa: clique no campo para abrir o editor lateral, role até Mapeamento de Perfil, defina Mapeia para Modelo = Person e escolha o campo correspondente no menu. Veja 04-mapping-fields-to-profiles.md para a referência completa.

Quando terminar, clique em Salvar no canto superior direito do construtor. O indicador "Não salvo" deve desaparecer.

Passo 4: Configurar Sincronização e Notificações

1. Clique na aba Configurações.
2. Confirme que Modo de Sincronização de Perfil está em No Envio (padrão). Assim, dados de novos visitantes são gravados no banco de Pessoas imediatamente.
3. Confirme que Notificar Administradores está ligado para receber um e-mail por envio.
4. Opcionalmente adicione Destinatários Adicionais de Notificação (ex.: caixa compartilhada da equipe de acompanhamento).
5. Clique em Salvar Configurações.

Veja 05-profile-sync-settings.md para detalhes dos modos de sincronização.

Passo 5: Publicar o Formulário

1. De volta à página principal do formulário (ou do editor), clique em Publicar.

2. O selo de status muda de Rascunho para Publicado.

3. A URL pública aparece em um card destacado Link Público do Formulário (com botões Copiar Link e Abrir Formulário). Parece com:

   https://your-domain.com/c/your-church/forms/visitor-connection-card

Passo 6: Compartilhar

Você tem três opções rápidas — escolha a que se encaixa na sua situação:

• Código QR: Clique em Compartilhar para abrir o modal. Imprima ou capture o código QR para boletins, sinalização ou projetores.
• Link direto: Clique em Copiar Link e cole em e-mail, mensagem ou link no site.
• E-mail em massa: Clique em E-mail no modal para abrir seu cliente de e-mail com mensagem pré-composada.

Para incorporar no site da igreja, veja 08-embedding-forms.md.

Passo 7: Testar Você Mesmo

1. Abra a URL pública em uma janela privada/anônima para não estar logado como administrador.
2. Preencha o formulário com dados realistas, mas fictícios (use seu próprio e-mail para ver a confirmação).
3. Envie. Você deve chegar a uma página de confirmação "Obrigado!".
4. Verifique sua caixa de entrada — você deve receber:
   • O e-mail de confirmação (se Enviar E-mail de Confirmação estava ligado).
   • O e-mail de notificação para administradores (enviado a todos os administradores da igreja porque Notificar Administradores está ligado).

Passo 8: Revisar Seu Primeiro Envio

1. De volta ao portal de administração, clique no nome do formulário para abri-lo.
2. Clique em Ver Envios para abrir a lista. Seu envio de teste aparece.
3. Clique na linha do envio para ver os detalhes completos.
4. Observe:
   • Status: Revisão Pendente (todo novo envio começa aqui, mesmo com modo "No Envio").
   • Membro Vinculado: Uma nova Pessoa foi criada (ou correspondida), com link Ver Perfil do Membro.
   • Um selo Sincronizado mostra quando os campos mapeados foram gravados no perfil de Pessoa.
5. Clique em Aprovar para marcar o envio como revisado (puramente organizacional — os dados já estão salvos).
6. Opcionalmente clique em Sincronizar com Perfil para enviar manualmente os campos mapeados novamente.

Para opções mais profundas de fluxo (rejeição, ações em massa, exportações), veja:

• 06-managing-submissions.md
• 09-approval-workflows.md

Pronto — E Agora?

Com um formulário funcionando de ponta a ponta, estes são os próximos passos sensatos:

• Adicionar mais formulários — duplique este como ponto de partida ou escolha outro modelo na galeria (11-form-templates.md).
• Configurar destinatários personalizados — direcione formulários diferentes para equipes diferentes (ex.: Pedidos de Oração → equipe de oração) (07-form-notifications.md).
• Mapear campos personalizados de Pessoa — se você tem campos personalizados definidos para sua igreja, adicione-os a um formulário e eles sincronizam como os integrados (04-mapping-fields-to-profiles.md).
• Incorporar no site — coloque o formulário em um iframe no site público (08-embedding-forms.md).

Solução de Problemas

A URL pública mostra "Formulário Encerrado". O formulário ainda é Rascunho, atingiu o limite de envios ou a data de encerramento passou. Verifique o selo de status e a seção Limites de Envio em Configurações.

Enviei o teste, mas nenhum e-mail chegou.

• Confirme que Notificar Administradores está ligado em Configurações.
• Confirme que pelo menos um administrador da igreja tem e-mail verificado.
• Verifique a pasta de spam; se sua igreja usa e-mail em fila, a entrega pode levar alguns minutos.

Nenhum registro de Pessoa foi criado. O sistema precisa de pelo menos um e-mail ou nome + sobrenome para criar uma Pessoa. Certifique-se de que esses campos foram preenchidos e que o Modo de Sincronização é No Envio (ou acione sincronização manual na página do envio).

O campo Pagamento não me cobrou. Formulários pagos coletam pagamentos com cartão pelo Stripe, então sua igreja precisa ter o Stripe conectado primeiro (Configurações → Igreja → Integrações). Sem Stripe conectado, a etapa de pagamento não inicia. Veja 03-form-field-types.md para como funciona o campo Pagamento.