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.
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). 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, entre as origens dos novos membros dos últimos 7 dias.
- Quem indicou faz a ação Indicar membro da gamificação: 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 (com a variável
referred.name) e webhookmember.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 |
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 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), o relatório ("quem mais trouxe membros novos este mês?", get_referral_report, para o proprietário, o administrador e o moderador) ou para ligar a indicação (update_referral_settings). Quem indicou um membro aparece em get_member.