Chance por cadastro e chance por comunidade

São duas bases de geração que rendem chance sem nota fiscal: a inscrição na campanha e a entrada na comunidade do cliente no WhatsApp. As duas valem só na modalidade Sorteio, não acumulam saldo e rendem uma única vez por participação.

A quantidade mora na regra, não na campanha

Nos dois casos, quantas chances o evento rende está numa base da regra de geração, não num campo da campanha. A razão é concreta: um campo na campanha exigiria construir, só para ele, todo o aparato que a regra já tem — a exigência de Master com confirmação na campanha em andamento, a linha de histórico, a proteção de regra em uso. E deixaria a quantidade num lugar e o limite que a corta em outro, já que o limite de chances do participante é da regra.

A pergunta "esta campanha dá chance por cadastro?" é calculada

A campanha tem uma marca de chance por cadastro, e ela deixou de ser o interruptor: hoje ela é calculada — existe regra ativa de base Cadastro na modalidade Sorteio? É esse valor que o painel e o hotsite leem.

O motivo é que dois escritores para a mesma pergunta alcançam estados incoerentes, e aqui os dois são ruins nas duas direções: marca ligada sem regra faz o hotsite prometer uma chance que o motor não dá; marca desligada com regra faz o hotsite esconder a chance que a inscrição rende. Com o cálculo, a tela e o motor respondem pela mesma consulta.

Para o atendimento, isso significa: se o hotsite anuncia chance por cadastro, é porque existe regra ativa para isso. Os dois não divergem.

Chance por cadastro

A chance nasce na inscrição, por um caminho que gera número sem nota — zero vínculos com nota fiscal. Isso não é caso especial: o vínculo nota-número sempre foi opcional, e a carga manual e a integração já produziam número sem nota.

A idempotência é pela participação. Se a participação já tem número de origem Cadastro, ela não gera outros. O cadastro não é uma entidade à parte: ele é a participação.

No cadastro por parceiro, os números da inscrição são emitidos na mesma operação do cadastro: ou tudo entra, ou nada entra. Inscrição repetida não gera de novo — ela é recusada antes.

Ligar a base no meio da campanha não é retroativo. Quem já se inscreveu antes não recebe a chance.

Chance por comunidade

A comunidade do cliente no WhatsApp é administrada por uma plataforma parceira de comunidade. A Kaply é a primeira, mas o contrato do aviso é da Premify, e outras plataformas podem ser ligadas pela equipe sem mudança de sistema. Na campanha, a comunidade é identificada pela plataforma e pelo identificador da comunidade naquela plataforma.

A mecânica liga as duas pontas sem acrescentar passo para o participante: no fim do cadastro, quem marcou que aceita receber novidades vê o botão de entrar na comunidade, com o link de convite da campanha. Quando ele entra, a plataforma parceira avisa a API, e o participante ganha as chances da base Comunidade.

Ninguém é posto na comunidade sem tocar no link — o WhatsApp não permite, e a autorização tem de ser do participante.

A associação é do participante, não da participação: a comunidade atravessa as campanhas do mesmo cliente. Isso tem um efeito prático importante — quem já é membro e se inscreve numa campanha nova da mesma comunidade recebe a chance daquela campanha na inscrição, sem precisar entrar de novo.

O bônus é um por participação, venha por onde vier. São dois gatilhos: o aviso de entrada (que alcança as participações ativas nas campanhas no ar daquela comunidade) e a inscrição de quem já é membro.

Sair e voltar não rende de novo. E sair não tira número — retirar número já distribuído é assunto de regulamento, não de integração.

A campanha precisa de duas coisas distintas: o link de convite, que o site mostra, e a comunidade configurada (plataforma e identificador), que liga o aviso à campanha. O link pode existir sem o identificador — é a comunidade sem integração. Nesse caso o sistema não tem como saber quem entrou: o convite continua aparecendo para quem aceitou contato, indefinidamente.

O convite continua aparecendo até a pessoa entrar. A decisão é da API, não da tela: há link, o participante aceitou novidades na inscrição e não é membro. Entrou, o convite some; saiu, volta.

O aviso da plataforma é verificado por assinatura, e cada plataforma só alcança as comunidades dela. Avisos repetidos são reconhecidos e não creditam duas vezes. Aviso de comunidade desconhecida, de telefone sem cadastro ou de evento não tratado é ignorado com sucesso, para a plataforma não repetir o que nunca vai ter o que fazer. Aviso mais antigo que o último já aplicado àquele membro também é ignorado.

O telefone é comparado por DDD e os oito últimos dígitos, porque a plataforma manda no formato internacional, o WhatsApp identifica alguns celulares antigos sem o nono dígito, e o cadastro guarda com ou sem máscara. Os quatro formatos dão a mesma chave.

Limite conhecido: quem entra na comunidade sem ter cadastro em nenhuma campanha do cliente não é registrado como membro, porque a associação é do participante. O fluxo desenhado é cadastro e depois convite, então é situação rara — mas, se acontecer, aquela pessoa não recebe a chance ao se inscrever depois.

