Programa de referidos

Un programa de referidos para tu bot de Telegram — mini app lista para usar

Registra quién refirió a quién, acumula recompensas automáticamente y págalas — sin construir tu propio backend. Una infraestructura de referidos y una mini app listas, que se conectan en minutos.

Plan gratuito · Sin tarjeta · Lánzalo en 5 minutos

La sección “Programa de referidos” en el panel de graspil
5 min
Para lanzar un programa de referidos
2 modos
Solo observación, o gestión completa
Auto
Pagos manuales, por webhook o programados
Qué puede hacer

Un programa de referidos completo, sin necesidad de desarrollo

Todo lo que necesitas para lanzar y hacer crecer el programa de referidos de tu bot — en un solo lugar.

Seguimiento de fuentes

Descubre qué enlaces y etiquetas traen nuevos usuarios, y vincula cada visita a un referidor específico.

Registro de referidores y referidos

El sistema sabe quién invitó a quién y mantiene un historial completo de las relaciones referidor → referido.

Acumulaciones automáticas

Reglas de recompensa flexibles: un monto fijo, un porcentaje, o una acumulación externa activada por cualquier evento de tu bot.

Pago de recompensas

Manualmente, por webhook, o automáticamente con una programación. Los saldos se controlan por separado para cada moneda.

Estadísticas y analítica

Funnel, top referidores, tendencias de acumulación y datos de referidos directamente en el generador de informes.

Sobre tu propio sistema

Se puede conectar incluso si ya tienes tu propia lógica de referidos — sin cambios en tu infraestructura.

¿Ya tienes tu propio sistema de referidos? No hay problema

El sistema de referidos de graspil puede funcionar sobre el tuyo. En modo “Observar” simplemente obtienes analítica y seguimiento de visitas en tus enlaces actuales — sin cambiar tu bot ni tu infraestructura.

Modos

Observar o Gestionar — tú decides

Dos modos para necesidades distintas: analítica pura sobre tu propia lógica, o un programa de referidos completo de nuestro lado.

Observar

El sistema captura los códigos que llegan en el parámetro ?start= de tus enlaces y vincula las visitas a los usuarios. Tu bot genera y controla los códigos.

  • Ideal si ya emites tus propios enlaces de referidos
  • Analítica completa de visitas sin cambios en la infraestructura
  • Las acumulaciones funcionan una vez que envías el ID de Telegram del referidor o vinculas un código a su dueño mediante la API

Gestionar

La plataforma genera códigos y enlaces únicos para cada referidor. Obtienes reglas de recompensa, saldos y pagos — desde la interfaz o la API.

  • Códigos y enlaces de referido únicos listos para usar
  • Reglas de acumulación, saldos y pagos
  • Perfecto si vas a construir un programa de referidos desde cero
Enlaces y códigos

Configuración flexible de enlaces de referido

Define tu propio nombre de parámetro, pasa un código opaco, o directamente el ID de Telegram del referidor — el sistema se adapta a tu formato de enlace.

  • Nombre de parámetro personalizado (por defecto ref) para que coincida con tu formato de enlace
  • Modo “Parámetro = ID de Telegram del referidor”, sin capa de mapeo código-usuario
  • Vincula un código a su dueño mediante la API — por adelantado (preasignación) o de forma retroactiva (backfill)
Formato de enlace
Código opaco (predeterminado)
t.me/your_bot?start=ref-aK39xZ
ID de Telegram del referidor directamente
t.me/your_bot?start=128471992
El nombre del parámetro y el modo se configuran con un clic
Regla de recompensa
10% en el pago del referido Activa
Evento
payment
Condición
≥ 1000 ₽
Recompensa
10%
Retención
14 días
Efecto secundario
POST https://api.yourbot.com/reward
Reglas de acumulación

Las reglas flexibles son el corazón del programa de referidos

Cada regla define: qué evento la activa, cuánto acreditar al referidor, y qué más hacer. Varias reglas se aplican según su prioridad.

  • Disparador — cualquier evento de tu bot: un pago, una suscripción, un paso del funnel
  • Condiciones sobre el valor del evento: mínimo, máximo, o coincidencia exacta
  • Un período de retención — protección contra reembolsos antes del pago
  • Efectos secundarios: una llamada por webhook y la actualización de campos personalizados del usuario
  • Prioridad de regla cuando varias reglas coinciden con el mismo evento
Fijo
Un monto específico en la moneda elegida por cada evento.
Porcentaje
Un porcentaje del monto del evento — la moneda proviene del propio evento.
Externo
La plataforma notifica a tu servidor mediante webhook, y tú calculas el monto.
Pagos

Paga recompensas como prefieras

Una vez que un referidor tiene un saldo aprobado, puedes pagarlo manualmente, por webhook, o automáticamente con una programación.

Manual
Transfiere el dinero como prefieras y marca el pago en el sistema. La plataforma lleva el control.
Webhook
La plataforma envía una solicitud POST con “acreditar X de la moneda Y al usuario Z”, y tu servidor la ejecuta.
Pagos automáticos
Con una programación (mensual o cada N días) y un umbral mínimo por moneda.
Saldo del referidor
Disponible4 820 ₽
Reservado1 200 ₽
En retención650 ₽
Pagado12 300 ₽
Ciclo de vida del pago
SolicitadoEn procesoCompletado
Estadísticas y funnel del programa de referidos
Estadísticas

Analítica completa del programa de referidos

Sigue el rendimiento del programa y usa los datos de referidos en el generador de informes junto con el resto de la analítica de tu bot.

  • Funnel del programa de referidos, desde la visita hasta la acción objetivo
  • Top referidores y tendencias de acumulación a lo largo del tiempo
  • Saldos y estados de acumulación por moneda
  • Datos de referidos disponibles en el generador de informes
Automatización dentro del bot

Workflows listos para usar directamente en tu bot

Con las herramientas de automatización, los usuarios de tu bot pueden gestionar el programa de referidos sin salir de Telegram.

Registro en el programa

El usuario se une al programa de referidos y recibe su enlace personal directamente en el chat con el bot.

Estadísticas personales

El referidor ve su saldo, el número de personas invitadas y el historial de acumulaciones mediante un comando del bot.

Solicitar un pago

Un botón “Retirar” activa el pago del saldo acumulado directamente desde el bot.

Escenarios listos para usar — sin necesidad de código
Tu Bot
bot

¡Bienvenido al programa de referidos! Toca /ref para obtener tu enlace.

/ref

Tu enlace de referido personal:

t.me/your_bot?start=ref-aK39xZ
📊 Mis estadísticas💸 Solicitar pago

¡Invita a tus amigos y recibe recompensas por cada acción objetivo!

API

Control total mediante la API

Gestiona el programa de referidos de forma programática: emite enlaces, vincula códigos a sus dueños y activa pagos directamente desde tu bot.

  • Emite un enlace de referido a un usuario por comando
  • Vincula dueños de código en bloque — preasignación y backfill
  • Activa pagos al tocar un botón en el bot
API de referidos
GETreferral/default/referrer-code

Devuelve (o crea) un enlace de referido para un usuario

POSTv1/referral/set-code-owners

Vincula dueños a uno o varios códigos

POSTv1/referral/payout

Activa el pago del saldo disponible del referidor

Preguntas frecuentes

Lanza tu programa de referidos hoy

Conecta tu bot, configura reglas y pagos — y escala el crecimiento a través de tus propios usuarios.

Conectar el sistema de referidos

Plan gratuito · Sin tarjeta · Lánzalo en 5 minutos