# 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](/notificacoes/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](/membros/cadastro-e-entrada)). 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](/membros/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](/membros/gamificacao): 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](/notificacoes/workflows) (con la variable `referred.name`) y [webhook](/api/eventos-de-webhook) `member.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](/membros/gamificacao) |

## 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](/api/referencia/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`](/mcp/ferramentas-membros#get-my-referral)), el informe (*"¿quién trajo más miembros nuevos este mes?"*, [`get_referral_report`](/mcp/ferramentas-membros#get-referral-report), para el propietario, el administrador y el moderador) o que active la recomendación ([`update_referral_settings`](/mcp/ferramentas-membros#update-referral-settings)). Quién recomendó a un miembro aparece en [`get_member`](/mcp/ferramentas-membros#get-member).

## Relacionados

- [Invitar miembros](/membros/convidar-membros)
- [Registro y acceso](/membros/cadastro-e-entrada)
- [Gamificación](/membros/gamificacao)
- [Workflows](/notificacoes/workflows)
- [Eventos de webhook](/api/eventos-de-webhook)