Resumo das mudanças da API Premify de agosto a outubro

Entre 14 de agosto e 30 de outubro de 2026 a API Premify recebeu 272 alterações. A automação que publicava uma nota por alteração ficou parada nesse período, por isso este resumo reúne tudo por tema.

Na prática, a API nova passou a fazer sozinha tudo o que uma campanha precisa: cadastro de participante e de nota fiscal com validações antifraude, geração de números da sorte e de posições premiadas, apuração, registro e publicação de ganhadores, saldo acumulado, pontos de fidelidade com troca por prêmios, stories do Instagram, convites para campanhas novas, comunidades do WhatsApp, dashboard, relatórios, permissões por papel e tradução para espanhol e inglês. Também houve muitas correções de estabilidade e desempenho depois dos primeiros testes de carga e do uso em produção.

Cadastro de nota fiscal e regras antifraude

• O cadastro de nota pela API ficou completo, com os mesmos campos do sistema antigo (valor total e valor dos produtos, rede, loja, itens e origem obrigatória) e uma sequência organizada de validações (PR 49 e 50).
• A nota passou a ser recusada quando a participação está cancelada, quando o documento do participante está na lista de bloqueio, quando a data da compra é futura ou fora do período da campanha, quando a chave de acesso tem dígito inválido, quando o CNPJ é inválido, quando a loja não existe ou está inativa, ou quando o produto é repetido ou inativo (PR 171).
• Nota de loja marcada como Bloqueada na campanha passou a ser recusada em todos os canais: hotsite, WhatsApp e integrações (PR 207).
• Com a validação de chave e número ligada, a nota sem chave é conferida por CNPJ e número ignorando a série, e a repetida recebe a mensagem "Esta nota já foi cadastrada." (PR 228).
• Os limites configurados no painel passaram a valer: máximo de notas por dia e máximo de notas na campanha por participante, e a regra de que o estado da nota deve ser o estado de residência. A nota que passa do limite é recusada (PR 176).
• Envios simultâneos do mesmo participante não conseguem mais furar o limite de notas (PR 314).
• A API passou a aplicar os campos obrigatórios do formulário da campanha. Campanha com o campo "Anexe a nota fiscal" obrigatório recusa nota sem foto (PR 195).
• Quando a campanha gera chances por valor, o campo de valor passa a aparecer como obrigatório no hotsite em vez de só dar erro no envio (PR 255).
• A leitura do QR Code do cupom fiscal (BETA) ganhou uma chave por campanha. O link de consulta da NFC-e passou a ser guardado separado da foto, e ler o QR Code já cumpre a exigência de anexo (PR 248 e 279 e 281).
• Foi testada uma análise prévia de toda nota antes de gerar chances, mas a decisão final foi não ter análise de rotina: toda nota gera as chances na entrada e é conferida quando a pessoa ganha (PR 256 e 258 e 259).
• O operador pode cancelar uma nota fraudada pelo painel. O cancelamento invalida os números e posições que ela gerou e estorna o saldo (PR 212).
• Nota e story passaram a ser recusados quando o participante ainda não deu o aceite obrigatório da campanha (PR 287).

Geração de números da sorte e posições premiadas

• O motor de geração passou a calcular a quantidade de números por modalidade (exemplo: nota de R$ 230 numa regra de R$ 50 gera 4 números) e o formato da série foi ajustado para no máximo 5 dígitos por parte (PR 58 e 59 e 61 e 67).
• Campanhas com Posição Premiada passaram de fato a distribuir posições. Antes aceitavam a nota e não geravam nada, sem aviso (PR 100).
• O dia da posição premiada passou a ser o dia de Brasília. Antes notas cadastradas entre 21h e meia-noite caíam na fila do dia seguinte (PR 107).
• Corrigido erro que impedia o cadastro de nota em campanha com posição premiada e corrigida a disputa entre notas simultâneas que gerava a mensagem de concorrência excessiva (PR 114 e 133).
• Passaram a valer o teto de chances por participante e por nota (PR 175).
• A chance extra de produto e de loja vinculados à campanha passou a ser calculada. A chance extra da loja saiu do cadastro geral da loja e foi para o vínculo com cada campanha (PR 108 e 227).
• Nova base de geração por cadastro: a campanha pode dar chances só pela inscrição (PR 231).
• Nova regra de chance em dobro de segunda a quinta: conta o dia em que a nota foi cadastrada no horário de Brasília e dobra apenas números da sorte (posição premiada não dobra) (PR 319).

