# Mitglieder empfehlen

> Jedes Mitglied bekommt einen Empfehlungslink; wer darüber beitritt, zählt einmal als empfohlen, und das Team sieht, wer wen gebracht hat. Ein- und ausschalten, die Regeln, wann eine Empfehlung zählt, die Punkte, die Workflows und der Bericht.

Mit **Mitglieder empfehlen** bekommt jede Person der Community einen eigenen Link, um andere einzuladen. Wer über den Link beitritt, wird als von ihr **empfohlen** gespeichert: Das Team sieht, wer wen gebracht hat, die Community kann Punkte und Badges für Empfehlungen vergeben und Workflows auslösen, wenn jemand empfiehlt.

## Wofür

| Community | So nutzt sie es |
|---|---|
| Community, die durch Mundpropaganda wächst | Schaltet die Empfehlung ein und verfolgt, wer die meisten neuen Leute bringt |
| Community mit Gamification | Gibt Punkte für die Aktion **Mitglied empfehlen** und ein Badge für alle, die 5 Personen empfehlen |
| Botschafterprogramm | Ein Workflow mit **Hat jemanden empfohlen** schickt eine Dankes-DM und setzt die Person in die Gruppe *Botschafter* |

## Wer darf

| Rolle | Was sie tut |
|---|---|
| Eigentümer und Administrator | Schalten die Empfehlung ein und aus; sehen den Bericht und das **Empfohlen von** jedes Mitglieds |
| Moderator | Sieht den Bericht und das **Empfohlen von** |
| Finanzen | Sieht weder den Bericht noch, wer wen empfohlen hat (personenbezogene Daten, außerhalb der Finanzen) |
| Mitglied | Holt sich den eigenen Link und sieht, wie viele Personen es empfohlen hat |

## Wo es ist

| Wer | Wo |
|---|---|
| Eigentümer und Administrator | **Einstellungen › Zugang und Registrierung**, Karte **Empfehlungen**: der Schalter schaltet sie ein und aus, und **Empfehlungsbericht ansehen** öffnet den Bericht |
| Eigentümer, Administrator und Moderator | **Mitglieder › Empfehlungen**: jede Person, die empfohlen hat, mit **Mitglied**, **Empfehlungen** und **Zuletzt**, der **Zeitraum** (**30 Tage**, **90 Tage** oder **Gesamt**) und **CSV herunterladen**. Auf der Seite eines anderen Mitglieds die Karte **Empfohlen von** (*"Nur das Team sieht das."*) |
| Mitglied | **Mein Konto › Empfehlen** und die eigene Seite: die Karte **Community weiterempfehlen**, mit dem Link, **Kopieren** und wie viele Personen darüber gekommen sind. Nur sichtbar, solange Empfehlungen eingeschaltet sind |

Wer den Link öffnet und sich in der App registriert, zählt als empfohlen: die App behält den Code 30 Tage, und der Auslöser **Hat jemanden empfohlen** ist im [Workflow](/notificacoes/workflows)-Editor.

## So funktioniert es

### Einschalten

Die Empfehlung ist zu Beginn **ausgeschaltet**. Eingeschaltet hat jedes Mitglied einen eigenen Code, der beim ersten Abruf des Links entsteht, und der Link ist die Adresse der Community mit `?ref=` und dem Code (`https://deinecommunity.memberfy.net/?ref=ana7k2`). Ausgeschaltet hat niemand einen Link, und ein erhaltener Code zählt nicht.

### Wann die Empfehlung zählt

Die Empfehlung zählt **einmal**, wenn die empfohlene Person **Mitglied wird**, und nur wenn:

- die Empfehlung in der Community in diesem Moment eingeschaltet ist;
- der Code einem aktiven Mitglied **dieser** Community gehört;
- wer beitritt, nicht die empfehlende Person selbst ist (weder über das Profil noch über die E-Mail);
- wer beitritt, in dieser Community **noch nie ein Profil hatte**;
- der Link vor höchstens **30 Tagen** geöffnet wurde.

Der Code **verhindert nie** eine Registrierung und öffnet die Community nicht für jemanden, der nicht hineindürfte: Die Registrierung folgt den üblichen Regeln (siehe [Registrierung und Zugang](/membros/cadastro-e-entrada)). In einer Community mit Freigabe der Registrierung wartet der Code mit der Anfrage und zählt, wenn die Anfrage genehmigt wird.

### Was bei einer Empfehlung passiert

