Criar e configurar uma campanha

É a tela onde a campanha nasce. Em Campanhas o operador lista, cria, edita, ativa, desativa e exclui campanhas. A campanha é a entidade raiz do painel: lojas, produtos, prêmios, posições, formulário, hotsite, portal, conteúdos e participantes todos penduram nela. Depois de salva, a campanha ganha um hub de detalhe com as abas dos submódulos.

O operador abre Campanhas e usa "Nova campanha". O formulário é uma tela própria, não um modal, e traz um "Resumo da campanha" que acompanha o que está sendo preenchido.

A lista de campanhas

A lista mostra campanha, período, status e as ações Abrir, Editar, Ativar ou Desativar e Excluir. Excluir pede confirmação e o sistema decide se exclui ou apenas inativa a campanha, conforme o que já existe nela.

No ambiente compartilhado de uma plataforma parceira, como a Kaply, onde vários clientes dividem o mesmo painel, a lista ganha o filtro e a coluna "Cliente", com a quantidade de campanhas de cada um e a opção "Sem cliente" para as campanhas criadas no próprio painel. Fora desse ambiente o filtro e a coluna não aparecem.

Dados principais

Nome, rota do hotsite, data e hora de início, data e hora de fim, responsável e conta de e-mail. Nome, rota, datas e responsável são obrigatórios, e a data de fim precisa ser depois da de início.

Responsável e conta de e-mail não são digitados: são seletores que leem os cadastros auxiliares. O responsável vem de Responsáveis, e o botão "Novo responsável" permite cadastrar um sem sair da tela. A conta de e-mail (SMTP) é opcional e vem de Contas de e-mail; ela é o servidor que dispara os e-mails da campanha, não o e-mail de contato do responsável.

Limites e validações

Neste bloco ficam a idade mínima para menores, os prêmios por NF e por CPF, e as opções Valida CNPJ, Valida chave da nota, Validar estado, Permite menor de idade, Usa aceite, Aceite obrigatório, Apenas stories Instagram, Ganhador único e Seleciona loja.

Alguns pontos de atenção:

• Validar anexo NF não tem mais efeito. Quem decide se a foto da nota é obrigatória é o campo "Anexe a nota fiscal" na aba Formulário da campanha. A própria tela avisa isso.
• Validar estado faz a nota só ser aceita se o estado dela for o mesmo em que o participante declarou residir. O estado passa a ser obrigatório na nota e no cadastro.
• Sem Permite menor de idade, a campanha fica limitada a maiores de 18 anos. Com a opção marcada, a idade mínima precisa ser menor que 18.
• Chance por cadastro aparece só para leitura, com a observação "definida pela regra de geração": quem liga isso é uma regra de geração de base cadastro no Sorteio, não um campo da campanha.
• Prazo de resgate (dias) só aparece quando a campanha tem a modalidade Pontos. Vai de 0 a 365 dias depois do fim da campanha; em branco, a troca de pontos fecha junto com a campanha.

Estados participantes

A campanha pode ser nacional (todos os estados) ou só em estados específicos. Em campanha de estados específicos, o participante precisa informar o estado onde mora e a nota precisa ser de um estado marcado — o resto é recusado. Escolhida essa opção, é preciso marcar ao menos um estado.

Leitura de QR Code do cupom fiscal

A chave fica fora da grade das outras opções, com etiqueta Beta e confirmação para ligar. A leitura só passa a valer depois de salvar a campanha. Desligar é imediato. Toda campanha nasce com ela desligada.

Comunidade no WhatsApp

Dois campos opcionais: o link de convite da comunidade e o id da comunidade na Kaply. O link sozinho só faz o hotsite mostrar o botão "Entrar na comunidade" no fim do cadastro, para quem aceitou receber novidades. Com o id, a entrada na comunidade passa a render as chances da regra de base comunidade na modalidade Sorteio. O link precisa ser um convite do WhatsApp e aceita até 300 caracteres; o id aceita até 80, exige o link e é único entre clientes.

Modalidades da campanha

O operador marca uma ou mais modalidades — Sorteio, Posição premiada, Cupom de participação e Pontos — e, em cada uma, adiciona as regras de geração. As regras somam. Essa parte tem artigo próprio.

No card do Sorteio fica a série, que é o formato do número da sorte. Ela é obrigatória e pode ser trocada à vontade até a campanha gerar o primeiro número. Depois disso o seletor fica travado para todos os papéis, inclusive o Master, e a própria modalidade Sorteio não pode mais ser desmarcada. Se a série escolhida for inativada depois, ela continua valendo na campanha e aparece com a marca "(inativa)".

Na edição, salvar a campanha com uma modalidade desmarcada pede confirmação antes de removê-la. A regra de geração continua cadastrada e pode ser reutilizada se a modalidade for marcada de novo.

Salvar