Regras de geração e modalidades

• A série do número da sorte saiu da regra de geração e passou a ficar na modalidade Sorteio da campanha, evitando formato de número diferente na mesma campanha (PR 286).
• A API passou a recusar configurações que deixariam a campanha sem gerar número e a troca do escopo por rede quando isso deixaria posições presas no pool (PR 138 e 140).
• Só pode existir uma regra com saldo por modalidade (PR 177).
• Alterar a regra de geração ou trocar a regra de uma modalidade em campanha em andamento passou a exigir o perfil Master e confirmação explícita. Toda alteração fica registrada com quem fez quando fez e o antes e depois (PR 180 e 190 e 196 e 198).
• Não é mais possível remover uma modalidade que já tem prêmio, posição ou ganhador, nem remover o Sorteio de campanha que já gerou números (PR 128 e 292).
• O campo de valor mínimo do acelerador e depois os produtos aceleradores saíram da regra de geração (PR 106 e 291).
• A campanha pode valer só em estados específicos. O cadastro passou a recusar CEP e estado que não batem, e o participante ganhou a opção de mudar de endereço fora da campanha (PR 208 e 316 e 318).

Posições premiadas, prêmios e apuração

• Posições premiadas ganharam cadastro completo, paginação, filtros, separação entre posição premiável e já distribuída, validação da data do prêmio dentro do período e proteção contra posições duplicadas (PR 47 e 52 e 55 e 109 e 129).
• O prêmio da posição passou a vir apenas do catálogo de prêmios, e cada prêmio indica sua modalidade (sorteio ou posição premiada) (PR 112 e 125).
• A apuração passou a ser feita por posição e não por nota, já que uma nota pode gerar várias posições. Saiu também a exportação da apuração em CSV (PR 68 e 82).
• Os e-mails de aprovação e reprovação ganharam variáveis (como prêmio e valor), imagens, pré-visualização e um modo guiado com modelo único (PR 115 e 117).
• Reprovação que devolveu o prêmio ao pool passou a ser definitiva, evitando dois contemplados na mesma posição (PR 127).
• Passaram a valer os limites de prêmios por participante e por nota (PR 173).

Ganhadores

• Ganhadores passaram a ser registrados de verdade. Sorteio é registrado pelo número que saiu e posição premiada a partir da posição aprovada. O ganhador nasce como rascunho e só aparece no hotsite quando é publicado, e um ganhador já publicado não pode ser apagado (PR 90).
• A conferência do ganhador do sorteio mostra as notas que formaram o número premiado (PR 263).
• Novo sorteio pela Loteria Federal: o sistema busca o resultado na Caixa (ou o operador digita os bilhetes) e mostra os números da campanha do mais próximo para o mais distante, sem gravar nada até o operador confirmar (PR 317).
• Nova consulta pública de ganhadores publicados por modalidade para o hotsite (PR 257).

Saldo acumulado

• O valor que sobra de uma nota que não completou uma chance passou a ficar guardado como saldo, com extrato explicando cada movimento e a chance ligada a todas as notas que a formaram (PR 184).
• O painel ganhou a aba de saldo e extrato com ajuste manual, e o participante passou a ver no site seu saldo e quanto falta para a próxima chance (PR 192 e 236 e 241).

Pontos de fidelidade e troca por prêmios

• A modalidade Pontos passou a funcionar, com extrato, saldo e ajuste manual pelo painel (PR 235 e 238).
• Troca de pontos por prêmios: o prêmio tem custo em pontos e estoque, o participante faz o pedido no site e o operador aprova, reprova com motivo ou marca como entregue. O participante pode cancelar enquanto o pedido está pendente (PR 239).
• O extrato do painel mostra o convite ou o prêmio de origem de cada movimento, e a campanha ganhou o campo de regulamento de pontos (PR 288 e 290 e 293).

Stories do Instagram

• O participante gera a arte personalizada do story com um QR Code próprio (PR 218).
• O painel ganhou moderação dos stories (listar, aprovar e reprovar com motivo) e o story aprovado pode render números ou posição premiada, conforme a regra (PR 219 e 220 e 222).
• A menção da marca no Instagram aprova o story automaticamente pelo QR, e o story apagado antes de 24 horas perde as chances (PR 224 e 226 e 308).

