Fluxo do proprietário

Fluxo para negócios digitais

Para quem vende produtos ou serviços online (cursos, e-commerce, consultorias etc.), o QR Code é substituído por um link de carimbo enviado por e-mail após cada compra confirmada.

Fluxo do cliente

Carimbos e selos

Cada visita registra um carimbo na cartela do cliente. O sistema controla automaticamente:

• Cooldown por período — intervalo mínimo entre dois carimbos do mesmo cliente, configurável pelo proprietário (ex.: 1 carimbo a cada 24h).
• Expiração de selos — selos mais antigos que o período de validade configurado são desconsiderados no contador.
• Limite do plano — impede novos cadastros quando o limite de clientes do plano é atingido.

Resgate de recompensa

Ao completar a meta de selos, o cliente vê a tela de "Você ganhou!". O resgate precisa ser confirmado manualmente pelo proprietário no dashboard. Após a confirmação, o contador zera e o cliente começa um novo ciclo.

Aguardando aprovação

Quando o proprietário ativa a aprovação manual de carimbos, o cliente vê a tela de "Aguardando aprovação" após registrar a visita. O carimbo só é efetivado depois que o proprietário aprovar no dashboard.

Vincular Telegram

Após receber um carimbo, o cliente vê um botão para vincular o Telegram. Isso permite receber todas as notificações futuras diretamente no app.

Aba: Overview

Exibe as métricas do negócio em tempo real:

• Total de clientes ativos no programa
• Carimbos hoje e carimbos no mês
• Resgates totais realizados
• Clientes "Quase Lá" — faltando apenas 1 selo para a meta
• Aprovações pendentes — badge de contagem quando a aprovação manual está ativa

A aba exibe também gráficos dos últimos 7 dias: carimbos emitidos (linha) e novos clientes cadastrados (barras).

Aba: Clientes

Lista completa de clientes com nome, telefone, selos acumulados e data do último carimbo. Permite visualizar detalhes individuais e confirmar resgates quando o cliente completar a meta.

A aba possui duas sub-abas:

• Todos os Clientes — lista com busca por nome ou telefone.
• Aniversariantes — calendário mensal navegável com os dias que possuem aniversários destacados. Clique em um dia para filtrar a lista abaixo. A lista é paginada (10 por página) e exibe nome, data de aniversário, selos acumulados e total de resgates.

Aba: Campanhas

Envio de mensagens em massa para segmentos da base de clientes. Veja a seção Campanhas para detalhes completos.

Aba: Rede

Disponível exclusivamente no Rede. Gerencia filiais vinculadas e exibe métricas consolidadas de toda a rede. Veja Plano Rede.

Informações básicas

Controles do programa

Conexão com WhatsApp Starter Pro Rede

Para usar campanhas de mensagens via WhatsApp, conecte uma conta ao sistema. A conexão é feita por QR Code, sem aplicativos extras — funciona como dispositivo vinculado do WhatsApp.

Exclusão de conta

A exclusão de conta pode ser solicitada pelo proprietário a qualquer momento em Dashboard → Configurações → Zona de Perigo. O processo segue um período de carência de 30 dias, em conformidade com a LGPD.

Fluxo de exclusão

Reativação durante a carência

Durante os 30 dias de carência, o proprietário pode cancelar a exclusão a qualquer momento. Basta acessar o dashboard — um banner de aviso vermelho é exibido em todas as abas com o prazo restante — e clicar em "Reativar conta", ou acessar Configurações → Zona de Perigo → Cancelar exclusão.

Como funciona

Como funciona

Cada cliente tem um link de indicação único visível na sua cartela. Quando um novo cliente acessa o sistema por esse link e realiza o primeiro cadastro, o cliente que indicou recebe 1 selo bônus automaticamente.

Controle do proprietário

O programa pode ser habilitado ou desabilitado a qualquer momento nas configurações:

• Desativado: nenhum bônus é concedido e o link de indicação para de aparecer na cartela dos clientes.
• Padrão: todos os negócios iniciam com o programa ativado.

Como funciona

A sua plataforma de pagamento (Stripe, Hotmart, Kiwify, Shopify, ou qualquer outra) chama um endereço específico do QR Club quando uma venda é concluída. O sistema então:

• Cria o cliente automaticamente pelo e-mail (sem necessidade de cadastro prévio)
• Gera um link de carimbo único com validade de 7 dias
• Envia o link por e-mail ao cliente com um botão "Receber carimbo →"
• Ao clicar, o carimbo é registrado e o link expira (uso único)

Configurando a integração

Endereço do webhook

POST https://sua-api.com/api/webhooks/sale/{seu-slug}

Authorization: Bearer {seu-webhook-secret}
Content-Type: application/json

{
  "customer_email": "cliente@email.com",
  "customer_name": "Nome do Cliente"
}

Segurança dos links

