Guia do Hotsite V2 para Atendimento

O Hotsite V2 é o site público onde o participante usa as campanhas promocionais da Premify. Cada campanha tem o seu endereço, no formato site.premify.com.br/campanha/nome-da-campanha. É ali que a pessoa se cadastra, entra na conta, cadastra as compras, acompanha números, saldo, pontos e posições e consulta os ganhadores.

O hotsite lê tudo da API Premify V2 (a API nova). As regras da promoção, a configuração da campanha e os dados do participante ficam na API e no painel administrativo. O hotsite só mostra e envia.

Além das páginas de cada campanha existe o Portal Premify (site.premify.com.br/portal), uma vitrine pública com as promoções que estão no ar.

A jornada padrão do participante:

1. Abre o link da campanha e vê os banners, o regulamento e os ganhadores.
2. Faz o cadastro ou entra com CPF e senha. Quem já tem cadastro em outra campanha do mesmo cliente usa a mesma senha e preenche só o que faltar.
3. Cadastra a compra (nota fiscal) na tela "Cadastrar Compra". Em algumas campanhas dá para ler o QR Code do cupom.
4. Acompanha tudo em "Minha participação": números da sorte, notas, saldo, pontos e posições, conforme o que a campanha oferece.
5. Consulta a lista pública de ganhadores.

O site funciona em três idiomas (português, espanhol e inglês), escolhidos no seletor do topo da página. O conteúdo escrito pelo cliente, como regulamento e nome dos prêmios, não é traduzido.

Os assuntos estão divididos assim nesta base:

• Visão geral e limites do hotsite: artigo "Visão geral do Hotsite V2".
• Telas e menu: "Telas e fluxos do participante".
• Cadastro, login, senha, "Mudei de estado" e saída da campanha: "Cadastro e acesso do participante".
• Compras e notas: os três artigos de notas fiscais.
• Números, saldo, pontos, posições e ganhadores: "Minha participação e ganhadores".
• Portal de promoções: "Portal de campanhas".

O hotsite é a porta de entrada do participante e reflete o que foi configurado no painel. Cor, banner, regulamento, botões de compartilhar, campos do formulário e regras da promoção são definidos no painel e aparecem no site em até cerca de um minuto. O hotsite não decide quem ganha, não valida a nota por conta própria e não guarda os dados principais: isso é papel da API.

• Falha: o link da campanha abre a página "Página não encontrada".
• Possivel causa: o endereço está errado ou a campanha está inativa. A API responde que a campanha não existe e o site mostra 404.
• Como orientar: confira o endereço exato (o trecho depois de /campanha/) e se a campanha está ativa e dentro do período no painel.
• Quando escalar: se o endereço estiver certo e a campanha ativa e o erro continuar, abrir issue no Jira (projeto DEV) com o link e o horário.

• Falha: a tela mostra "Muitos acessos agora" ou "Muitos acessos ao mesmo tempo. Tente novamente em alguns segundos".
• Possivel causa: limite de acessos por minuto da API foi atingido para aquele visitante.
• Como orientar: peça para aguardar o tempo indicado e tentar de novo. Não é bloqueio da conta.
• Quando escalar: se acontecer com muitos participantes ao mesmo tempo, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV).

• Falha: a tela mostra "Não foi possível carregar seus dados agora" com um "Código para o suporte".
• Possivel causa: erro do servidor ao ler os dados do participante.
• Como orientar: peça para tentar de novo em instantes e anote o código exibido.
• Quando escalar: se persistir, abrir issue no Jira (projeto DEV) com o código para o suporte, o link da campanha, o CPF e o horário.

• Falha: "Sua sessão expirou. Entre novamente para ver seus dados."
• Possivel causa: o acesso venceu ou a pessoa entrou em outra campanha.
• Como orientar: oriente a entrar de novo pelo login da campanha. O login vale só para a campanha em que foi feito.
• Quando escalar: se a sessão cair logo após cada login, abrir issue no Jira (projeto DEV).