Programa de Indicação

Um programa de indicação para o seu bot do Telegram — mini app pronto para usar

Acompanhe quem indicou quem, acumule recompensas automaticamente e pague os indicadores — sem precisar construir seu próprio backend. Uma infraestrutura de indicação completa e um mini app que se conectam em minutos.

Plano gratuito · Sem cartão de crédito · Comece em 5 minutos

A seção “Programa de Indicação” no painel do graspil
5 min
Para lançar um programa de indicação
2 modos
Apenas observar ou gerenciar por completo
Automático
Pagamentos manuais, por webhook ou agendados
O que você pode fazer

Um programa de indicação completo, sem precisar programar

Tudo o que você precisa para lançar e expandir o programa de indicação do seu bot — em um só lugar.

Rastreamento de origem

Veja quais links e tags trazem novos usuários e vincule cada visita a um indicador específico.

Controle de indicadores e indicados

O sistema sabe quem convidou quem e mantém um histórico completo das relações entre indicador e indicado.

Acúmulo automático de recompensas

Regras flexíveis de recompensa: um valor fixo, um percentual ou um acúmulo externo disparado por qualquer evento do seu bot.

Pagamento de recompensas

De forma manual, por webhook ou automaticamente em uma agenda fixa. Os saldos são controlados separadamente por moeda.

Estatísticas e análises

Funil, principais indicadores, tendências de acúmulo e dados de indicação direto no construtor de relatórios.

Sobre o seu sistema atual

Pode ser conectado mesmo que você já tenha sua própria lógica de indicação — sem precisar alterar a infraestrutura.

Já tem seu próprio sistema de indicação? Isso não é um problema

O sistema de indicação do graspil pode funcionar sobre o seu próprio sistema. No modo “Observar”, você simplesmente recebe análises e rastreamento de visitas para os seus links existentes — sem alterar seu bot ou sua infraestrutura.

Modos

Observar ou Gerenciar — você escolhe

Dois modos para necessidades diferentes: análises puras sobre a sua própria lógica, ou um programa de indicação completo do nosso lado.

Observar

O sistema captura os códigos que chegam pelo parâmetro ?start= dos seus links e vincula as visitas aos usuários. Seu bot gera e controla os códigos.

  • Ideal se você já emite seus próprios links de indicação
  • Análises completas de visitas sem alterar a infraestrutura
  • Os acúmulos funcionam quando você informa o ID do Telegram do indicador ou vincula um dono de código via API

Gerenciar

A plataforma gera códigos e links exclusivos para cada indicador. Você ganha regras de recompensa, saldos e pagamentos — pela interface ou pela API.

  • Códigos e links de indicação exclusivos prontos para usar
  • Regras de acúmulo, saldos e pagamentos
  • Perfeito se você está construindo um programa de indicação do zero
Links e códigos

Configuração flexível de links de indicação

Defina seu próprio nome de parâmetro, use um código opaco ou o ID do Telegram do indicador diretamente — o sistema se adapta ao formato do seu link.

  • Nome de parâmetro personalizado (padrão ref) para combinar com o formato do seu link
  • Modo “Parâmetro = ID do Telegram do indicador”, sem camada de mapeamento entre código e usuário
  • Vincule um dono de código via API — antecipadamente (pré-atribuição) ou retroativamente (preenchimento)
Formato do link
Código opaco (padrão)
t.me/your_bot?start=ref-aK39xZ
ID do Telegram do indicador diretamente
t.me/your_bot?start=128471992
Nome do parâmetro e modo são configuráveis em um clique
Regra de recompensa
10% sobre pagamento de indicado Ativa
Evento
payment
Condição
≥ 1000 ₽
Recompensa
10%
Retenção
14 dias
Efeito adicional
POST https://api.yourbot.com/reward
Regras de acúmulo

Regras flexíveis são o coração do programa de indicação

Cada regra define: qual evento a dispara, quanto creditar ao indicador e o que mais deve acontecer. Várias regras se aplicam por ordem de prioridade.

  • Gatilho — qualquer evento do seu bot: pagamento, assinatura, uma etapa do funil
  • Condições sobre o valor do evento: mínimo, máximo ou correspondência exata
  • Um período de retenção — proteção contra reembolsos antes do pagamento
  • Efeitos adicionais: chamada de webhook e atualização de campos personalizados do usuário
  • Prioridade da regra quando várias regras correspondem ao mesmo evento
Fixo
Um valor específico na moeda escolhida para cada evento.
Percentual
Um percentual do valor do evento — a moeda vem do próprio evento.
Externo
A plataforma notifica seu servidor via webhook, e você calcula o valor.
Pagamentos

Pague recompensas do jeito que preferir

Depois que um indicador tiver saldo aprovado, você pode pagar manualmente, por webhook ou automaticamente em uma agenda fixa.

Manual
Transfira o dinheiro como preferir e marque o pagamento no sistema. A plataforma mantém o controle.
Webhook
A plataforma envia uma requisição POST com “creditar X da moeda Y ao usuário Z”, e o seu servidor executa.
Pagamentos automáticos
Em uma agenda fixa (mensal ou a cada N dias) com um limite mínimo por moeda.
Saldo do indicador
Disponível4 820 ₽
Reservado1 200 ₽
Em retenção650 ₽
Pago12 300 ₽
Ciclo de vida do pagamento
SolicitadoEm processamentoConcluído
Estatísticas e funil do programa de indicação
Estatísticas

Análises completas do programa de indicação

Acompanhe o desempenho do programa e use os dados de indicação no construtor de relatórios junto com o restante das análises do seu bot.

  • Funil do programa de indicação, da visita até a ação desejada
  • Principais indicadores e tendências de acúmulo ao longo do tempo
  • Saldos e status de acúmulo por moeda
  • Dados de indicação disponíveis no construtor de relatórios
Automação no bot

Fluxos prontos direto no seu bot

Com as ferramentas de automação, os usuários do seu bot podem gerenciar o programa de indicação sem nunca saírem do Telegram.

Inscrição no programa

O usuário entra no programa de indicação e recebe seu link pessoal direto na conversa com o bot.

Estatísticas pessoais

O indicador vê seu saldo, o número de pessoas convidadas e o histórico de acúmulos por meio de um comando do bot.

Solicitação de pagamento

Um botão “Sacar” dispara o pagamento do saldo acumulado direto pelo bot.

Cenários prontos — sem necessidade de código
Seu Bot
bot

Bem-vindo ao programa de indicação! Toque em /ref para receber seu link.

/ref

Seu link de indicação pessoal:

t.me/your_bot?start=ref-aK39xZ
📊 Minhas estatísticas💸 Solicitar pagamento

Convide amigos e seja recompensado por cada ação realizada!

API

Controle total via API

Gerencie o programa de indicação por código: emita links, vincule donos de código e dispare pagamentos direto do seu bot.

  • Emita um link de indicação para um usuário sob demanda
  • Vincule donos de código em lote — pré-atribuição e preenchimento retroativo
  • Dispare pagamentos ao toque de um botão no bot
API de indicação
GETreferral/default/referrer-code

Retorna (ou cria) um link de indicação para um usuário

POSTv1/referral/set-code-owners

Vincula donos a um ou mais códigos

POSTv1/referral/payout

Dispara o pagamento do saldo disponível do indicador

Perguntas frequentes

Lance seu programa de indicação hoje

Conecte seu bot, configure regras e pagamentos — e escale o crescimento por meio dos seus próprios usuários.

Conectar o sistema de indicação

Plano gratuito · Sem cartão de crédito · Comece em 5 minutos