Indicação de membros

A indicação de membros dá a cada pessoa da comunidade uma ligação própria para convidar outras. Quem entra pela ligação fica registado como indicado por ela: a equipa vê quem trouxe quem, a comunidade pode dar pontos e badges por indicação e disparar workflows quando alguém indica.

#Para que serve

#Quem pode

#Onde fica

Quem abre a ligação e se regista pela aplicação conta como indicado: a aplicação guarda o código durante 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 pede a ligação, e a ligação é o endereço da comunidade com ?ref= e o código (https://suacomunidade.memberfy.net/?ref=ana7k2). Desligada, ninguém tem ligação, e um código recebido não conta.

#Quando a indicação conta

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

• a indicação estiver ligada na comunidade nesse momento;
• o código for de um membro ativo desta comunidade;
• quem entra não for a própria pessoa que indicou (nem pelo perfil, nem pelo e-mail);
• quem entra nunca tiver tido perfil nesta comunidade;
• a ligação tiver sido aberta há 30 dias, no máximo.

O código nunca impede um registo nem abre a comunidade a quem não poderia entrar: o registo segue as regras de sempre (ver Registo e entrada). Numa comunidade com aprovação de registo, 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 pontos por predefiniçã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 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. Também sai em CSV. Quem saiu da comunidade continua no relatório, marcado como removido.

#Exemplo

A comunidade liga a indicação e dá 50 pontos por Indicar membro. A Ana obtém a ligação e envia-a ao Bruno, que a abre, se regista no dia seguinte e passa a membro. A Ana ganha 50 pontos, o Bruno aparece com a origem Indicação, e o workflow com Indicou alguém envia à Ana: "Obrigado por trazer o Bruno!".

#Erros comuns e como resolver

#Perguntas frequentes

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

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

É possível indicar alguém para uma comunidade paga? Sim. A ligação leva à comunidade, e a pessoa entra pelas regras de sempre, incluindo a compra. A indicação conta quando ela passa a 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 registo, POST /api/auth/register e POST /api/auth/signup-request aceitam referralCode e referralSeenAt (quando a ligação foi aberta; 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 a sua ligação ("qual é a minha ligação 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.

#Relacionados

• Convidar membros
• Registo e entrada
• Gamificação
• Workflows
• Eventos de webhook