Não confunda com as ações de comunidade, em que o membro pede um link pelo WhatsApp e joga sem cadastro no hotsite. Aquilo é outra mecânica, com artigo próprio.

Como essas chances se comportam nos limites

As chances sem nota contam no limite de chances do participante — tanto a por cadastro quanto a por comunidade. E a conta vale nos dois sentidos: o cadastro gera o que couber no limite, e a nota seguinte conta o que o cadastro gerou.

Quando o participante sai da campanha, essas chances são invalidadas pelo critério "chance válida desta participação que nenhuma nota formou". Não há estorno de saldo nesse caso, e não é esquecimento: chance sem vínculo de nota não tem parcela no saldo — ela é uma quantidade, não uma composição.

O story aprovado segue aprovado depois da saída: a saída derruba a chance dele, não a moderação.

São duas formas de dar chance sem depender de compra: pela inscrição e pela entrada na comunidade do WhatsApp. As duas são configuradas como uma regra de geração, igual às outras — com os mesmos cuidados para alterar com a campanha no ar — e as duas valem só no Sorteio.

Três pontos que o cliente precisa ouvir.

Elas rendem uma vez. Por participação, e não por repetição do evento. Na comunidade, sair e voltar não rende de novo; e sair não tira a chance já recebida.

Ligar no meio da campanha não é retroativo. Quem já se inscreveu antes não recebe a chance por cadastro.

Na comunidade, a plataforma e o identificador da comunidade são o que permite saber quem entrou. Campanha com o link e sem a comunidade configurada mostra o convite a quem aceitou novidades, mas não credita nada e não para de mostrar o convite — porque não sabe quem entrou. Vale conferir isso antes de anunciar a mecânica.

E há um detalhe bom de contar: como a comunidade é do cliente e não de uma campanha, quem já é membro recebe a chance ao se inscrever numa campanha nova da mesma comunidade, sem precisar entrar outra vez.

• Falha: o participante se inscreveu e não recebeu a chance por cadastro.
• Possivel causa: não existe regra ativa de base Cadastro no Sorteio daquela campanha, ou ele se inscreveu antes de a regra ser ligada, porque ligar no meio não é retroativo.
• Como orientar: confira se existe regra ativa de base Cadastro na modalidade Sorteio e desde quando. Se o hotsite anuncia a chance, é porque a regra existe.
• Quando escalar: se a regra estiver ativa, a inscrição for posterior a ela e a chance não tiver saído, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o participante entrou na comunidade e não recebeu a chance.
• Possivel causa: a campanha tem o link e não tem a comunidade configurada, então o sistema não sabe quem entrou. Ou o telefone dele no cadastro é diferente do que ele usa no WhatsApp. Ou não existe regra ativa de base Comunidade.
• Como orientar: confira os três pontos nesta ordem: plataforma e identificador da comunidade na campanha, regra ativa de base Comunidade no Sorteio e o telefone do cadastro. A comparação usa DDD e os oito últimos dígitos.
• Quando escalar: se os três estiverem corretos, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências e o telefone usado.

• Falha: o convite da comunidade não sai da tela do participante mesmo depois de ele entrar.
• Possivel causa: a campanha não tem a comunidade configurada. Sem ela não há como saber que ele entrou, e o convite segue aparecendo.
• Como orientar: configure a plataforma e o identificador da comunidade na campanha. Enquanto eles não existirem, o convite continua a aparecer para quem aceitou novidades.
• Quando escalar: se a comunidade estiver configurada e o convite não sumir depois da entrada, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o participante não vê o convite da comunidade.
• Possivel causa: ele não marcou que aceita receber novidades na inscrição, a campanha não tem o link de convite, ou ele já é membro.
• Como orientar: confira se ele aceitou contato na inscrição e se a campanha tem o link. O convite aparece só para quem aceitou e ainda não é membro.
• Quando escalar: não é falha. Só escalar se ele tiver aceitado, não for membro e o convite não aparecer.

• Falha: o participante saiu e voltou à comunidade esperando chance nova.
• Possivel causa: o bônus é um por participação. Sair e voltar não rende de novo.
• Como orientar: explique que a chance é única. E tranquilize: sair também não retira a chance que ele já recebeu.
• Quando escalar: não é falha.

• Falha: o participante entrou na comunidade antes de ter cadastro e depois se inscreveu sem receber a chance.
• Possivel causa: é um limite conhecido. Quem entra sem cadastro em nenhuma campanha do cliente não é registrado como membro, porque a associação é do participante.
• Como orientar: oriente a sair e entrar de novo na comunidade, agora com o cadastro feito — o aviso de entrada registra o membro e credita.
• Quando escalar: se ele sair e entrar de novo com o cadastro feito e a chance não sair, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o participante recebeu a chance por comunidade numa campanha nova sem ter entrado na comunidade de novo.
• Possivel causa: é o comportamento esperado. A comunidade é do cliente, não da campanha, e quem já é membro recebe a chance ao se inscrever numa campanha nova da mesma comunidade.
• Como orientar: explique que a associação à comunidade atravessa as campanhas daquele cliente.
• Quando escalar: não é falha.