Voltar para artigos
Painel AdminIntermediarioAtualizado em 30 de out. de 2026

Formulário da campanha

Como a aba Formulário define o que é obrigatório no cadastro do participante e no envio da nota

#painel-admin#campanhas#operacao

O que e?

É a aba da campanha onde o operador decide o que é pedido ao participante: quais campos aparecem, com que nome, em que ordem e quais são obrigatórios. São duas listas independentes: Dados do participante e Dados da nota fiscal. Essa aba é a fonte única da obrigatoriedade: o que está marcado aqui vale no hotsite, no cadastro por integração de parceiro, na edição de perfil e também na edição do cadastro feita pelo painel.

Como funciona?

A aba Formulário abre com a escolha entre as duas listas. Cada linha é um campo, com quatro colunas:

  • Ordem: a posição do campo no formulário. Muda arrastando pela alça, e a numeração se ajusta sozinha.
  • Campo e Rótulo: o campo diz qual informação é pedida e o tipo de dado; ele é definido na criação e não muda. O rótulo é o nome que o participante lê na tela e pode ser escrito como o cliente quiser.
  • Obrigatório: marcado, o participante não consegue enviar sem preencher.
  • Ativo: marcado, o campo aparece no formulário. Desmarcado, ele deixa de ser pedido, mas nada é apagado: o que já foi preenchido continua guardado, e marcar de novo traz o campo de volta como estava.

Acima da lista há o bloco de ajuda "Como ler esta lista", que nasce fechado e abre pelo ícone de informação.

Campos padrão e personalizados

Os campos padrão já vêm com a campanha e são os que o sistema usa para funcionar: identificar o participante, validar a nota e enviar os e-mails. Eles não podem ser removidos, apenas desativados — a tela nem oferece a ação de remover para eles.

Os campos personalizados são criados pelo botão "Adicionar campo personalizado". O operador informa:

  • Rótulo: o texto que o participante vê, por exemplo "Nome da mãe".
  • Referência: o identificador do campo, usado na integração e nos dados extras do cadastro. Sem espaços, começando por letra e com palavras separadas por sublinhado, no padrão Nome_Da_Mae. Não pode repetir outra referência do mesmo formulário e não pode ser alterada depois.
  • Tipo do campo: Texto, Número, Data, Documento (CPF/CNPJ), E-mail, Telefone, CEP, Moeda, Arquivo, Sim/Não ou Texto longo. O tipo define a validação e não pode ser alterado depois: para trocar, é preciso remover o campo e criar outro.
  • Preenchimento obrigatório: se o campo já nasce obrigatório.

Só campos personalizados podem ser removidos, e a remoção pede confirmação e não pode ser desfeita.

Salvar

As mudanças de rótulo, obrigatoriedade, ativo e ordem ficam pendentes até o botão "Salvar", que mostra quantas alterações serão gravadas. Trocar de lista com alterações não salvas pede confirmação para descartá-las. Se o salvamento falhar, a lista é recarregada com os dados atuais e as alterações não salvas são descartadas.

Dois campos que merecem atenção

O campo "Anexe a nota fiscal", na lista Dados da nota fiscal, é quem decide se a foto da nota é obrigatória. A opção antiga "Validar anexo NF" continua no formulário da campanha, mas não tem mais efeito, e a própria tela avisa isso.

O campo de sexo faz parte dos campos padrão do participante e é opcional. Nas campanhas criadas antes dele, chega desativado — o operador habilita pela tela se quiser usar.

A obrigatoriedade vale também na edição pelo painel

Quando a campanha marca um campo como obrigatório, a edição do cadastro pelo painel passa a exigi-lo também. Isso vale inclusive quando o operador está mexendo em outro campo: a conferência é sobre o estado final do cadastro. O caso comum é o cadastro antigo, gravado antes de o campo passar a ser exigido — salvar qualquer alteração obriga a preencher o pendente na mesma operação, e a mensagem lista todos de uma vez, pelo rótulo da tela.

Como explicar ao cliente?

O formulário é onde o cliente decide o que vai pedir ao participante. Tudo que ele marcar como obrigatório passa a bloquear o cadastro no hotsite e também a correção de cadastros antigos pelo painel.

Vale avisar antes de o cliente marcar um campo novo como obrigatório no meio da campanha: os participantes que já se cadastraram não responderam aquele campo, e o operador vai topar com a exigência na primeira vez que precisar editar um desses cadastros. Marcar no começo, ou deixar opcional, evita retrabalho.

Campo padrão não se apaga, só se desliga. Se o cliente quer o campo fora da tela do participante, desmarcar Ativo resolve.

Campo personalizado precisa ser pensado antes de criar: a referência e o tipo não mudam depois.

Se o cliente quer que a foto da nota seja obrigatória, o lugar é o campo "Anexe a nota fiscal" na lista Dados da nota fiscal, não a opção antiga da campanha.

