Resumo das mudanças do Hotsite de agosto a outubro

Entre 14 de agosto e 30 de outubro de 2026 o Hotsite recebeu 64 alterações. A principal foi a migração do hotsite para a API nova em 7 de outubro: a partir dela existem dois hotsites em produção, o do legado (que continua atendendo as campanhas antigas) e o da API nova. Em cima da API nova vieram a área do participante completa (números por nota, saldo, pontos, troca de pontos por prêmio, posições premiadas e stories), o formulário montado pela configuração da campanha, o reaproveitamento do cadastro em campanhas novas, a integração com as comunidades de WhatsApp da Kaply (convite, chances extras e jogos), os convites por e-mail, a tradução do site para espanhol e inglês e a vitrine pública de campanhas (portal).

Esta nota resume o período porque a geração automática de uma nota por alteração ficou parada nessas semanas.

Migração para a API nova

• A versão principal do hotsite passou a ser a da API nova. O hotsite do legado foi separado e continua no ar para as campanhas que ainda rodam nele. As correções do legado passam a ser publicadas à parte (PR 32 e 34).
• O hotsite passou a ler a campanha pela API nova: nome, cores, logo, fundo, banners, layout, regulamento e política de privacidade (PR 36).
• Cadastro, login, cadastro de nota fiscal e área logada passaram a usar a API nova. O login aceita CPF ou e-mail e a sessão vale apenas na campanha onde o login foi feito. As mensagens de recusa da API são mostradas ao participante como vieram (PR 37).
• Na primeira versão da migração algumas telas ficaram com o aviso "em breve" enquanto a API ainda não tinha as informações (posições, pontos, saldo, stories e ganhadores). Todas foram religadas ao longo de outubro, conforme os itens abaixo (PR 37).
• As publicações do hotsite novo passaram a ser automáticas a cada alteração aprovada (PR 32).

Cadastro e login do participante

• O campo Sexo ganhou a opção "Outros" ao lado de Masculino e Feminino (PR 29).
• O formulário de cadastro e o "Editar cadastro" passaram a seguir o formulário configurado na campanha: campo que a campanha não pede não aparece e não é exigido. Antes o "Editar cadastro" exigia endereço sempre e travava o participante em campanhas sem endereço no cadastro (PR 58).
• O campo Sexo voltou às duas telas, mas só aparece quando a campanha o configura no formulário (PR 60).
• O "Editar cadastro" passou a mostrar e editar os campos personalizados da campanha numa etapa "Informações adicionais". Antes era impossível salvar o perfil em campanhas com campo personalizado obrigatório (PR 49).
• O formulário passou a avisar na própria tela as regras da campanha antes do envio: idade mínima, aceite obrigatório do regulamento, CNPJ e chave de acesso da nota. A regra continua sendo aplicada pela API; a tela só antecipa a mesma mensagem (PR 47).
• Participar de uma campanha nova com um cadastro que já existe: ao digitar um CPF já cadastrado o hotsite pede a senha e depois só o que falta para esta campanha mais os aceites. Pelo login aparece o botão "Participar desta campanha" (PR 70).
• O CPF passou a ser sempre o primeiro campo de "Dados pessoais", para quem já tem cadastro ser reconhecido antes de preencher o resto (PR 71).
• No login de quem tem cadastro mas não participa da campanha aparece só o botão "Participar desta campanha". Ao mudar o CPF ou a senha o botão "Entrar" volta (PR 87).
• Ao escolher o estado o cadastro avisa na hora quando o estado não bate com o CEP ou quando o estado não participa da campanha. Antes um CEP de fora deixava o seletor vazio e a pessoa podia escolher outro estado (PR 88).
• Nova tela "Mudei de estado" para o participante corrigir endereço e estado sem precisar entrar de novo. O acesso a ela sai do fluxo de participar com cadastro existente (PR 89).
• Aceites do cadastro: primeiro foi criada a caixa de aceite de contato por e-mail (PR 64). Depois as caixas de contato e de contato de parceiros passaram a vir desmarcadas por padrão, por exigência da LGPD, e o texto passou a citar e-mail e WhatsApp (PR 65).
• Em campanhas com aceite obrigatório dos termos o participante que ainda não aceitou tem a área logada bloqueada até aceitar (PR 73).
• Ao sair da campanha o aviso passou a dizer o que será inativado (notas, números, posições, pontos e pedido de troca pendente) e deixou de dizer que a participação foi "excluída", porque nada é apagado (PR 67).

Nota fiscal e leitura do cupom

