# Indicação de membros

> Cada membro ganha um link de indicação; quem entra por ele conta como indicado, uma vez, e a equipe vê quem trouxe quem. Ligar e desligar, as regras de quando conta, os pontos, os workflows e o relatório.

A **indicação de membros** dá a cada pessoa da comunidade um link próprio para convidar outras. Quem entra pelo link fica registrado como **indicado** por ela: a equipe vê quem trouxe quem, a comunidade pode dar pontos e badges por indicação e disparar workflows quando alguém indica.

## Para que serve

| Comunidade | Como usa |
|---|---|
| Comunidade que cresce no boca a boca | Liga a indicação e acompanha quem mais traz gente nova |
| Comunidade com gamificação | Dá pontos pela ação **Indicar membro** e um badge para quem indica 5 pessoas |
| Programa de embaixadores | Um workflow com **Indicou alguém** manda uma DM de agradecimento e põe a pessoa no grupo *Embaixadores* |

## Quem pode

| Papel | O que faz |
|---|---|
| Proprietário e administrador | Ligam e desligam a indicação; veem o relatório e o **Indicado por** de cada membro |
| Moderador | Vê o relatório e o **Indicado por** |
| Financeiro | Não vê o relatório nem quem indicou quem (é dado pessoal, fora do financeiro) |
| Membro | Pega o próprio link e vê quantas pessoas indicou |

## Onde fica

| Quem | Onde |
|---|---|
| Proprietário e administrador | **Configurações › Acesso e cadastro**, card **Indicação**: o botão liga e desliga, e **Ver o relatório de indicações** abre o relatório |
| Proprietário, administrador e moderador | **Membros › Indicações**: cada pessoa que indicou, com **Membro**, **Indicações** e **Última**, o **Período** (**30 dias**, **90 dias** ou **Tudo**) e **Baixar CSV**. Na página de outro membro, o card **Indicado por** (*"Só a equipe vê."*) |
| Membro | **Minha Conta › Indicar** e a própria página: o card **Indique a comunidade**, com o link, **Copiar** e quantas pessoas entraram por ele. Aparece só com a indicação ligada |

Quem abre o link e se cadastra pelo app conta como indicado: o app guarda o código por 30 dias, e o gatilho **Indicou alguém** está no editor de [workflows](/notificacoes/workflows).

## Como funciona

### Ligar

A indicação nasce **desligada**. Ligada, cada membro tem um código próprio, criado na primeira vez que ele pede o link, e o link é o endereço da comunidade com `?ref=` e o código (`https://suacomunidade.memberfy.net/?ref=ana7k2`). Desligada, ninguém tem link, e um código recebido não conta.

### Quando a indicação conta

A indicação conta **uma vez**, quando a pessoa indicada **vira membro**, e só se:

- a indicação está ligada na comunidade naquele momento;
- o código é de um membro ativo **desta** comunidade;
- quem entra não é a própria pessoa que indicou (nem pelo perfil, nem pelo e-mail);
- quem entra **nunca teve perfil** nesta comunidade antes;
- o link foi aberto há no máximo **30 dias**.

O código **nunca impede** um cadastro nem abre a comunidade para quem não poderia entrar: o cadastro segue as regras de sempre (ver [Cadastro e entrada](/membros/cadastro-e-entrada)). Numa comunidade com aprovação de cadastro, o código espera junto com o pedido e conta quando o pedido é aprovado.

### O que acontece numa indicação

- A pessoa nova fica com a origem **Indicação**, que aparece no cartão de crescimento do [Dashboard](/membros/dashboard), entre as origens dos novos membros dos últimos 7 dias.
- Quem indicou faz a ação **Indicar membro** da [gamificação](/membros/gamificacao): vale **0 ponto** por padrão (a comunidade escolhe quanto) e conta para as regras de badge e os requisitos de nível com essa ação.
- Sai o evento **Indicou alguém**, sobre quem indicou, com o nome de quem entrou: gatilho de [workflow](/notificacoes/workflows) (com a variável `referred.name`) e [webhook](/api/eventos-de-webhook) `member.referred`.

### O relatório

Para o proprietário, o administrador e o moderador: cada pessoa que indicou, com quantas indicações e a data da última, e o total, num período. Sai também em CSV. Quem saiu da comunidade continua no relatório, marcado como removido.

## Exemplo

A comunidade liga a indicação e dá 50 pontos para **Indicar membro**. A Ana pega o link e manda para o Bruno, que abre o link, se cadastra no dia seguinte e vira membro. A Ana ganha 50 pontos, o Bruno aparece com a origem **Indicação**, e o workflow com **Indicou alguém** manda à Ana: *"Obrigado por trazer o Bruno!"*.

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| A indicação não contou | Confira se a indicação estava ligada, se a pessoa nunca teve perfil na comunidade e se o link foi aberto há menos de 30 dias |
| A pessoa indicou a si mesma com outro cadastro | Não conta: o mesmo e-mail ou o mesmo perfil é recusado como indicação |
| Indicação não deu pontos | A ação **Indicar membro** vale 0 por padrão; mude o valor nas regras de pontos da [gamificação](/membros/gamificacao) |

## Perguntas frequentes

**O indicado sabe quem o indicou?**
Não por aqui. Quem indicou aparece só para a equipe (proprietário, administrador e moderador).

**Desligar apaga as indicações?**
Não. As indicações que já contaram ficam; só param de contar novas.

**Dá para indicar alguém para uma comunidade paga?**
Sim. O link leva à comunidade, e a pessoa entra pelas regras de sempre, inclusive a compra. A indicação conta quando ela vira membro.

## Na API

`GET` e `PUT /api/referrals/settings` (proprietário e administrador; os outros papéis recebem `403`) ligam e desligam (`enabled`). `GET /api/referrals/me` (qualquer membro) devolve `enabled`, `code`, `path` (`/?ref=<código>`) e `count`. `GET /api/referrals/report` (proprietário, administrador e moderador; o financeiro recebe `403`) traz, por pessoa, `memberId`, `name`, `avatarUrl`, `removed`, `count` e `lastReferredAt`, com `totals`, paginação, `from`/`to` e `format=csv`.

No cadastro, `POST /api/auth/register` e `POST /api/auth/signup-request` aceitam `referralCode` e `referralSeenAt` (quando o link foi aberto; mais de 30 dias, ignorado). `GET /api/members/{id}` traz `referredBy` (`memberId`, `name`, `avatarUrl`, `removed`, `referredAt`) no perfil de outra pessoa, só para proprietário, administrador e moderador, e `source` pode ser `REFERRAL`. O cartão de crescimento do Dashboard traz `extra.bySource`. Ver [Referrals](/api/referencia/referrals) na Referência da API.

## Pelo assistente (MCP)

Peça ao assistente o seu link (*"qual é o meu link de indicação?"*, [`get_my_referral`](/mcp/ferramentas-membros#get-my-referral)), o relatório (*"quem mais trouxe membros novos este mês?"*, [`get_referral_report`](/mcp/ferramentas-membros#get-referral-report), para o proprietário, o administrador e o moderador) ou para ligar a indicação ([`update_referral_settings`](/mcp/ferramentas-membros#update-referral-settings)). Quem indicou um membro aparece em [`get_member`](/mcp/ferramentas-membros#get-member).

## Relacionados

- [Convidar membros](/membros/convidar-membros)
- [Cadastro e entrada](/membros/cadastro-e-entrada)
- [Gamificação](/membros/gamificacao)
- [Workflows](/notificacoes/workflows)
- [Eventos de webhook](/api/eventos-de-webhook)