# Mais Saúde — Roteiro de uso (cliente)

**Sistema:** Campanhas promocionais, gamificação, cupons e WhatsApp  
**Endereço:** https://ms.restor.app.br  
**Portal do cliente:** https://ms.restor.app.br/cliente/mais-saude  

Este documento serve para **treinar a equipe** e **testar o sistema do início ao fim**.  
Siga na ordem. Marque cada passo com ✅ quando concluir.

---

## 1. Acesso ao painel

| Item | Valor |
|------|--------|
| URL | https://ms.restor.app.br/login |
| Usuário | `admin` |
| Senha | `MaisSaude@2026` |

1. Abra a URL de login.
2. Entre com o usuário acima.
3. Você deve ver o **Dashboard**.

> Troque a senha depois do primeiro acesso (menu do usuário → Perfil), principalmente em produção.

**Perfis do sistema**

| Perfil | O que faz |
|--------|-----------|
| Administrador | Tudo (incluindo WhatsApp e auditoria) |
| Operador | Campanhas, clientes, participações, cupons |
| Caixa | Validar e utilizar cupons |

---

## 2. Menu do painel (visão rápida)

O menu lateral fica agrupado. Clique no grupo para abrir:

| Grupo | Telas |
|-------|--------|
| **Visão geral** | Dashboard, Auditoria, Portal do cliente (abre em nova aba) |
| **Operação** | Participações, Cupons, Caixa |
| **Cadastros** | Clientes, Campanhas promo, Prêmios, Produtos, Categorias |
| **WhatsApp** | Dashboard, Conexão, Disparos, Fila, Histórico, Autorizados, Opt-outs, Configurações |

---

## 3. Preparar o cadastro básico

Antes de uma campanha, deixe o “estoque” de prêmios e (opcional) produtos prontos.

### 3.1 Categorias (opcional)

1. Menu **Cadastros → Categorias**
2. Crie exemplos: `Higiene`, `Infantil`, `Medicamentos`

### 3.2 Produtos (opcional)

1. Menu **Cadastros → Produtos**
2. Cadastre 1–2 produtos e vincule a uma categoria

### 3.3 Prêmios (obrigatório)

1. Menu **Cadastros → Prêmios**
2. Clique em **Novo prêmio**
3. Cadastre pelo menos 2 prêmios, por exemplo:

| Nome | Tipo sugerido | Observação |
|------|---------------|------------|
| 10% OFF higiene | Percentual | Validade 15 dias |
| Brinde sabonete | Brinde / presente | Validade 7 dias |
| Sem prêmio / tente de novo | Personalizado | Para completar 100% das chances |

4. Salve e confirme que os prêmios aparecem na lista.

✅ Checkpoint: existem prêmios ativos listados.

---

## 4. Criar a campanha promocional

1. Menu **Cadastros → Campanhas promo**
2. Clique em **Nova campanha**
3. Preencha:

| Campo | Exemplo de teste |
|-------|------------------|
| Nome | Semana da Higiene |
| Status | Ativa |
| Mecânica | Raspadinha **ou** Roleta **ou** Prêmio direto |
| Valor mínimo | 50,00 |
| Chances por compra | 1 |
| Datas | Hoje até daqui 30 dias |
| Limite por cliente | 5 (ou deixe em branco se permitido) |

4. Na seção de **prêmios da campanha**, vincule os prêmios e defina as **probabilidades**.
5. A soma das probabilities **deve ser 100%** (ex.: 30 + 50 + 20).
6. Salve.

### 4.1 Link / QR da campanha (recomendado)

Na ficha da campanha:

1. Crie um link (ex.: `balcao`, `instagram`).
2. Copie a URL gerada (formato `/c/CODIGO`).
3. Use esse link em cartaz, QR Code ou WhatsApp.

✅ Checkpoint: campanha **ativa** com prêmios somando 100%.

---

## 5. Conectar o WhatsApp (admin)

1. Menu **WhatsApp → Conexão**
2. Confira o status:

| Status | Significado |
|--------|-------------|
| Conectado | Pronto para enviar |
| Conectando / QR | Escaneie o QR no celular da farmácia |
| Desconectado | Gere QR e conecte de novo |

3. Se aparecer QR Code:
   - Abra o WhatsApp no celular da farmácia
   - **Aparelhos conectados → Conectar um aparelho**
   - Escaneie o QR
