Voltar para artigos
API PremifyIntermediarioAtualizado em 30 de out. de 2026

Ações de comunidade e a jogada pelo WhatsApp

Como o membro da comunidade pede um link pessoal pelo WhatsApp e joga uma vez por dia para ganhar um prêmio

#api-premify#regras-de-negocio#campanha

O que e?

É a gamificação que a Premify oferece dentro das comunidades de WhatsApp administradas por uma plataforma parceira de comunidade (a Kaply é a primeira). O cliente cria uma ação dentro da própria plataforma parceira, e o membro da comunidade participa sem cadastro no hotsite: ele manda uma mensagem pronta, recebe um link pessoal e toca em Jogar para descobrir se ganhou.

A identidade de quem participa é o telefone que o WhatsApp garantiu. Não há CPF, senha nem formulário. Não confunda com a chance por comunidade, que dá número da sorte a quem tem cadastro numa campanha e entra na comunidade.

Como funciona?

A criação da ação

O cliente cria a ação numa tela da Premify embarcada na plataforma parceira, sem acessar o painel. A plataforma prova à Premify quem é o cliente e quem é o operador, e o cliente só consegue criar ação se o vínculo dele com a plataforma estiver ativo e liberar campanhas e posições premiadas.

O cliente informa:

  • o nome e o período da ação, em dias;
  • o jogo e a aparência dele: roleta, plinko, campo minado ou revelação direta. O resultado já está decidido quando o jogo começa; o jogo só revela;
  • a mensagem para quem não ganhou, opcional;
  • o texto de como usar o prêmio, até 500 caracteres, por exemplo "apresente este código no caixa";
  • as posições premiadas: digitadas, enviadas por planilha (com o dia de cada uma) ou geradas automaticamente, sorteando a cada dia uma quantidade de posições diferentes dentro de uma faixa.

Antes de criar qualquer coisa, a Premify confere o plano inteiro: dia fora do período, dia que já passou, prêmio vazio, posição repetida no mesmo dia, mais de 20 mil posições ou período de mais de 366 dias. Erros de planilha voltam com o número da linha. Se houver erro, nada é criado — não fica ação pela metade.

A Premify monta a campanha completa com a modalidade Posição premiada e devolve o código da ação, criado a partir do nome (sem acento, em minúsculas, com hífens). Se o código já estiver em uso, o sistema acrescenta um número ou um sufixo. A tela também entrega a mensagem pronta para cada canal de WhatsApp do cliente, no formato "Quero participar" seguido do código.

A criação exige um responsável pela promoção cadastrado no cliente, porque é dado regulatório. Sem nenhum, a criação é recusada e o cliente é orientado a falar com o suporte, que cadastra o responsável pelo painel.

O pedido do link

  1. A comunidade publica a mensagem pronta com o número do canal do cliente.
  2. O membro envia "Quero participar" com o código da ação.
  3. A plataforma parceira confirma que ele é membro e repassa a mensagem à Premify.
  4. A Premify responde com o link pessoal, e a plataforma envia a resposta no privado.

As respostas possíveis:

  • não é membro: recebe o aviso de que a ação é só para quem está na comunidade, e nenhum link;
  • sem código e uma só ação no ar: recebe o link dessa ação;
  • sem código e várias ações no ar: recebe a lista das ações com o código de cada uma;
  • nenhuma ação no ar: recebe o aviso de que não há ação no momento;
  • já jogou hoje naquela ação: recebe "volte amanhã";
  • conversa normal, sem pedido de participação: não recebe resposta.

O membro só vê as ações do cliente dono daquela comunidade.

O link e a jogada

O link é pessoal, vale uma jogada por telefone, por ação, por dia e expira às 23:59 do dia, pelo horário de Brasília. Pedir de novo no mesmo dia devolve o mesmo link.

Abrir o link não consome a jogada. O próprio WhatsApp abre o link para montar a prévia, e isso não pode gastar a vez de ninguém. Quem consome é o toque em Jogar.

No toque em Jogar, o sistema conta a ordem daquela jogada no dia e verifica se ela cai numa posição premiada daquele dia. Jogadas simultâneas entram em fila, então não há duas jogadas com a mesma ordem. Quem ganha recebe o prêmio, um protocolo de seis caracteres e o texto de como usar o prêmio. Quem não ganha vê a mensagem da ação ou a padrão, "Não foi dessa vez! Amanhã tem mais.".

Tocar em Jogar de novo devolve o mesmo resultado. Link vencido, ação encerrada ou fora do ar, e código de outra ação não permitem jogar.

Encaminhar o link não adianta. Quem abre o link joga no lugar do dono do telefone, e esse telefone continua com uma jogada por dia. O que vale é a jogada daquele número.

A entrega do prêmio

A Premify não controla a retirada. O prêmio pode ser um item, um cupom ou um voucher, e a entrega é do cliente. O resultado com o protocolo é o comprovante da jogada, e o que o ganhador faz com ele é a instrução que o cliente escreveu na criação da ação.

O acompanhamento

Na tela embarcada, o cliente vê suas ações com a situação (no ar, agendada ou encerrada) e as jogadas do dia, e no detalhe de cada ação vê o código, o jogo, as posições, as jogadas e os ganhadores.

Uma campanha comum, de sorteio ou de posição premiada por nota, não recebe jogadas: só respondem à mensagem as campanhas criadas como ação de comunidade.

Como explicar ao cliente?