• Notas preenchidas pelo leitor de QR Code do cupom passam a ser identificadas como leitura automática e as digitadas como manual, o que permite o relatório manual x automático no painel (PR 26).
• O resultado do cadastro de nota deixou de mostrar o rótulo de premiado (PR 28).
• O anexo da nota passou a ser conferido pelo conteúdo real do arquivo e não só pela extensão. Arquivo que não é JPG, PNG ou PDF de verdade é recusado com a mensagem "Arquivo inválido". O limite de 10 MB continua (PR 43).
• A prévia de PDF anexado passou a ser um ícone com o link "Abrir em nova guia", porque a prévia embutida estava sendo bloqueada pelo navegador. O envio do PDF nunca foi afetado (PR 57).
• Leitor de QR Code do cupom fiscal em versão BETA. Ele nasce desligado e é ligado por campanha (PR 59).
• No modo leitor de QR Code o endereço da consulta do cupom é gravado separado da foto. Ler o QR Code basta e a foto passa a ser opcional nesse modo (PR 72).
• Nota que não gerou número deixou de mostrar "Nota enviada para análise!". A tela agora diz se a nota foi para o saldo ou se não gerou nada desta vez (PR 62).

Área do participante

• Aba Saldo: cards por regra e modalidade e o extrato agrupado por nota, com quanto falta para a próxima chance. Aparece só em campanhas que acumulam saldo (PR 45).
• Aba Por nota: os números da sorte agrupados debaixo da nota que os gerou, como no legado. Um número pode aparecer em mais de uma nota quando foi gerado pelo saldo de várias compras (PR 50).
• Aba Posições: as posições premiadas que o participante ocupou, com data, situação, prêmio e o vídeo do resultado. Aparece só para quem tem posição (PR 51).
• Mídias em GIF das posições premiadas passaram a aparecer como imagem. Antes apareciam como um player vazio (PR 40).
• Os cards de vídeo deixaram de mostrar o rótulo de premiado (PR 27).
• As telas de Minha participação, Cadastrar compra, Stories e Trocar pontos ganharam abas no topo para navegar entre elas. Cada aba só aparece quando a campanha tem a modalidade correspondente (PR 53).
• Quando a API está sobrecarregada ou fora do ar a área logada mostra um aviso de erro em vez de "você ainda não cadastrou nenhuma nota" ou "0 números", e o participante não é mais deslogado por isso (PR 42).

Pontos e troca por prêmio

• Cartão e aba Meus pontos com o saldo e o extrato de pontos (pontos da nota, nota cancelada e ajustes). Aparece só em campanhas com pontos (PR 48).
• Nova tela Trocar pontos: vitrine de prêmios com custo e estoque, pedido com endereço de entrega, aviso de quantos pontos saem e ficam, e "Meus resgates" com a situação de cada pedido e a opção de cancelar enquanto está pendente (PR 52).
• O extrato de pontos passou a mostrar o texto dos créditos e estornos de boas-vindas do convite (PR 73).
• Em campanha só de pontos o regulamento de pontos passou a ser exibido quando não existe regulamento de sorteio nem de vale-brinde (PR 74).

Stories

• O compartilhamento de stories voltou pela API nova: escolha da arte, imagem personalizada com o QR do story, baixar imagem, compartilhar no Instagram e a lista "Meus stories" com a situação de cada um (PR 38).
• A imagem com o QR já é gerada ao abrir a tela quando a campanha tem uma arte só (PR 39).
• Em campanha sem regra de story o botão "Gerar minha imagem" fica desabilitado depois da primeira recusa (PR 62).

Ganhadores

• A página de ganhadores foi religada pela API nova. As abas Sorteio e Vale-brinde seguem as modalidades da campanha e só mostram ganhadores publicados no painel. A aba de vale-brinde ganhou a coluna Prêmio (PR 63).

Comunidade do WhatsApp e jogos (Kaply)

• Depois do cadastro quem aceitou contato vê o convite para entrar na comunidade da promoção no WhatsApp (PR 65).
• Quando a campanha dá chances pela entrada na comunidade o cadastro e o convite dizem quantas chances extras a pessoa ganha. O convite continua aparecendo até a pessoa entrar e depois mostra a confirmação. Os números ganhos pela comunidade aparecem com essa origem (PR 68).
• Nova página do link pessoal das ações de comunidade com os jogos: roleta, raspadinha, plinko, chute ao gol, campo minado e revelação direta. O resultado é decidido pela API e o jogo só revela (PR 76).
• Na tela de quem ganhou aparece a instrução de uso do prêmio escrita pelo cliente ao criar a ação, no lugar do "envie GANHEI" (PR 78).
• Prévia do jogo para a tela de criação da ação de comunidade dentro da Kaply (PR 80).

Convites por e-mail

• Novas páginas do convite e do descadastro. O convite cumprimenta a pessoa e leva ao cadastro. O descadastro para os e-mails de convite mas mantém os e-mails de serviço como apuração, prêmio e senha (PR 69).

Aparência e compartilhamento

• A faixa "Compartilhe:" passou a seguir a configuração da campanha botão a botão (WhatsApp, Facebook e o novo "Copiar link"). Com os três desligados a faixa some. O rodapé passou a mostrar os perfis da marca (Facebook, Instagram, YouTube e TikTok) (PR 30 e 54).
• A cor dos botões configurada no painel passou a ser aplicada, com texto branco ou preto escolhido pelo contraste (PR 44).
• O link da campanha compartilhado no WhatsApp e redes sociais passou a mostrar título e imagem da campanha. Sem banner nem logo, usa uma imagem padrão (PR 44 e 46).
• Página interna inexistente da campanha passou a responder como página não encontrada de verdade (PR 62).