4. Clique em **Sincronizar** até ficar **Conectado**.

> Use um número exclusivo da farmácia nesta instância (`maissaude`). Não misture com o WhatsApp do Conecta.

### 5.1 Configurações WhatsApp

1. Menu **WhatsApp → Configurações**
2. Confirme (padrão recomendado):

| Item | Sugestão |
|------|----------|
| Máx. marketing / dia | 1 |
| Máx. / semana | 3 |
| Máx. / mês | 8 |
| Intervalo entre envios | 3 segundos |
| Avisos transacionais | Todos ligados (nota, jogo, cupom, uso) |

✅ Checkpoint: WhatsApp **conectado**.

---

## 6. Cadastrar o cliente de teste

Há dois caminhos. Faça **os dois** na primeira validação.

### 6.A Pelo painel (admin)

1. Menu **Cadastros → Clientes → Novo**
2. Preencha:

| Campo | Exemplo |
|-------|---------|
| Nome | Cliente Teste |
| CPF | Use um CPF válido de teste |
| WhatsApp | Seu número (ex.: 91999619669) |
| Ativo | Sim |
| Autorizar marketing WhatsApp | Marque se quiser já com opt-in |

3. Salve.

Se o WhatsApp estiver conectado e o cliente **não** tiver opt-in, o sistema tende a enviar mensagem de boas-vindas pedindo:

- **1** = Sim, quero promoções  
- **2** = Não  

Responda no celular e confira em **WhatsApp → Histórico** e **Autorizados / Opt-outs**.

### 6.B Pelo portal do cliente

1. Abra: https://ms.restor.app.br/cliente/mais-saude  
2. Informe o CPF (se já existir, entra na área).
3. Se for novo: vá em cadastro, preencha nome + WhatsApp.
4. Escolha se autoriza promoções.
5. Entre na **Minha área**.

✅ Checkpoint: cliente aparece em **Cadastros → Clientes** e (se opt-in) em **WhatsApp → Autorizados**.

---

## 7. Fluxo A — Participação pelo balcão (admin)

Use quando o cliente compra na loja e o operador libera a chance.

1. Menu **Operação → Participações → Nova**
2. Selecione:
   - Campanha ativa
   - Cliente de teste
   - Valor da compra (≥ valor mínimo da campanha)
   - (Opcional) chave/nota fiscal
3. Confirme.

**O que deve acontecer**

| Mecânica da campanha | Resultado |
|----------------------|-----------|
| Prêmio direto | Cupom já gerado; cliente pode receber WhatsApp com o código |
| Raspadinha / Roleta | Sistema gera link de jogo; cliente recebe WhatsApp com o link (se aviso ligado) |

4. Abra a participação criada e copie o **link de jogar** (se houver).
5. Abra o link no celular.

✅ Checkpoint: participação listada + cupom ou link de jogo gerado.

---

## 8. Fluxo B — Portal: nota → saldo → liberar campanha

Use quando o cliente acumula notas no celular.

1. No portal (Minha área), cadastre uma **nota fiscal**:
   - Cole a chave / QR / texto da nota
   - Informe o valor se o sistema pedir
2. Confirme o cadastro.
3. Deve aparecer saldo disponível.
4. Na campanha elegível, clique para **liberar / participar** (quando o saldo atingir o mínimo).
5. O sistema consome o saldo e cria a participação.

**WhatsApp esperado:** mensagem “nota cadastrada” (se o aviso estiver ligado).

✅ Checkpoint: nota em saldo (ou já consumida) + participação criada.

---

## 9. Jogar (raspadinha / roleta)

1. Abra o link `/participar/...` (WhatsApp, painel ou portal).
2. Raspe / gire até revelar.
3. Anote o **prêmio** e o **código do cupom**.

Regras importantes:

- O prêmio já foi sorteado no servidor; a animação só revela.
- Atualizar a página **não muda** o prêmio.
- Após revelar, o cliente pode receber WhatsApp com o cupom.

✅ Checkpoint: cupom visível na tela e em **Operação → Cupons**.

---

## 10. Validar e utilizar no caixa

1. Menu **Operação → Caixa**
2. Digite o código do cupom (ex.: `PCT-XXXX`).
3. Confira:
   - Cliente
   - Benefício
   - Validade
   - Status **Disponível**
