Convites da base para a próxima campanha

O convite é a ação que fecha a Base: escolher um público da base do cliente e chamar essas pessoas para a próxima campanha, com um benefício opcional para quem vier. Ele parte da base — a união de segmentos que atravessa campanhas — e aponta para uma campanha de destino.

O convite não tem item de menu. A entrada é o botão "Convidar este público", no cabeçalho de Segmentos, com o segmento aberto já marcado. A lista dos convites já montados é alcançada pelo link "Ver os convites já montados", no rodapé dos cartões de Segmentos. Isso tem razão de fluxo: convidar é o que se quer fazer depois de olhar um segmento.

O convite é montado em quatro passos: público, benefício, mensagem e revisão.

Passo 1: o público

O operador escolhe a campanha de destino, marca e desmarca segmentos e vê oito contagens. Nada é gravado neste passo: dá para experimentar combinações sem encher a lista de rascunhos.

A campanha de destino decide quem já está dentro, qual regulamento vale e por qual conta de e-mail o convite sai. A lista traz só campanhas ativas que ainda não terminaram, e o destino não muda depois: para outra campanha, outro convite.

As oito contagens fecham como uma conta, e a tela as desenha empilhadas com sinal de menos: de quem aceita contato saem os já inscritos no destino, os que saíram daquela campanha, os descadastrados, os sem e-mail e os de e-mail repetido; o que resta é quem recebe o convite. Cada pessoa cai em uma linha só, pelo primeiro motivo que casa. A tela não arredonda para fechar: se a conta não fechar, ela avisa em vermelho e pede para avisar o time antes de enviar. Motivo com zero fica na lista, esmaecido.

Três pontos finos deste passo:

O aceite deste fluxo diverge do cartão do segmento, e a tela declara. Para enviar vale o aceite da participação mais recente; o cartão conta quem aceitou alguma vez. Quem desmarcou a caixa na inscrição mais nova disse "não" depois.

As contagens podem ser de até 45 segundos atrás, porque varrem a base inteira e ficam num cache curto. O retrato do envio e o CSV não leem esse cache.

"Já inscritos" e "saíram desta campanha" são duas linhas, não uma: quem tem qualquer participação no destino fica fora, cancelada ou não. E quem só tem participação cancelada não está na base, por isso não aparece em segmento nenhum.

Passo 2: o benefício

O rascunho nasce aqui, ao salvar este passo. Há quatro opções de benefício:

• Nenhum: só o convite, sem nada prometido. É o caminho mais usado.
• Chances extras na inscrição: chances somadas às que o cadastro já rende. Exige que o destino tenha Sorteio ativo, com regra ativa e série configurada.
• Multiplicador nas notas: aparece visível e desabilitado, com a marca "em breve". O mecanismo ainda não existe.
• Pontos de boas-vindas: pontos creditados uma vez na inscrição. Exige que o destino tenha a modalidade Pontos.

O benefício é concedido na inscrição de quem se cadastrar na campanha de destino, reconhecido pelo documento — não pelo clique no link.

Se a campanha de destino tem teto de chances por participante, a tela diz o número: o benefício é "até" o que o operador escrever, e com quantidade acima do teto a tela avisa que ele corta. Pontos não levam esse aviso, porque pontos não têm teto por participante.

Neste passo também entram o nome do convite, que é interno e o participante não vê, e a data "O link abre até". Vazia, vale o fim da campanha de destino. Depois dessa data o link do convite responde como inexistente, mas a inscrição na campanha continua funcionando.

A declaração do regulamento é obrigatória para enviar, não para salvar. O operador declara que o regulamento da campanha de destino prevê aquele benefício para convidados; o sistema não confere o texto do regulamento, e a declaração fica gravada com o usuário e a data. Sem ela o rascunho é salvo, mas o Enviar fica desabilitado, com o motivo na tela. Trocar o benefício derruba a declaração: a tela desmarca a caixa junto.

Passo 3: o assunto e o corpo

Funciona como o editor de e-mail da campanha, com o modo guiado e o modo HTML. A lista de variáveis do assunto e do corpo vem do servidor.

A prévia mostra o e-mail montado com um convidado fictício, a partir do que está na tela, e não grava nada. O modal diz qual das duas versões está mostrando: a da tela no montador, ou a da mensagem salva quando aberta pelo detalhe.

O botão de editar como HTML gera o HTML dos blocos atuais e troca o modo, sem gravar. Um modal lista o que muda: a cor fica fixa, o cartão do benefício sai sempre e o texto que estava no HTML é substituído. O caminho de volta pede confirmação, porque não há conversão de HTML para blocos — voltar ao guiado e salvar descarta o HTML, inclusive o que foi ajustado à mão.

Reabrir um rascunho devolve o corpo aos campos, mas só a forma do modo corrente: a do outro modo foi descartada ao salvar e começa em branco, e a tela diz de qual modo o corpo veio.