Tradução do hotsite

• Seletor de idioma no cabeçalho com Português, Español e English. Para quem está logado a escolha fica salva no cadastro e para visitantes fica salva no navegador (PR 77).
• Todas as telas foram traduzidas: login, cadastro e senha, compras e nota fiscal, pontos, ganhadores, stories, posições e páginas da campanha. O texto em português não mudou (PR 79 e 81 e 82 e 83).
• Rótulos padrão dos campos são traduzidos. Rótulos personalizados pelo cliente e campos personalizados continuam como o cliente escreveu (PR 83).
• Corrigido o seletor de idioma que falhava quando o navegador tinha sessão aberta em outra campanha (PR 84).

Portal de campanhas

• Nova vitrine pública de campanhas (portal) com busca, filtros de marca e categoria, ordenação e página "Saiba mais". No hotsite do legado ela mostra as campanhas do legado e da API nova juntas. No hotsite novo mostra por enquanto só as da API nova (PR 85 e 86).

Desempenho e segurança

• Imagens e mídias da campanha passaram a ser guardadas em cache por mais tempo e o cache sobrevive às publicações, deixando o carregamento mais rápido (PR 35).
• As leituras públicas da campanha passaram a ser reaproveitadas por 60 segundos, reduzindo as chamadas à API (PR 42).
• O hotsite passou a informar à API o endereço do visitante. Antes todos os participantes contavam como um só e o site inteiro dividia o mesmo limite de cadastros, logins e notas por minuto (PR 55).
• Proteções de segurança no navegador e páginas da área logada fora dos buscadores (PR 44).

O impacto é alto porque o hotsite das campanhas novas foi trocado por inteiro. Para atendimento é importante saber em qual plataforma a campanha roda: as campanhas do legado continuam no hotsite antigo, com o comportamento anterior, e as campanhas da API nova usam o hotsite novo com tudo o que está nesta nota.

No hotsite novo o participante passa a ver muito mais informação sozinho (saldo, números por nota, pontos, posições, resgates e stories), o que deve reduzir dúvidas do tipo "minha nota gerou número?". As mensagens de recusa vêm direto da API, então o texto que o participante relata é o mesmo que o sistema aplicou.

O formulário de cadastro agora depende da configuração da campanha no painel. Campo que aparece ou não aparece no cadastro é configuração e não erro.

O site da promoção foi atualizado com uma área do participante mais completa: agora é possível acompanhar os números agrupados por nota, o saldo acumulado, os pontos e as trocas de pontos por prêmio, as posições premiadas e os stories. O cadastro segue exatamente os campos configurados para a campanha, quem já tem cadastro participa de uma nova promoção só com a senha, e o site está disponível em português, espanhol e inglês.

Para o participante: se ele já tem cadastro em outra promoção da mesma marca, basta informar o CPF e a senha e completar o que faltar. As caixas de contato por e-mail e WhatsApp vêm desmarcadas e só são ativadas se ele quiser.

• Existem dois hotsites em produção. Antes de investigar um relato confirme se a campanha é do legado ou da API nova.
• O leitor de QR Code do cupom é BETA e vem desligado. Só aparece em campanhas em que foi ligado.
• As abas Saldo, Meus pontos, Posições, Stories e Trocar pontos são condicionais. Se não aparecem, a campanha não tem a modalidade ou o participante ainda não tem dados nela.
• Participante com aceite obrigatório pendente fica com a área logada bloqueada até aceitar os termos. Isso é esperado.
• Sair da campanha inativa a participação mas não apaga os dados.
• Os nomes dos ganhadores aparecem abreviados por privacidade.
• No portal do hotsite novo ainda não aparecem as campanhas do legado.
• A tradução vale para a interface. Textos escritos pelo cliente (regulamento, rótulos personalizados e instruções de prêmio) continuam no idioma em que foram escritos.

• Página da campanha no hotsite novo mostrando "Algo deu errado" ou sem imagens.
• Área logada mostrando erro de leitura de forma persistente para vários participantes.
• Participante com cadastro existente que não consegue participar de uma campanha nova mesmo com a senha correta.
• Aba de ganhadores vazia em campanha com ganhadores já publicados no painel.
• Jogo da comunidade que não abre ou não mostra o resultado.
• Muitos participantes recebendo aviso de limite de tentativas ao cadastrar nota ou fazer login.

Repositório: Premify-Gelt/HotsitePremify-V2
PRs: 26 a 89
Total de PRs mesclados no período: 64 (de 14/08/2026 a 30/10/2026)
Último commit: b49b32c6e1c20be3c3956a23625e10b9c95a6664