Cadastro, senha e participação

• O operador pode editar o cadastro do participante pelo painel. Documento, razão social, aceites, saldo e origem não podem ser alterados (PR 110).
• Na segunda inscrição em outra campanha a senha passou a ser conferida, e a idade mínima passou a ser validada pela API (PR 174).
• O "esqueci a senha" do participante passou a usar link de uso único, e a senha nova exige no mínimo 6 caracteres (PR 233 e 243).
• Quem já tem cadastro pode participar de uma campanha nova preenchendo só o que falta (PR 277).
• O campo Sexo virou campo padrão do formulário, e o perfil do participante passou a trazer os campos personalizados da campanha (PR 240 e 249).
• O participante pode dar depois do cadastro um aceite que a campanha passou a exigir, com a data registrada como prova (PR 284).
• Sair da campanha passou a invalidar tudo o que a participação gerou, com uma prévia do que será perdido antes de confirmar (PR 268 e 269).
• Participantes migrados do sistema antigo podem entrar com a senha antiga uma vez, e ela é convertida para o formato novo no primeiro acesso (PR 315).

Base para o hotsite novo

• A campanha passou a ser identificada só pela rota nas áreas públicas, e campanhas criadas pelo painel passaram a existir para o hotsite. A rota é única entre todos os clientes (PR 71 e 209).
• Campanha desativada não responde no hotsite, e o login só funciona para quem tem participação ativa naquela campanha (PR 210).
• Botões de compartilhar configuráveis (incluindo TikTok e WhatsApp), consulta pública das posições do participante com vídeo e vídeo desktop obrigatório no cadastro de vídeos (PR 57 e 242 e 244).

Convites e Base de participantes

• Nova Base de participantes com segmentos, lista e perfil somando todas as campanhas do cliente, mais o Resultado da campanha comparando com a anterior e separando quem é novo de quem voltou (PR 250 e 252 e 254).
• Convites por e-mail para chamar segmentos da Base para uma campanha nova, com prévia, envio agendado, parada por falha, reenvio, descadastro, acompanhamento e benefício opcional para quem se inscreve pelo convite (PR 264 e 267 e 270 e 271 e 273 e 278).
• Ajustes de entrega de e-mail depois de um convite cair no spam: versão em texto, link de descadastro no cabeçalho e nome do remetente. Contas de e-mail na porta 465 passaram a funcionar (PR 280 e 282).

Comunidades do WhatsApp e ações de comunidade

• Integração com a Kaply: o participante que aceitou receber novidades vê o convite para entrar na comunidade do WhatsApp e ganha chances extras ao entrar (PR 262 e 266 e 274).
• O aviso de entrada e saída da comunidade virou um contrato genérico, pronto para outras plataformas parceiras além da Kaply (PR 285).
• Ações de comunidade: o membro manda "Quero participar" no WhatsApp, recebe um link pessoal e joga para descobrir se ganhou. O cliente cria a ação de forma expressa por uma tela embarcada na plataforma parceira e define o texto de "como usar o prêmio" (PR 289 e 295 e 296 e 300 e 309).
• Os clientes da plataforma parceira ficam num ambiente compartilhado, e a lista de campanhas do painel ganhou filtro por cliente (PR 302 e 304).

Dashboard e relatórios

• O dashboard do painel ganhou totais da campanha, blocos que só aparecem quando a campanha usa aquele recurso, conversão, recorrência, funil, mapa de calor por dia e hora, projeção até o fim, alertas e comparação com o período anterior (PR 181 e 183 e 188 e 189).
• Filtros do dashboard por período, rede, loja, estado, canal e produto, com várias opções ao mesmo tempo, além da lista de produtos mais comprados e do mapa geográfico por cidade (PR 185 e 191 e 194 e 247).
• Cada usuário pode guardar o arranjo do seu próprio dashboard (PR 186).
• A cidade passou a ser ligada à lista oficial de municípios do IBGE na nota, no participante e na loja (PR 197).
• Nova aba de Relatórios com relatórios prontos de participantes, posições premiadas, notas fiscais, números da sorte e apuração com prévia, e a opção de guardar um recorte em Meus relatórios (PR 216 e 221 e 225).
• Relatório de apuração no layout exigido pela Secretaria de Prêmios e Apostas, com conferência antes do download e arquivo compactado quando passa de 250 MB (PR 211).
• Novas consultas de participantes (com mais dados e filtros) e de números da sorte por campanha, inclusive para descobrir o dono de um número (PR 73 e 94).