Segmentos disponíveis

Variáveis dinâmicas

Personalize o texto da mensagem com variáveis que são substituídas automaticamente no envio:

• {nome} — nome do cliente destinatário
• {negocio} — nome do negócio remetente

Como as mensagens são enviadas

Para proteger sua conta do WhatsApp, o sistema usa envio controlado com fila persistente:

• Intervalo aleatório de 90 a 180 segundos entre cada mensagem — comportamento próximo ao humano.
• Janela horária: disparos somente entre 09h e 20h (horário de Brasília). Mensagens fora desse período ficam em fila para o próximo dia.
• Fila persistente no Redis: reinicializações do servidor não perdem mensagens pendentes — a campanha retoma de onde parou.

Uma mensagem por cliente por dia

Para proteger a experiência dos seus clientes e evitar spam, o sistema garante automaticamente que cada cliente recebe no máximo uma mensagem de campanha por dia.

Ao criar uma campanha, o sistema verifica quais clientes do segmento selecionado já receberam mensagem hoje:

• Clientes que ainda não receberam hoje entram na campanha imediata, enviada normalmente.
• Clientes que já receberam hoje são automaticamente separados em uma segunda campanha agendada para o dia seguinte — sem nenhuma ação extra da sua parte.

Antes de confirmar o envio, o painel de pré-visualização mostra o split: quantos serão enviados hoje e quantos serão agendados para amanhã. Na lista de campanhas recentes, campanhas agendadas exibem o badge "Agendado DD/MM" no lugar do status imediato.

Cota diária por plano

O limite de mensagens de campanha por dia é renovado automaticamente à meia-noite (BRT):

Quando a cota é atingida, o envio para automaticamente e recomeça no dia seguinte — sem nenhuma ação manual.

Acompanhamento da campanha

Na aba Campanhas do dashboard, você acompanha cada envio em tempo real:

• Barra de progresso com percentual enviado e contagem de entregas
• Histórico das últimas campanhas com status: na fila, enviando, concluída ou cancelada
• Cota do dia — mensagens consumidas e disponíveis no plano atual
• Botão Cancelar para interromper uma campanha em andamento

Exemplos de uso

• Uma barbearia com programas separados para corte e barba
• Uma padaria com programas distintos para café e pão artesanal
• Um restaurante com cartelas de almoço e de café da manhã independentes
• Programas sazonais (ex.: especial de natal, aniversário do negócio)

Gerenciar programas

Na aba Programas do dashboard, o proprietário pode criar, editar, ativar/desativar e excluir programas. Cada programa define:

• Nome — exibido na tela do cliente ao selecionar o programa
• Recompensa — o que o cliente ganha ao completar
• Meta de selos — entre 2 e 50 selos

Experiência do cliente

O QR Code do negócio continua sendo um único código. Ao escanear, o cliente vê a seguinte experiência de acordo com o número de programas ativos:

• Nenhum programa criado — comportamento padrão: o cliente acumula selos na cartela principal do negócio.
• Um programa ativo — o programa é selecionado automaticamente; o cliente não vê o seletor.
• Dois ou mais programas ativos — aparece uma tela de seleção com cards para cada programa, mostrando nome, meta e recompensa. O cliente escolhe e então digita o telefone para receber o carimbo.

A cartela do cliente (ao consultar "Ver minha cartela") exibe um card separado para cada programa, com progresso e status de resgate independentes.

Contagem e cooldown independentes

Os selos de cada programa são contados de forma completamente independente. Um carimbo no programa "Cafés" não interfere no progresso do programa "Almoços". O intervalo entre carimbos (cooldown) também é controlado por programa — o cliente pode ganhar um carimbo em cada programa dentro do mesmo período, desde que sejam visitas reais.

Resgate no dashboard

Na aba Clientes do dashboard, a coluna de selos exibe o progresso de cada programa separadamente (ex.: Cafés: 5/6 · Almoços: 3/10). Quando um cliente atinge a meta de algum programa, o botão Resgatar aparece especificamente para aquele programa — permitindo confirmar resgates de programas diferentes de forma independente.

Limite por plano

Cadastrar um funcionário

No dashboard do proprietário, acesse a aba Funcionários. Clique em Adicionar e preencha:

• Nome — nome do funcionário
• E-mail — credencial de login
• Senha — mínimo 6 caracteres

Para remover, clique no ícone de lixeira ao lado do funcionário. A conta fica inativa (o histórico de ações é preservado).

Acesso do funcionário

O funcionário acessa pelo link exclusivo /funcionario — uma tela de login separada da do proprietário. Após entrar, ele é direcionado ao dashboard com as seguintes restrições:

Relatório de ações da equipe

No dashboard do proprietário, a aba Ações da Equipe exibe um histórico de tudo que os funcionários fizeram. Para cada registro:

• Funcionário — nome e e-mail
• Tipo de ação — ex.: "Campanha enviada"
• Detalhes — destinatários, filtro e prévia da mensagem (campanhas)
• Data / hora — horário exato da ação

Funcionalidades

• Selos acumulam em qualquer unidade da rede, de forma transparente para o cliente
• Dashboard consolidado com métricas de toda a rede
• Convites para novas unidades — até 10 unidades por rede
• Cada unidade mantém seu próprio QR Code e configurações locais
• Clientes ilimitados

Gerenciar a rede

Na aba Rede do dashboard, o proprietário envia convites para novas unidades, acompanha o contador de unidades ativas (ex.: 3/10) e visualiza métricas consolidadas de toda a rede.

QR Estático Todos os planos

O QR Code não muda — pode ser impresso uma única vez e usado por tempo indeterminado. Ideal para colocar no balcão, cardápio ou parede.

QR Dinâmico Starter Pro Rede

Disponível a partir do plano Starter como opção ativável nas configurações. Quando ativo, o QR Code muda no intervalo configurado, tornando inválido qualquer screenshot ou imagem compartilhada pelo cliente. Como o código muda constantemente, ele precisa ser exibido em uma tela no balcão — tablet, celular ou monitor — e não pode ser impresso em papel.

Intervalo de rotação configurável

O tempo de rotação pode ser ajustado de 1 a 60 minutos (padrão: 10 min) nas configurações do negócio, na opção Tempo de rotação que aparece ao ativar o QR dinâmico.

• Intervalo curto (1–5 min): máxima segurança — indicado para negócios com grande fluxo ou risco elevado de fraude.
• Intervalo médio (10–15 min): equilíbrio entre segurança e conveniência — padrão recomendado para a maioria dos negócios.
• Intervalo longo (30–60 min): adequado para atendimentos longos (ex.: salões, barbearias) onde o cliente permanece no local por mais tempo.

PDF Imprimível

No dashboard, o botão "Baixar PDF" gera um arquivo A5 com o QR Code do negócio, a logo, o nome do estabelecimento e a descrição da recompensa — pronto para imprimir e exibir no ponto de venda. Recomendado apenas para quem usa o modo QR estático.

Canais disponíveis

Tipos de notificação automática

Relatório semanal

Toda segunda-feira às 8h, o proprietário recebe um e-mail com:

• Total de clientes ativos no programa
• Novos clientes cadastrados na semana
• Ranking dos clientes mais frequentes
• Alertas de clientes próximos de completar a cartela

O relatório é enviado para o e-mail cadastrado na conta do proprietário.

Comparativo

Pagamento

Os planos pagos são cobrados mensalmente. O sistema suporta dois gateways de pagamento:

• Stripe — cartão de crédito (aceita bandeiras internacionais)
• AbacatePay — Pix (exclusivo para o Brasil)

Em caso de falha no pagamento, um e-mail de alerta é enviado automaticamente ao proprietário. O acesso às funcionalidades pagas é mantido durante um período de carência e rebaixado ao plano Free caso o pagamento não seja regularizado.

Como funciona

Configurar o tempo de expiração

O tempo padrão é 30 minutos. Para ajustar, acesse Configurações → Controles e altere o campo Expiração do QR iFood (minutos). Recomendamos entre 20 e 60 minutos dependendo da área de entrega.

Histórico de QR Codes

Abaixo do gerador, o painel exibe os últimos 30 QR Codes gerados com o status de cada um:

Segurança

• Cada QR Code é gerado com um token de 32 caracteres aleatórios.
• Funciona uma única vez — após o uso, qualquer nova tentativa de acesso ao mesmo link retorna "Carimbo já resgatado".
• Expira automaticamente no prazo configurado, mesmo que nunca seja escaneado.
• Não é necessário ter o telefone do cliente de antemão — ele se identifica no momento do resgate.

Como ativar

Em Dashboard → Configurações → Integração PDV, informe o endereço do sistema que deve ser notificado. A partir daí, o QR Club envia uma notificação automática a cada novo carimbo registrado.

Segurança das notificações

Cada notificação enviada pelo sistema inclui uma assinatura de segurança única. Isso permite que o sistema de destino (Zapier, PDV, etc.) confirme que a informação veio genuinamente do QR Club e não foi alterada.

Dados enviados a cada carimbo

{
  "event": "stamp.created",
  "business": {
    "id": 42,
    "name": "Barbearia do Zé",
    "slug": "barbearia-do-ze"
  },
  "customer": {
    "phone": "11999999999",
    "name": "João Silva",
    "stamps_total": 5,
    "stamps_goal": 10
  },
  "timestamp": "2026-06-08T14:30:00.000Z"
}

Compatível com

• Zapier (trigger via Webhook)
• Make / Integromat
• Google Sheets via Apps Script
• Qualquer sistema com endpoint HTTP que aceite POST