Passo 4: revisar e enviar ou agendar

A revisão mostra o que vai ser enviado e oferece Enviar agora ou Agendar, com o número de pessoas no botão. O convite sai pela conta de e-mail da campanha de destino, na velocidade que ela aceitar. Depois do disparo não há como desfazer.

O público é fotografado no clique do enviar, inclusive no agendamento, e a tela mostra a data do retrato. Quem se inscrever no destino entre o agendamento e a hora marcada continua na lista. O número do retrato não se move; as contagens de hoje, sim, e a tela separa os dois.

A hora digitada no agendamento é horário de Brasília, o horário do negócio, e a tela escreve isso ao lado do campo. Não depende do relógio da máquina de quem agenda. Hora no passado é recusada.

O aviso que aparece depois do disparo conta quem recebe o convite — o mesmo número que a revisão mostrava —, e não o total de selecionados.

As situações do convite

Um convite passa por Rascunho, Agendado, Enviando, Enviado, Pausado por falha e Cancelado. Só o rascunho se edita e se exclui. A partir do agendamento o convite já foi prometido a alguém.

Dez falhas seguidas no envio param o convite inteiro, que fica em Pausado por falha, com o erro visível.

A faixa vermelha com o motivo de não poder enviar só aparece quando o operador pode corrigir algo — por exemplo, assunto vazio ou regulamento não declarado. Nos convites já enviados ou cancelados, a própria situação diz o estado e não há faixa de erro.

Acompanhamento

O acompanhamento é um funil, e os números não se somam — ao contrário das oito contagens do passo 1, que fecham. Quem se inscreveu sem clicar conta em inscritos e não em cliques, porque quem autoriza o benefício é o documento e não o clique. Por isso a tela desenha barras proporcionais ao retrato, com a porcentagem de quem está acima.

Os concedidos ficam fora do funil. O teto de chances por participante pode cortar o benefício a zero, e aí a pessoa se inscreveu e não ganhou nada — é a diferença que o suporte vai ter de explicar. Convite sem benefício tem concedidos zero por definição, e a tela diz isso.

O acompanhamento vale a partir do retrato, e a tela escreve a data: inscritos conta só quem se inscreveu depois do envio. O total do retrato é o denominador que não se move, e é ele que explica, semanas depois, por que os cartões da Base dizem outro número.

A lista de destinatários e o CSV

Os suprimidos ficam na lista de destinatários, com o motivo. Suprimido não é ausente: é preciso poder explicar por que os selecionados viraram um número menor de enviados. Quem ficou de fora por aceite, por já estar no destino ou por descadastro não é destinatário — essa gente aparece nas contagens do público.

O erro de um destinatário sai por extenso: é a resposta do servidor de e-mail do próprio cliente, e é ela que diz se o problema é a caixa de uma pessoa ou o remetente inteiro.

O CSV traz todos os selecionados, cada um com a situação dizendo se recebe e, se não, por quê — diferente do CSV do segmento, que traz só quem aceita contato.

Reenviar, retomar e cancelar

Reenviar e retomar são dois atos diferentes, com dois botões e dois textos de confirmação: Reenviar alcança só quem falhou, com as tentativas zeradas, e nunca quem já recebeu; Retomar segue pelos que continuam pendentes.

Cancelar não desfaz o que já saiu, e a confirmação diz as duas metades. O que ainda não saiu não sai, e a situação é final. Mas quem já recebeu o e-mail continua podendo ganhar o benefício se se inscrever dentro da validade: cancelar existe para parar um envio que deu problema, não para retirar o que foi prometido. Rascunho, agendado e pausado por falha podem ser cancelados; o botão some quando o convite não é cancelável, e o motivo ocupa o lugar dele.

Permissões

As permissões reaproveitam ler e editar participações; não há recurso novo na matriz.

O envio é diferente: enviar, reenviar falhas, retomar e cancelar exigem o papel Master. Essas ações disparam muitos e-mails no nome do cliente e comprometem o benefício. Montar, salvar o rascunho, pré-visualizar e gerar o HTML não exigem o Master. No painel, botão sem permissão não aparece, e a tela diz em uma linha de quem é a ação.

A exportação exige, além de ler participações, a global Exportar dados.

O convite é como o cliente chama a própria base para a campanha nova. Seis orientações:

A entrada é pelo botão "Convidar este público", em Base e Segmentos, não por um item de menu.

O passo 1 não grava nada. O cliente pode experimentar combinações de segmentos à vontade; o rascunho só nasce no passo 2, quando ele decide o benefício.

As oito contagens do passo 1 explicam quem fica de fora e por quê. Vale ler essa conta com o cliente antes de enviar: é onde ele descobre, por exemplo, que parte da lista não tem e-mail.