Importações e exportações

• Importações por CSV de posições, lista de bloqueio, lojas, produtos e redes, com histórico e opção de desfazer a importação inteira. O arquivo pode usar ponto e vírgula ou vírgula como separador (PR 116 e 119 e 121 e 122 e 126 e 131 e 166).
• Vínculo e desvínculo em lote de produtos e lojas à campanha (PR 165).
• Produto passou a ser identificado por EAN ou código e aceita nome de até 500 caracteres. Loja passou a ser sempre pessoa jurídica com CNPJ obrigatório na criação (PR 131 e 164 e 223).
• Exportações em CSV de participantes e apuração, com datas no horário de Brasília, filtros de período pelo dia de Brasília, situação e origem com o mesmo texto da tela e proteção contra fórmulas maliciosas em planilhas (PR 75 e 118 e 120 e 124 e 134).

Usuários do painel, permissões e segurança

• As permissões de cada papel passaram a ser exigidas em todas as ações do painel. Quem não tem a permissão recebe acesso negado (PR 144 e 145 e 159).
• Papéis sem a permissão "vê dados sensíveis" passaram a ver CPF, e-mail, telefone e endereço mascarados, inclusive no CSV (PR 148).
• Proteção contra um usuário conceder mais poder do que tem, com Master como papel de sistema (PR 66 e 150).
• "Esqueci minha senha" do painel por código de 6 dígitos enviado por e-mail, senha mínima de 6 caracteres e troca de senha obrigatória no primeiro acesso (PR 146 e 154 e 156).
• Tela Meu perfil para o usuário editar o próprio nome e trocar a própria senha (PR 158).
• A sessão do painel passou a ser renovada enquanto a pessoa usa, e o deploy do painel deixou de deslogar todo mundo (PR 172 e 214).
• Cadastro de cliente novo pela equipe interna, com conta de suporte protegida, e acesso do suporte ao painel de cada cliente com registro de auditoria (PR 97 e 103 e 155).
• Validações extras de links, tamanhos de campo e arquivos enviados, e os logs de e-mail deixaram de registrar destinatário completo, assunto e corpo (PR 96 e 230).

Integrações e inteligência artificial

• Webhook e Flow do WhatsApp portados para a API nova (PR 54 e 56).
• Integração para parceiros com credenciais próprias por cliente, que a equipe interna cria e revoga (PR 60 e 65 e 74).
• Consulta livre dos dados da campanha por um catálogo fechado de métricas e o MCP da Premify, que permite ao usuário do painel conectar o Claude ou o ChatGPT para perguntar sobre as campanhas (PR 199 e 200 e 201 e 205).

Idiomas

• O participante e o usuário passaram a ter um idioma salvo, e e-mails e mensagens do sistema saem nesse idioma (PR 297 e 299).
• Mensagens de erro, recusas e textos de tela da API passaram a sair em português, espanhol ou inglês conforme o idioma escolhido no site ou no painel. Sem escolha o texto continua em português (PR 298 e 301 e 303 e 305 e 306 e 307 e 310 e 311).

Portal de campanhas

• Novo portal público com a vitrine de todas as campanhas ativas e no período de todos os clientes. A campanha pode pedir para ficar oculta e personalizar título, descrição, banner, marcas e categorias do cartão (PR 312 e 313).

Mensagens de erro, estabilidade e desempenho

