Formulário da campanha
Como a aba Formulário define o que é obrigatório no cadastro do participante e no envio da nota
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
Como o operador cria a campanha no painel e o que cada bloco do formulário decide
Como buscar um participante ler o detalhe dele e editar o cadastro pelo painel
Onde o operador vê a nota de um participante e como cancelar uma nota com motivo