A ação de comunidade é uma promoção rápida dentro da comunidade de WhatsApp, sem cadastro: o membro manda uma mensagem, recebe um link e joga uma vez por dia. O cliente cria tudo dentro da plataforma da comunidade, define o jogo, os prêmios de cada dia e o texto que explica como usar o prêmio.

Três pontos para alinhar antes de lançar.

A entrega do prêmio é do cliente. A Premify mostra ao ganhador o prêmio, o protocolo e o texto de como usar. Retirar, validar o protocolo e entregar é com o cliente, e por isso esse texto precisa ser claro.

Só participa quem é membro da comunidade. A plataforma parceira confirma isso antes de a Premify responder.

Uma jogada por telefone por dia em cada ação. O link vale até as 23:59 de Brasília. Quem encaminha o link está entregando a própria jogada do dia.

Possiveis falhas, causas e solucoes

  • Falha: o membro mandou a mensagem e não recebeu link nenhum.
  • Possivel causa: a mensagem não foi reconhecida como pedido, a plataforma não o identificou como membro, não há ação no ar naquele dia, ou a plataforma não entregou a resposta.
  • Como orientar: oriente a enviar exatamente a mensagem pronta da ação, com o código, e confirme que ele está na comunidade e que a ação está dentro do período.
  • Quando escalar: se ele for membro, a ação estiver no ar e a mensagem correta continuar sem resposta, abrir issue no Jira (projeto DEV) com o telefone, o código da ação e o horário.
  • Falha: o membro recebeu a resposta de que a ação é só para quem está na comunidade.
  • Possivel causa: a plataforma parceira informou que aquele telefone não é membro da comunidade.
  • Como orientar: oriente a entrar na comunidade e mandar a mensagem de novo.
  • Quando escalar: se ele já estiver na comunidade, verificar com a plataforma parceira e, se ela confirmar a filiação, abrir issue no Jira (projeto DEV) com as evidências.
  • Falha: o membro diz que abriu o link e perdeu a jogada.
  • Possivel causa: abrir o link não consome a jogada. Ela só é consumida no toque em Jogar. Se ele ou alguém com o link tocou em Jogar, o resultado já está decidido e é o mesmo a cada nova abertura.
  • Como orientar: oriente a abrir o link de novo. Se já foi jogado, a tela mostra o resultado.
  • Quando escalar: se ele não tocou em Jogar e o link aparecer como jogado, abrir issue no Jira (projeto DEV) com o telefone, a ação e o horário.
  • Falha: o link aparece como vencido.
  • Possivel causa: o link vale só até as 23:59 do dia em que foi pedido, pelo horário de Brasília, ou a ação saiu do ar.
  • Como orientar: oriente a pedir um link novo no dia seguinte, se a ação ainda estiver no período.
  • Quando escalar: não é falha.
  • Falha: o ganhador não sabe como receber o prêmio.
  • Possivel causa: a entrega é do cliente, e a instrução é o texto de como usar o prêmio cadastrado na ação.
  • Como orientar: oriente o ganhador a seguir a instrução mostrada com o prêmio e a guardar o protocolo. Se a instrução estiver confusa, alinhe com o cliente.
  • Quando escalar: não é falha da Premify. Envolva o cliente.
  • Falha: o cliente não consegue criar a ação.
  • Possivel causa: falta responsável pela promoção cadastrado no cliente, o vínculo do cliente com a plataforma não libera campanhas e posições premiadas, ou o plano de posições tem erro (dia fora do período, dia passado, prêmio vazio, posição repetida, planilha com linha inválida).
  • Como orientar: leia a mensagem. Para responsável ausente ou vínculo sem permissão, o ajuste é feito pela equipe Premify. Para erro de planilha, corrija as linhas indicadas e envie de novo.
  • Quando escalar: se a mensagem pedir contato com o suporte, abrir issue no Jira (projeto DEV) com o cliente, a plataforma e o print.

Exemplo de resposta pronta

Olá! Para participar, envie no WhatsApp a mensagem "Quero participar" com o código da ação. Você precisa estar na comunidade para receber o link. O link é pessoal, vale para uma jogada por dia e funciona até as 23:59 de hoje. Abrir o link não gasta a sua jogada: ela só é usada quando você toca em Jogar. Se ganhar, guarde o protocolo que aparece na tela e siga as instruções de como usar o prêmio, que são da marca responsável pela ação.

Quando escalar?

Abra issue no Jira (projeto DEV) com as evidências quando um membro com a ação no ar não receber resposta à mensagem correta, quando um link aparecer como jogado sem o dono ter tocado em Jogar, ou quando a criação da ação for recusada pedindo contato com o suporte. Acione o time de desenvolvimento urgentemente se o mesmo telefone conseguir jogar mais de uma vez no mesmo dia na mesma ação, se duas jogadas ganharem a mesma posição, ou se o link de uma ação permitir jogar em outra. Anexe o nome e o código da ação, o telefone, o horário e prints da tela.

Artigos relacionados

API PremifyIntermediario
Chance por cadastro e chance por comunidade

As duas chances que não dependem de nota e por que elas rendem uma única vez

#api-premify#regras-de-negocio#campanha
Atualizado em 30 de out. de 2026
API PremifyIntermediario
Posição premiada e o pool de prêmios

Como a API distribui as posições premiadas e por que vale-brinde é o nome comercial dessa modalidade

#api-premify#regras-de-negocio#campanha
Atualizado em 30 de out. de 2026