• Registro duplicado passou a responder com mensagem específica de "já existe", erros de formulário passaram a indicar o campo inválido, e o erro interno devolve um código de rastreio que o suporte pode passar ao time técnico (PR 178 e 179 e 187 e 193).
• Corrigido um erro grave de agosto em que notas e números gerados eram desfeitos sem aviso logo após o cadastro (PR 62).
• O limite de requisições passou a valer por visitante. Antes o site inteiro dividia o mesmo limite de cadastros, logins e notas por minuto (PR 245).
• Conexões com o banco passaram a ser compartilhadas entre clientes com cota por cliente, evitando que o pico de um cliente derrube os outros. Também foram corrigidos erros 502 sob carga (PR 167 e 168).
• Respostas compactadas, imagens com cache longo e deploy rodando as atualizações de banco antes de subir a versão nova, reduzindo o tempo fora do ar (PR 160 e 161 e 215).
• HTTPS na API e no painel e monitoramento com alertas por e-mail para queda da API, erros e uso alto do servidor (PR 85 e 88 e 147 e 151 e 152 e 253).

• A API nova agora cobre o fluxo inteiro de uma campanha. Muitas regras que antes ficavam só gravadas no painel passaram a valer de verdade: limites de notas, teto de chances, limite de prêmios, chance extra, chance por cadastro, estados participantes e aceite obrigatório. Campanhas que tinham esses campos preenchidos sem efeito passam a se comportar de forma diferente.
• O cadastro de nota ficou bem mais rígido. Espere mais recusas com mensagem clara (nota repetida, data fora do período, loja bloqueada, limite atingido, CEP e estado diferentes, aceite pendente) e menos casos de nota aceita que não gerou nada.
• Usuários do painel podem receber acesso negado em telas que antes abriam, porque as permissões do papel agora são exigidas. Dados pessoais aparecem mascarados para quem não tem "vê dados sensíveis".
• Ajustes sensíveis em campanhas em andamento (regra de geração e regras das modalidades) só podem ser feitos pelo Master e ficam registrados no histórico.
• Há recursos novos para apresentar: dashboard com filtros, relatórios prontos, Base de participantes, convites, pontos com troca por prêmios, stories, comunidades do WhatsApp, sorteio pela Loteria Federal, MCP para IA, idiomas e portal de campanhas.

A plataforma Premify ganhou uma nova versão do sistema que roda as campanhas. Ela traz mais segurança contra fraude no cadastro de notas, regras de participação que agora são aplicadas automaticamente conforme a configuração da campanha e muitos recursos novos: dashboard com filtros e comparações, relatórios prontos (inclusive no padrão da Secretaria de Prêmios e Apostas), programa de pontos com troca por prêmios, stories do Instagram, convites para a base de participantes, comunidades do WhatsApp e atendimento em português, espanhol e inglês.

Se o cliente perceber que alguma nota passou a ser recusada, explique que o sistema agora aplica as regras configuradas na campanha (limites, período, lojas bloqueadas e estados participantes) e que a mensagem exibida ao participante indica o motivo.

• Campanhas com o campo "Anexe a nota fiscal" obrigatório no formulário recusam nota sem foto. A leitura do QR Code da NFC-e também cumpre essa exigência.
• Os limites "Chances por CPF" e "Chances total de notas" contam notas e não números da sorte.
• Chance em dobro de segunda a quinta considera o dia em que a nota foi cadastrada e não o dia da compra.
• Não existe análise de rotina da nota. A conferência acontece na apuração da posição premiada, no registro do ganhador do sorteio ou pelo cancelamento da nota.
• Ganhador registrado não aparece no hotsite até ser publicado. Depois de publicado ele não pode ser apagado.
• O sorteio pela Loteria Federal não grava o ganhador sozinho. O operador ainda precisa confirmar o registro.
• Participantes migrados do sistema antigo dependem de um passo da equipe técnica para conseguir entrar com a senha antiga.
• Mensagens traduzidas dependem do idioma escolhido no site ou no painel. Sem escolha tudo continua em português.

• Nota aceita que não gerou números nem posições, ou número com formato diferente do esperado na mesma campanha.
• Usuário com o papel correto recebendo acesso negado em uma tela.
• Participante migrado do sistema antigo que não consegue entrar mesmo com a senha antiga.
• Convites ou e-mails do sistema que não chegam ou caem em spam com frequência.
• Saldo, pontos ou estoque de prêmio que não batem com o extrato.
• Qualquer erro interno: peça ao cliente o código de rastreio que aparece junto da mensagem e envie ao time de desenvolvimento.

Repositório: Premify-Gelt/Premify-V2-API
PRs: 46 a 319
Total de PRs mesclados no período (14/08/2026 a 30/10/2026): 272
Último commit: 87fedb2bfa298dd323ab8c002034ead832226d19