- Die neue Person bekommt die Herkunft **Empfehlung**, die in der Wachstumskarte des [Dashboards](/membros/dashboard) unter den Herkünften der neuen Mitglieder der letzten 7 Tage erscheint.
- Die empfehlende Person führt die Aktion **Mitglied empfehlen** der [Gamification](/membros/gamificacao) aus: Sie ist standardmäßig **0 Punkte** wert (die Community legt fest, wie viel) und zählt für die Badge-Regeln und Level-Anforderungen mit dieser Aktion.
- Es entsteht das Ereignis **Hat jemanden empfohlen**, über die empfehlende Person, mit dem Namen der beigetretenen Person: Auslöser für [Workflows](/notificacoes/workflows) (mit der Variable `referred.name`) und [Webhook](/api/eventos-de-webhook) `member.referred`.

### Der Bericht

Für Eigentümer, Administrator und Moderator: jede Person, die empfohlen hat, mit der Zahl der Empfehlungen und dem Datum der letzten, und die Summe, für einen Zeitraum. Auch als CSV. Wer die Community verlassen hat, bleibt im Bericht, als entfernt markiert.

## Beispiel

Die Community schaltet die Empfehlung ein und gibt 50 Punkte für **Mitglied empfehlen**. Ana holt sich den Link und schickt ihn an Bruno, der den Link öffnet, sich am nächsten Tag registriert und Mitglied wird. Ana bekommt 50 Punkte, Bruno erscheint mit der Herkunft **Empfehlung**, und der Workflow mit **Hat jemanden empfohlen** schickt Ana: *„Danke, dass du Bruno mitgebracht hast!“*.

## Häufige Fehler und Lösungen

| Situation | Was tun |
|---|---|
| Die Empfehlung hat nicht gezählt | Prüfe, ob die Empfehlung eingeschaltet war, ob die Person nie ein Profil in der Community hatte und ob der Link vor weniger als 30 Tagen geöffnet wurde |
| Die Person hat sich mit einer anderen Registrierung selbst empfohlen | Zählt nicht: dieselbe E-Mail oder dasselbe Profil wird als Empfehlung abgelehnt |
| Die Empfehlung hat keine Punkte gegeben | Die Aktion **Mitglied empfehlen** ist standardmäßig 0 wert; ändere den Wert in den Punkteregeln der [Gamification](/membros/gamificacao) |

## Häufige Fragen

**Weiß die empfohlene Person, wer sie empfohlen hat?**
Nicht hierüber. Wer empfohlen hat, sieht nur das Team (Eigentümer, Administrator und Moderator).

**Löscht das Ausschalten die Empfehlungen?**
Nein. Bereits gezählte Empfehlungen bleiben; es zählen nur keine neuen mehr.

**Kann man jemanden für eine kostenpflichtige Community empfehlen?**
Ja. Der Link führt zur Community, und die Person tritt nach den üblichen Regeln bei, auch mit Kauf. Die Empfehlung zählt, wenn sie Mitglied wird.

## In der API

`GET` und `PUT /api/referrals/settings` (Eigentümer und Administrator; die anderen Rollen bekommen `403`) schalten ein und aus (`enabled`). `GET /api/referrals/me` (jedes Mitglied) liefert `enabled`, `code`, `path` (`/?ref=<code>`) und `count`. `GET /api/referrals/report` (Eigentümer, Administrator und Moderator; Finanzen bekommt `403`) liefert pro Person `memberId`, `name`, `avatarUrl`, `removed`, `count` und `lastReferredAt`, mit `totals`, Paginierung, `from`/`to` und `format=csv`.

Bei der Registrierung akzeptieren `POST /api/auth/register` und `POST /api/auth/signup-request` `referralCode` und `referralSeenAt` (wann der Link geöffnet wurde; mehr als 30 Tage, ignoriert). `GET /api/members/{id}` liefert `referredBy` (`memberId`, `name`, `avatarUrl`, `removed`, `referredAt`) im Profil einer anderen Person, nur für Eigentümer, Administrator und Moderator, und `source` kann `REFERRAL` sein. Die Wachstumskarte des Dashboards liefert `extra.bySource`. Siehe [Referrals](/api/referencia/referrals) in der API-Referenz.

## Über den Assistenten (MCP)

Frag den Assistenten nach deinem Link (*„wie lautet mein Empfehlungslink?“*, [`get_my_referral`](/mcp/ferramentas-membros#get-my-referral)), nach dem Bericht (*„wer hat diesen Monat die meisten neuen Mitglieder gebracht?“*, [`get_referral_report`](/mcp/ferramentas-membros#get-referral-report), für Inhaber, Administrator und Moderator) oder lass die Empfehlung einschalten ([`update_referral_settings`](/mcp/ferramentas-membros#update-referral-settings)). Wer ein Mitglied empfohlen hat, steht in [`get_member`](/mcp/ferramentas-membros#get-member).

## Verwandte Artikel

- [Mitglieder einladen](/membros/convidar-membros)
- [Registrierung und Zugang](/membros/cadastro-e-entrada)
- [Gamification](/membros/gamificacao)
- [Workflows](/notificacoes/workflows)
- [Webhook-Ereignisse](/api/eventos-de-webhook)