Possiveis falhas, causas e solucoes

  • Falha: o campo esperado não aparece no cadastro do hotsite.
  • Possivel causa: o campo está desativado no formulário da campanha ou é um campo personalizado que nunca foi criado.
  • Como orientar: abra a aba Formulário da campanha e confira se o campo está ativo na lista Dados do participante.
  • Quando escalar: se o campo estiver ativo e continuar ausente no hotsite, abrir issue no Jira (projeto DEV) com as evidências e o nome da campanha.
  • Falha: não dá para salvar a edição do cadastro de um participante antigo.
  • Possivel causa: algum campo marcado como obrigatório no formulário desta campanha está sem resposta nesse cadastro.
  • Como orientar: a mensagem lista todos os campos pendentes pelo rótulo da tela. Preencha todos na mesma edição e salve.
  • Quando escalar: se a mensagem apontar um campo que não existe mais no formulário, abrir issue no Jira (projeto DEV) com as evidências.
  • Falha: o botão de remover não aparece em um campo do formulário.
  • Possivel causa: é um campo padrão da campanha, e campo padrão não se remove.
  • Como orientar: explique que campo padrão só se desativa. Desmarque Ativo para tirar o campo da tela do participante.
  • Quando escalar: não é falha. Só escalar se desativar não surtir efeito no hotsite.
  • Falha: o campo personalizado não é criado e a tela acusa a referência.
  • Possivel causa: a referência tem espaço, começa por número ou repete a de outro campo do mesmo formulário.
  • Como orientar: use o padrão Nome_Da_Mae, começando por letra, com palavras separadas por sublinhado e sem repetir outra referência.
  • Quando escalar: se a referência seguir o padrão, não repetir nenhuma outra e continuar recusada, abrir issue no Jira (projeto DEV) com prints.
  • Falha: o cliente quer mudar o tipo ou a referência de um campo personalizado.
  • Possivel causa: tipo e referência são definidos na criação e não podem ser alterados.
  • Como orientar: remova o campo e crie outro com o tipo ou a referência certa. Avise que a remoção não pode ser desfeita.
  • Quando escalar: não é falha.
  • Falha: as alterações sumiram depois de clicar em Salvar.
  • Possivel causa: o salvamento falhou e a tela recarregou a lista com os dados atuais, descartando o que não foi gravado.
  • Como orientar: leia a mensagem exibida, refaça as alterações e salve de novo.
  • Quando escalar: se o salvamento falhar de novo com os mesmos dados, abrir issue no Jira (projeto DEV) com a mensagem e o nome da campanha.
  • Falha: a foto da nota continua obrigatória mesmo depois de desmarcar a opção antiga da campanha.
  • Possivel causa: a opção "Validar anexo NF" não decide mais nada. Quem decide é o campo "Anexe a nota fiscal" no formulário da nota.
  • Como orientar: abra a aba Formulário da campanha, vá para Dados da nota fiscal e desmarque a obrigatoriedade do campo "Anexe a nota fiscal".
  • Quando escalar: se o campo estiver opcional e a nota continuar sendo recusada sem anexo, abrir issue no Jira (projeto DEV) com as evidências.

Exemplo de resposta pronta

Olá! Quem decide os campos do cadastro e do envio da nota é a aba Formulário da campanha. Lá existem duas listas: Dados do participante e Dados da nota fiscal. Em cada campo você escolhe o rótulo que o participante vê, se ele é obrigatório, se está ativo e em que ordem aparece, e depois clica em Salvar. Se precisar de algo que não está na lista, use "Adicionar campo personalizado" — só lembre que a referência e o tipo do campo não mudam depois de criado. Um aviso importante: quando um campo passa a ser obrigatório, ele também passa a ser exigido na hora de editar cadastros antigos pelo painel, então, se já houver gente cadastrada, pense se o campo precisa mesmo ser obrigatório agora.

Quando escalar?

Acione o time de desenvolvimento urgentemente e abra issue no Jira (projeto DEV) com as evidências quando o formulário salvar e o hotsite continuar mostrando a configuração antiga, quando a obrigatoriedade exigida na edição apontar um campo que não existe mais, quando a lista de campos aparecer duplicada ou vazia, ou quando a configuração do formulário estiver bloqueando o cadastro de participantes em produção. Anexe prints, o nome da campanha e o rótulo do campo envolvido.

Artigos relacionados

Painel AdminBasico
Criar e configurar uma campanha

Como o operador cria a campanha no painel e o que cada bloco do formulário decide

#painel-admin#campanhas#operacao
Atualizado em 30 de out. de 2026
Painel AdminIntermediario
Participantes da campanha

Como buscar um participante ler o detalhe dele e editar o cadastro pelo painel

#painel-admin#campanhas#operacao
Atualizado em 30 de out. de 2026
Painel AdminIntermediario
Notas fiscais no painel

Onde o operador vê a nota de um participante e como cancelar uma nota com motivo

#painel-admin#campanhas#operacao
Atualizado em 30 de out. de 2026