4. Clique em **Utilizar cupom** (informe valor da compra se a tela pedir).
5. Tente utilizar de novo: deve **bloquear** (já usado).

**WhatsApp esperado:** confirmação de cupom utilizado.

✅ Checkpoint: cupom com status **Utilizado**.

---

## 11. Disparo de promoção no WhatsApp (marketing)

Só envia para quem **autorizou** marketing.

1. Menu **WhatsApp → Disparos → Nova**
2. Escreva a mensagem (claro, curto, com call-to-action).
3. (Opcional) Anexe imagem ou vídeo.
4. Defina o público (filtros), por exemplo:
   - Somente com opt-in
   - Comprou nos últimos X dias
   - Tem cupom disponível
5. Clique em **Pré-visualizar**:
   - Elegíveis
   - Bloqueados por opt-out
   - Telefone inválido
   - Bloqueados por frequência
6. Se estiver ok:
   - **Agendar** data/hora **ou**
   - **Enviar agora** (confirme o aviso)
7. Acompanhe:
   - **WhatsApp → Fila**
   - **WhatsApp → Histórico**
   - **WhatsApp → Dashboard**

Para sair da lista, o cliente responde **SAIR** no WhatsApp.

✅ Checkpoint: mensagem chegou no celular autorizado; opt-out funciona.

---

## 12. Checklist de teste ponta a ponta

Use esta lista em uma reunião de homologação (30–45 min).

### Preparação
- [ ] Login no painel
- [ ] WhatsApp conectado
- [ ] Prêmios cadastrados
- [ ] Campanha ativa com odds = 100%
- [ ] Cliente de teste com WhatsApp real

### Portal / consentimento
- [ ] Cadastro no portal
- [ ] Mensagem de boas-vindas (se aplicável)
- [ ] Resposta 1 ou 2 / SIM ou NÃO
- [ ] Cliente aparece em Autorizados ou Opt-outs

### Participação e prêmio
- [ ] Participação pelo admin (balcão)
- [ ] (Opcional) Nota no portal + liberar campanha
- [ ] Link de jogo abre no celular
- [ ] Prêmio revelado
- [ ] Cupom gerado

### Caixa
- [ ] Consulta do cupom
- [ ] Utilização com sucesso
- [ ] Segunda utilização bloqueada

### WhatsApp marketing
- [ ] Campanha de disparo criada
- [ ] Preview correto
- [ ] Envio / agendamento
- [ ] Mensagem recebida
- [ ] Resposta SAIR remove das promoções

### Painéis
- [ ] Dashboard geral mostra movimento
- [ ] Dashboard WhatsApp atualiza
- [ ] Auditoria registra ações principais

---

## 13. Problemas comuns

| Sintoma | O que verificar |
|---------|-----------------|
| QR não conecta | Clique em sincronizar; desconecte e gere QR de novo |
| Cliente não recebe WhatsApp | Número com DDD; instância conectada; fila/worker rodando |
| Cliente não entra no disparo | Opt-in; limites de frequência; telefone inválido |
| Participação bloqueada | Campanha inativa; valor abaixo do mínimo; limite por cliente |
| Probabilidade inválida | Soma dos prêmios da campanha ≠ 100% |
| Cupom não utiliza | Expirado, cancelado, já usado ou de outro cliente |
| Link de jogo inválido | Token já revelado/errado; use o link da participação |

---

## 14. Ordem sugerida no primeiro dia

```
1. Login
2. Conectar WhatsApp
3. Cadastrar prêmios
4. Criar campanha promo (odds 100%)
5. Cadastrar cliente teste (portal + painel)
6. Fazer 1 participação balcão
7. Jogar / revelar
8. Utilizar cupom no caixa
9. Criar 1 disparo WhatsApp pequeno
10. Testar SAIR
```

Se todos os 10 passos passarem, o ciclo principal do sistema está validado.

---

## 15. Contatos úteis (preencha na implantação)

| Item | Contato |
|------|---------|
| Responsável da farmácia | |
| Número WhatsApp da instância | |
| Suporte técnico | |
| URL do painel | https://ms.restor.app.br |
| URL do portal | https://ms.restor.app.br/cliente/mais-saude |

---

*Documento de uso para homologação e treinamento. Atualizado para o Mais Saúde com módulo de WhatsApp (conexão, consentimento, disparos e avisos transacionais).*