O botão é "Salvar campanha". As modalidades são gravadas logo depois dos dados principais, em etapas separadas. Se essa segunda parte falhar, a tela avisa que a campanha foi salva e as modalidades não. Em campanha em andamento, trocar regra pede confirmação; cancelar essa confirmação salva os dados da campanha e não salva a troca de regra.

O hub da campanha

Depois de salva, o hub da campanha mostra a visão geral com o resumo (período, idade, prêmios por NF e por CPF), as ações de editar, ativar e desativar e as abas dos submódulos: Produtos, Lojas, Prêmios, Posições, Hotsite, Portal, Conteúdos, Formulário, Vídeos e Stories.

Posições e Vídeos só aparecem quando a campanha tem a modalidade Posição premiada. Abrir a URL de um submódulo não ativado não dá erro: a tela explica que o recurso não está ativo e leva de volta ao formulário da campanha. Desativar um recurso não apaga nada — o que já estava cadastrado volta a aparecer quando o recurso for reativado.

Se a leitura das modalidades falhar, as abas que dependem delas continuam visíveis e a tela mostra um aviso, para não esconder configuração existente.

A campanha é o primeiro passo: sem ela, nada mais pode ser cadastrado. O cliente precisa ter, antes de começar, o responsável legal cadastrado, a rota do hotsite e o período definido. A conta de e-mail pode esperar, mas sem ela a campanha não envia e-mail de aprovação nem de reprovação.

As abas que aparecem no detalhe da campanha dependem do que foi marcado. Se o cliente pergunta por que não vê a aba Posições, a resposta é que a modalidade Posição premiada não está marcada.

No Sorteio, vale combinar a série antes de a campanha começar a gerar números. Depois do primeiro número a série não muda mais, nem pelo Master; para usar outro formato, só criando uma campanha nova.

O leitor de QR Code é um recurso em versão BETA: pode falhar na leitura do cupom ou na identificação dos produtos, e o participante sempre pode preencher a nota manualmente. Essa é a frase acordada e não deve ser reescrita.

• Falha: o seletor de responsável aparece vazio e não dá para salvar a campanha.
• Possivel causa: nenhum responsável cadastrado no cliente ainda.
• Como orientar: use o botão "Novo responsável" no próprio formulário ou cadastre em Cadastros e Responsáveis.
• Quando escalar: se houver responsável cadastrado e o seletor continuar vazio, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a tela pede para escolher a série da modalidade Sorteio.
• Possivel causa: o Sorteio está marcado sem série. A série é obrigatória nessa modalidade.
• Como orientar: escolha a série no card do Sorteio. Se a lista estiver vazia, cadastre uma em Cadastros e Séries.
• Quando escalar: se houver série ativa cadastrada e ela não aparecer no seletor, abrir issue no Jira (projeto DEV) com prints.

• Falha: o seletor de série está desabilitado ou a modalidade Sorteio não pode ser desmarcada.
• Possivel causa: a campanha já gerou número da sorte. A partir daí a série fica travada para todos os papéis.
• Como orientar: explique que é proteção para a campanha não ter números em dois formatos. Para usar outra série, é preciso criar uma campanha nova.
• Quando escalar: não é falha. Só escalar se a trava aparecer em campanha que ainda não gerou nenhum número.

• Falha: a aba de um submódulo não aparece no detalhe da campanha.
• Possivel causa: a modalidade que habilita aquele submódulo não está marcada na campanha.
• Como orientar: abra o formulário da campanha e confira as modalidades marcadas. Posições e Vídeos dependem da modalidade Posição premiada.
• Quando escalar: se a modalidade estiver marcada e a aba continuar ausente, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a campanha foi salva, mas as modalidades não.
• Possivel causa: as modalidades são gravadas em etapas separadas depois dos dados principais, e uma delas foi recusada.
• Como orientar: a própria tela avisa o que ficou salvo. Salve de novo: a segunda tentativa aplica apenas o que faltou. Se a tela pedir para reabrir a campanha, feche e abra de novo antes de salvar.
• Quando escalar: se o segundo salvamento também falhar, abrir issue no Jira (projeto DEV) com as evidências e a mensagem exibida.

• Falha: o id da comunidade dá erro ao salvar.
• Possivel causa: o id já está ligado a outro cliente ou foi informado sem o link de convite.
• Como orientar: confirme com o cliente o id correto e preencha também o link de convite. O campo em branco desliga a integração.
• Quando escalar: se o id estiver correto e nunca tiver sido usado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o campo Prazo de resgate não aparece no formulário.
• Possivel causa: a campanha não tem a modalidade Pontos marcada.
• Como orientar: o prazo só existe em campanha de Pontos. Marque a modalidade se a campanha realmente usa troca de pontos.
• Quando escalar: se a modalidade Pontos estiver marcada e o campo continuar ausente, abrir issue no Jira (projeto DEV) com prints.