Recomendación de miembros
Cada miembro recibe un enlace de recomendación; quien entra por él cuenta como recomendado, una vez, y el equipo ve quién trajo a quién. Activar y desactivar, las reglas de cuándo cuenta, los puntos, los workflows y el informe.
La recomendación de miembros da a cada persona de la comunidad un enlace propio para invitar a otras. Quien entra por el enlace queda registrado como recomendado por ella: el equipo ve quién trajo a quién, y la comunidad puede dar puntos e insignias por recomendación y disparar workflows cuando alguien recomienda.
Para qué sirve
| Comunidad | Cómo la usa |
|---|---|
| Comunidad que crece de boca en boca | Activa la recomendación y sigue quién trae más gente nueva |
| Comunidad con gamificación | Da puntos por la acción Recomendar miembro y una insignia a quien recomienda a 5 personas |
| Programa de embajadores | Un workflow con Recomendó a alguien envía un DM de agradecimiento y pone a la persona en el grupo Embajadores |
Quién puede
| Rol | Qué hace |
|---|---|
| Propietario y administrador | Activan y desactivan la recomendación; ven el informe y el Recomendado por de cada miembro |
| Moderador | Ve el informe y el Recomendado por |
| Financiero | No ve el informe ni quién recomendó a quién (es un dato personal, fuera de lo financiero) |
| Miembro | Obtiene su propio enlace y ve a cuántas personas recomendó |
Dónde está
| Quién | Dónde |
|---|---|
| Propietario y administrador | Configuración › Acceso y registro, tarjeta Recomendaciones: el interruptor la activa y desactiva, y Ver el informe de recomendaciones abre el informe |
| Propietario, administrador y moderador | Miembros › Recomendaciones: cada persona que recomendó, con Miembro, Recomendaciones y Última, el Período (30 días, 90 días o Todo) y Descargar CSV. En la página de otro miembro, la tarjeta Recomendado por ("Solo el equipo lo ve.") |
| Miembro | Mi cuenta › Recomendar y su propia página: la tarjeta Recomienda la comunidad, con el enlace, Copiar y cuántas personas entraron por él. Solo aparece con la recomendación activada |
Quien abre el enlace y se registra en la app cuenta como recomendado: la app guarda el código durante 30 días, y el disparador Recomendó a alguien está en el editor de workflows.
Cómo funciona
Activar
La recomendación nace desactivada. Activada, cada miembro tiene un código propio, creado la primera vez que pide el enlace, y el enlace es la dirección de la comunidad con ?ref= y el código (https://tucomunidad.memberfy.net/?ref=ana7k2). Desactivada, nadie tiene enlace, y un código recibido no cuenta.
Cuándo cuenta la recomendación
La recomendación cuenta una vez, cuando la persona recomendada pasa a ser miembro, y solo si:
- la recomendación está activada en la comunidad en ese momento;
- el código es de un miembro activo de esta comunidad;
- quien entra no es la misma persona que recomendó (ni por el perfil, ni por el correo);
- quien entra nunca tuvo perfil en esta comunidad;
- el enlace se abrió hace 30 días como máximo.
El código nunca impide un registro ni abre la comunidad a quien no podría entrar: el registro sigue las reglas de siempre (ver Registro y acceso). En una comunidad con aprobación del registro, el código espera junto con la solicitud y cuenta cuando la solicitud se aprueba.
Qué pasa en una recomendación
- La persona nueva queda con el origen Recomendación, que aparece en la tarjeta de crecimiento del Dashboard, entre los orígenes de los miembros nuevos de los últimos 7 días.
- Quien recomendó hace la acción Recomendar miembro de la gamificación: vale 0 puntos por defecto (la comunidad elige cuánto) y cuenta para las reglas de insignia y los requisitos de nivel con esa acción.
- Sale el evento Recomendó a alguien, sobre quien recomendó, con el nombre de quien entró: disparador de workflow (con la variable
referred.name) y webhookmember.referred.
El informe
Para el propietario, el administrador y el moderador: cada persona que recomendó, con cuántas recomendaciones y la fecha de la última, y el total, en un período. También sale en CSV. Quien salió de la comunidad sigue en el informe, marcado como eliminado.
Ejemplo
La comunidad activa la recomendación y da 50 puntos por Recomendar miembro. Ana obtiene el enlace y se lo manda a Bruno, que abre el enlace, se registra al día siguiente y pasa a ser miembro. Ana gana 50 puntos, Bruno aparece con el origen Recomendación, y el workflow con Recomendó a alguien le envía a Ana: "¡Gracias por traer a Bruno!".
Errores frecuentes y cómo resolverlos
| Situación | Qué hacer |
|---|---|
| La recomendación no contó | Comprueba que la recomendación estaba activada, que la persona nunca tuvo perfil en la comunidad y que el enlace se abrió hace menos de 30 días |
| La persona se recomendó a sí misma con otro registro | No cuenta: el mismo correo o el mismo perfil se rechaza como recomendación |
| La recomendación no dio puntos | La acción Recomendar miembro vale 0 por defecto; cambia el valor en las reglas de puntos de la gamificación |
Preguntas frecuentes
¿El recomendado sabe quién lo recomendó? No por aquí. Quien recomendó aparece solo para el equipo (propietario, administrador y moderador).
¿Desactivarla borra las recomendaciones? No. Las recomendaciones que ya contaron se quedan; solo dejan de contar las nuevas.
¿Se puede recomendar a alguien para una comunidad de pago? Sí. El enlace lleva a la comunidad, y la persona entra con las reglas de siempre, incluida la compra. La recomendación cuenta cuando pasa a ser miembro.
En la API
GET y PUT /api/referrals/settings (propietario y administrador; los otros roles reciben 403) activan y desactivan (enabled). GET /api/referrals/me (cualquier miembro) devuelve enabled, code, path (/?ref=<código>) y count. GET /api/referrals/report (propietario, administrador y moderador; el financiero recibe 403) trae, por persona, memberId, name, avatarUrl, removed, count y lastReferredAt, con totals, paginación, from/to y format=csv.
En el registro, POST /api/auth/register y POST /api/auth/signup-request aceptan referralCode y referralSeenAt (cuándo se abrió el enlace; más de 30 días, se ignora). GET /api/members/{id} trae referredBy (memberId, name, avatarUrl, removed, referredAt) en el perfil de otra persona, solo para propietario, administrador y moderador, y source puede ser REFERRAL. La tarjeta de crecimiento del Dashboard trae extra.bySource. Consulta Referrals en la Referencia de la API.
Con el asistente (MCP)
Pide al asistente tu enlace ("¿cuál es mi enlace de recomendación?", get_my_referral), el informe ("¿quién trajo más miembros nuevos este mes?", get_referral_report, para el propietario, el administrador y el moderador) o que active la recomendación (update_referral_settings). Quién recomendó a un miembro aparece en get_member.