LINK.SAGA: programa de afiliados que vende a assinatura sem atendimento manual
Programa de parceiros do SAGA Pass: criadores de conteúdo indicam a assinatura por um link próprio e recebem comissão pelas vendas.
- Meus links e materiais
- Tarja com QR code
- Fundo e texto da tarja
- Overlay de live
- Cupom com link e QR code
- Problema
- Vender a assinatura por criadores de fora da empresa, em escala, sem que cada parceiro dependesse de atendimento manual.
- Papel
- Concebeu o programa, programou sozinho o protótipo, assumiu a base técnica existente e liderou o desenvolvimento da plataforma (cerca de 70% do código atual, com desenvolvimento assistido por IA)
- O que foi entregue
- Entrada controlada, treinamento obrigatório, links com desconto e prazo, contagem regressiva antes do checkout, contagem de cliques sem robôs, materiais com QR code e pagamento auditável.
- Ferramentas
- Next.js · TypeScript · tRPC · PostgreSQL · integração SOAP com o ERP · Docker · CDN · desenvolvimento assistido por IA
Do protótipo em duas semanas à plataforma no ar: entrada controlada, treinamento, link com prazo que leva ao checkout com o desconto aplicado e comissão rastreada até o pagamento.
O que mudou
| Era | Ficou |
|---|---|
| Parceiro externo dependia de atendimento manual para entrar, aprender e divulgar. | Só cria link quem foi aprovado e concluiu o treinamento, sem atendimento manual. |
| Desconto divulgado como código solto vira desconto permanente e tira a alavanca de quem vende. | O desconto vai a público dentro de um link com data de fim: o visitante vê o prazo e chega ao checkout com o cupom já aplicado, sem digitar código. |
Mais 3 mudanças
| O contador de acessos do link estava parado e somava robôs de pré-visualização. | O clique é registrado pelo próprio LINK, só de pessoas, um por visitante a cada 30 dias, sem guardar quem é o visitante. |
| O aceite das regras do parceiro não tinha registro verificável. | Cada aceite fica gravado com a versão, o IP, o navegador e a impressão digital (hash) do texto exato que a pessoa leu. |
| Cada caso de parceiro dependia do time comercial para ser resolvido. | O ciclo inteiro, da inscrição ao resgate do pagamento, acontece num só lugar, com histórico de cada ação. |
Como funciona, passo a passo
-
Cadastro
O criador se inscreve com dados de contato, redes sociais e o motivo para ser afiliado. A conta é a mesma do ambiente do aluno.
Entrada · Login do HUB
-
Aprovação
A administração lê a ficha e aprova ou recusa. Aprovar grava o grupo de afiliado ativo no sistema da empresa; até lá, só o dashboard abre.
Decisão humana · Painel administrativo
-
Treinamento
Vídeos em sequência, sem avançar e no máximo a 1,25x. Enquanto falta algum, as demais áreas ficam travadas.
Ferramenta · Player travado
-
Gera o link
O parceiro escolhe o plano, o desconto (20%, 30% ou 40%) e, se quiser, a data de expiração. O sistema da empresa cria o cupom e devolve o link curto.
Decisão humana · Meus links
-
Divulga
Copia o link, baixa o QR code ou usa as faixas e materiais prontos com o QR do próprio link.
Ferramenta · QR code e materiais
-
Visitante clica
linkbeta.saga.com.br/l/<código>. Código que não existe volta para a home. O clique só conta se for de uma pessoa, uma vez por visitante a cada 30 dias.
Entrada · Encurtador /l/
-
Dois caminhos em paralelo
-
com prazo
-
Contagem regressiva
Link com data de fim no futuro mostra dias, horas, minutos e segundos até expirar e segue sozinho em 4 segundos.
Ferramenta · Tela de prazo
-
-
sem prazo
-
Redireciona na hora
Link sem prazo vai direto, sem tela intermediária.
Ferramenta
-
-
-
Checkout com o cupom
O destino definido para o produto recebe o código do cupom no endereço, e a página de assinatura abre com o desconto aplicado.
Resultado · Página de assinatura
-
Venda atribuída
O pedido fica registrado no sistema da empresa com o cupom do parceiro. É isso que liga a venda a ele.
Dados · ERP da empresa
-
Comissão no painel
Acessos, matrículas, conversão e comissão por ciclo mensal. Venda recente passa por prazo de confirmação; devolução desconta do ciclo da venda.
nova campanha: volta para a etapa 4 (Gera o link)
Dados · Painel do parceiro
-
Resgate
O mês fechado fica disponível no dia 1º seguinte. O parceiro pede o pagamento por PIX e a administração aprova; cada ação fica no histórico.
Decisão humana · Trilha de auditoria
Assets do projeto
Gestão de produto e go-to-market: como transformar criadores de conteúdo num canal de aquisição da assinatura (marketing de afiliados), com entrada controlada, desconto que só vai a público com prazo e cada passo auditável.
Contexto: um canal de parceiros para o modelo de assinatura
Com o SAGA Pass no ar, a escola abriu um programa de parceiros (afiliados) para que criadores de conteúdo indicassem a assinatura. Para o canal crescer, quem pode divulgar, depois de aprender o quê, por qual link e com que regras não podia depender do time comercial caso a caso. Havia um portal na empresa, mas só como base técnica: faltava o processo, confiável para o parceiro e auditável para a empresa.
Havia também uma regra comercial a proteger: o código de desconto não pode circular solto, porque vira desconto permanente e tira a alavanca de quem vende. Desconto para o público só vale dentro de um link com data para acabar.
Como o link funciona
- Cadastro. O criador preenche a inscrição: contato, cidade, redes sociais e o motivo para ser afiliado. A conta é a mesma do ambiente do aluno.
- Aprovação. A administração lê a ficha e aprova ou recusa. Aprovar grava o grupo de afiliado ativo no sistema da empresa. Antes disso, o menu mostra as áreas com cadeado e só o dashboard abre, com o aviso de que a inscrição está em análise.
- Treinamento. O primeiro passo depois da aprovação. Os vídeos tocam em sequência, sem avançar e no máximo a 1,25x, e o progresso fica no servidor. Enquanto falta algum vídeo, as demais áreas seguem travadas.
- Geração do link. Em “Meus links”, o parceiro escolhe o plano (ou todos), o desconto de 20%, 30% ou 40%, o nome da campanha e, se quiser, a data de início e a de expiração. O sistema da empresa cria o cupom com o prefixo LK_ e devolve o link curto
linkbeta.saga.com.br/l/<código>. No mesmo momento o LINK guarda, para aquele código, a página de destino definida pela administração para o produto e a data de fim. - Divulgação. O parceiro copia o link, compartilha, baixa o QR code ou usa as faixas e materiais prontos, que já trazem o QR do próprio link.
- Clique. Quem abre o link passa pela rota
/l/<código>. Código que não existe volta para a home. O clique só é contado se vier de uma pessoa: robôs de pré-visualização (WhatsApp, redes, buscadores) e o pré-carregamento do navegador ficam de fora, e cada visitante conta uma vez por link a cada 30 dias. O visitante é identificado por um resumo (hash), sem guardar quem ele é. - Contagem regressiva. Se o link tem data de fim no futuro, o visitante vê uma tela com dias, horas, minutos e segundos até expirar, e segue sozinho em 4 segundos ou no botão “Continuar agora”. Link sem prazo redireciona na hora.
- Checkout com o cupom. O destino recebe o código no endereço (
?cupom=), e a página de assinatura abre com o desconto aplicado. O visitante não digita código nenhum, e o código não precisa aparecer na peça de divulgação. - Venda atribuída. O pedido fica registrado no sistema da empresa com o cupom do parceiro. O extrato do parceiro vem dali, venda a venda.
- Comissão no painel. O dashboard mostra o ciclo do mês, acessos, matrículas, conversão, vendas em confirmação e comissão confirmada. Venda recente passa por um prazo de confirmação, e uma devolução desconta do ciclo da venda, mesmo registrada em outro mês.
- Resgate. O valor líquido do mês fica disponível no dia 1º do mês seguinte. O parceiro cadastra a chave PIX e pede o resgate; a administração aprova, e o pagamento do ciclo sai no dia 8. Cada pedido e cada mudança de situação ficam na trilha de auditoria.
Regras de prazo. A data de fim vale para a tela de contagem e é enviada ao sistema da empresa junto com o cupom. Passada a data, a contagem não aparece mais. O desconto sai da tela de criação em três faixas fixas, e a administração muda a página de destino de cada produto sem tocar nos links: o destino é copiado no momento em que o link nasce, então os links que já existem continuam indo para onde iam.
Papel
- Decisão de produto. Desenhou o programa e a jornada do parceiro e validou a ideia num protótipo próprio antes de investir na plataforma.
- Liderança técnica. Assumiu o repositório da empresa, feito antes por outros desenvolvedores, e liderou a fase atual. Escreveu cerca de 70% do código atual; outro desenvolvedor do time escreveu cerca de 15%, e o restante vem da base anterior.
- Trabalho em conjunto. A aprovação de parceiros e o resgate de pagamento foram feitos em conjunto com esse colega. A criptografia dos dados de pagamento é dele.
- Método. Desenvolvimento assistido por IA: metade dos commits dessa autoria tem a IA como coautora, sempre com testes automáticos conferindo o resultado.
O que foi feito
- Validação em duas semanas. Um protótipo estático, programado sozinho (página de entrada, login e painel do parceiro), trazia o material de apoio lido ao vivo de uma pasta compartilhada. O visual dele, preto e laranja com brilho de destaque, virou a base da plataforma.
- Portal no padrão da marca. O design system da SAGA foi aplicado e a página inicial foi refeita com vídeo de abertura, linha do tempo do programa, kit de materiais e SEO.
- Porta de entrada fechada. Inscrição, fila de aprovação e só então o treinamento obrigatório, com controles para a administração concluir ou reiniciar o treinamento de alguém.
- Link com prazo e checkout com desconto. A tela de contagem regressiva e a prévia dela são da fase atual; o encurtador já existia na base. Também é desta fase o de-para próprio de cada código (destino por produto e data de fim) e a tela em que a administração define o destino de cada produto.
- Contagem de cliques confiável. Os links passaram a apontar direto para a página de assinatura, e o contador de acessos do sistema da empresa parou de receber cliques. O registro passou para o LINK, que é dono do link, com filtro de robôs e uma contagem por visitante.
- Regras formalizadas. Os Termos de Parceria são aceitos no envio da inscrição. Para parceiros com cargo de influencer há uma tela obrigatória: o botão só libera depois de ler até o fim, o portal fica bloqueado até o aceite, há exigência de maioridade e cada aceite fica registrado com a versão do texto. Quando os termos mudam, o influencer aceita de novo.
- Ferramentas de divulgação. Gerador de faixas com o QR code do link de cada parceiro e imagem de compartilhamento gerada por link.
- Comunicação e operação organizadas. Central de notificações com resumo diário e marcos de venda, comunicados com público-alvo e confirmação de entrega, painel administrativo com ranking e trilha de auditoria, redefinição de senha e login mais robusto. Também saíram desta fase os comunicados animados aos parceiros e o deck de produto do parceiro, que separa o que é produto do que é argumento comercial.
Resultado
O programa saiu de um protótipo validado em duas semanas para uma plataforma no ar em cerca de dois meses. Hoje só cria link quem foi aprovado e concluiu o treinamento, o desconto só chega ao público dentro de um link com prazo, e cada passo, do clique ao resgate, fica registrado para a empresa conferir.
Por dentro: stack e métodos
- Stack: Next.js 15 (App Router, saída standalone), React 19, TypeScript, tRPC 11 com React Query 5, superjson e Zod, NextAuth, PostgreSQL, Tailwind, Radix e shadcn. Protótipo em HTML, CSS e JavaScript puros.
- Identidade e permissão: autenticação contra o ambiente do aluno, via SOAP no ERP da empresa. A autorização é por grupo e é revalidada a cada consulta de sessão; o registro local nunca concede acesso. Criar link e pedir resgate passam por um procedimento que exige afiliado ativo, e a página fecha pelo layout e a API fecha pelo procedimento.
- Links: a rota
l/[code]consulta primeiro o de-para local (destino e data de fim gravados na criação) e, sem registro, pergunta o destino ao ERP. O cupom entra no destino como parâmetrocupom, normalizado em maiúsculas. O registro do clique roda semawait, para não somar a latência do ERP ao redirecionamento. - Cliques: a decisão de contar é uma função pura e testada: sem user agent não conta, prefetch e prerender não contam, e uma lista de robôs de pré-visualização é descartada. Deduplicação por código e visitante numa janela de 30 dias, com um evento datado por acesso para os relatórios por período.
- Termos: versão aceita guardada no token de sessão, sem custo de consulta; rotas bloqueadas por gate de sessão e erro FORBIDDEN no tRPC até o aceite; registro com versão, IP, user agent e hash SHA-256 do texto exato; um teste falha se o texto mudar sem atualizar o hash.
- Treinamento: sequência ordenada por manifesto (vídeo não publicado não entra), player com avanço bloqueado e velocidade limitada, progresso por vídeo em tabela própria. Saiu do
localStorageporque não acompanhava troca de aparelho, não dava visibilidade à empresa e travava quem usa navegação privada. - Materiais: manifesto gerado a partir da CDN, streaming por byte-range, cache-busting na troca de arquivo e sincronização em Python.
- Aprovação e resgate (com um colega): sincronização paginada que retoma de onde parou, aprovação idempotente, saldo por ciclo no fuso de São Paulo e trilha de auditoria. A criptografia dos dados de pagamento é do colega.
- Estabilidade: warm-up e cache por requisição das consultas pesadas, JavaScript, fontes e imagens mais leves para computadores antigos, Docker multiestágio rodando como usuário sem privilégio, build limitado em memória depois de um incidente, tipos e lint no CI e testes de integração contra um ambiente simulado.
- Prints desta página: as telas públicas foram fotografadas da versão no ar; as telas internas, de uma cópia local ligada a um sistema da empresa simulado, com contas e códigos de exemplo e sem valores.