Benefício de chances exige Sorteio ativo com série no destino, e benefício de pontos exige a modalidade Pontos no destino. O multiplicador ainda não existe.

Enviar, reenviar, retomar e cancelar são do Master. Montar, pré-visualizar e salvar o rascunho não são.

O acompanhamento é um funil e os números não somam. Os concedidos ficam fora dele: o teto de chances da campanha pode cortar o benefício a zero — esse é o caso que mais chega ao suporte. E cancelar não tira o benefício de quem já recebeu o e-mail.

• Falha: o cliente não encontra Convites no menu.
• Possivel causa: o convite não tem item de menu de propósito. A entrada é um botão no cabeçalho de Segmentos.
• Como orientar: oriente a abrir Base, depois Segmentos, e usar o botão "Convidar este público". A lista dos convites já montados está no link do rodapé dos cartões.
• Quando escalar: não é falha.

• Falha: as oito contagens do passo 1 não fecham.
• Possivel causa: cada pessoa deveria cair em exatamente uma linha e a conta deveria fechar. A tela sinaliza em vermelho quando não fecha.
• Como orientar: registre os oito números exibidos e não envie o convite. Não contorne na conversa com o cliente.
• Quando escalar: acionar o time de desenvolvimento e abrir issue no Jira (projeto DEV) com as evidências e os oito números.

• Falha: o número de quem aceita contato no passo 1 é diferente do cartão do segmento.
• Possivel causa: para enviar vale o aceite da participação mais recente, enquanto o cartão conta quem aceitou alguma vez.
• Como orientar: explique a divergência que a própria tela declara. Quem desmarcou a caixa na inscrição mais nova disse não depois.
• Quando escalar: não é falha.

• Falha: o botão de enviar o convite está desabilitado ou não aparece.
• Possivel causa: a declaração do regulamento não foi marcada, o assunto está vazio ou o papel do usuário não é Master. O motivo aparece na própria tela.
• Como orientar: leia o motivo exibido. Se for a declaração, marque a caixa no passo do benefício. Se for permissão, peça ao Master do cadastro.
• Quando escalar: se o usuário for Master, a declaração estiver marcada e o botão continuar indisponível, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para escolher o benefício de chances ou de pontos.
• Possivel causa: chances exigem Sorteio ativo com regra ativa e série no destino. Pontos exigem a modalidade Pontos no destino. O multiplicador ainda não existe.
• Como orientar: confira as modalidades da campanha de destino ou escolha outro benefício.
• Quando escalar: se o destino atender às condições e o benefício continuar recusado, abrir issue no Jira (projeto DEV) com as evidências e a mensagem.

• Falha: o participante se inscreveu pelo convite e não recebeu o benefício.
• Possivel causa: o teto de chances por participante da campanha de destino cortou o benefício. Nesse caso a pessoa aparece em inscritos e não em concedidos.
• Como orientar: confira o teto de chances na regra da modalidade da campanha de destino. Explique que o benefício é até aquele limite.
• Quando escalar: se o participante estiver abaixo do teto e não tiver recebido o benefício, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o convite ficou em Pausado por falha.
• Possivel causa: dez falhas seguidas no envio param o convite inteiro. O erro vem do servidor de e-mail da campanha de destino.
• Como orientar: leia a mensagem de erro dos destinatários. Se for a mesma para todos, o problema é o remetente: confira a conta de e-mail da campanha de destino. Depois de corrigir, o Master usa Retomar ou Reenviar.
• Quando escalar: se a conta de e-mail estiver correta e as falhas continuarem, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências e as mensagens de erro.

• Falha: o número de inscritos do acompanhamento não bate com o cartão da Base.
• Possivel causa: o acompanhamento vale a partir do retrato tirado no envio e conta só quem se inscreveu depois dele.
• Como orientar: leia a data do retrato na própria tela. Ela é o que explica a diferença semanas depois.
• Quando escalar: não é falha.

• Falha: o convite foi cancelado e alguém ainda ganhou o benefício.
• Possivel causa: cancelar não desfaz o que já saiu. Quem recebeu o e-mail continua podendo ganhar se se inscrever dentro da validade.
• Como orientar: explique as duas metades que a confirmação do cancelamento informa. Cancelar para o envio pendente e não retira promessa feita.
• Quando escalar: não é falha.

• Falha: o corpo do convite foi perdido ao trocar de modo.
• Possivel causa: só a forma do modo corrente é guardada, e voltar do HTML ao guiado não converte nada. Salvar no guiado descarta o HTML.
• Como orientar: leia a confirmação antes de trocar de modo. A tela diz de qual modo o corpo veio ao reabrir o rascunho.
• Quando escalar: se o conteúdo tiver sido descartado sem confirmação, abrir issue no Jira (projeto DEV) com as evidências.