# Willkommen der Community

> Die Seiten, die eine neue Person beim ersten Besuch sieht (Text, Video, Regeln zum Akzeptieren und Profilfelder), der verpflichtende oder überspringbare Modus, wer sie durchläuft, und die Ersten Schritte mit bis zu 6 Missionen, Punkten, Badges und Glückwunsch am Ende.

Das **Willkommen** sind die Seiten, die eine neue Person beim ersten Besuch sieht, noch vor der Community: ein Begrüßungstext, das Willkommensvideo, die Regeln zum Lesen und Akzeptieren, die Profilfelder, die die Community kennen möchte. Danach kommen die **Ersten Schritte**, eine Karte mit bis zu 6 Missionen (Profil vervollständigen, ersten Beitrag schreiben, zur ersten Veranstaltung gehen), die sich durch die Nutzung von selbst erfüllen und Punkte und Badges geben können.

**Wo:** unter **Einstellungen › Begrüßung**, für Eigentümer und Administrator.

## Wofür

| Community | So nutzt sie es |
|---|---|
| Community mit Verhaltenskodex | Die erste Seite zeigt die Regeln mit **Gelesen und akzeptiert**; niemand kommt ohne Zustimmung hinein, und die Zustimmung wird mit Datum und Text gespeichert |
| Online-Schule | Ein Willkommensvideo, das bis zum Ende angesehen werden muss, und eine Mission „Schließe die Eröffnungslektion ab" |
| Berufliche Community | Eine Seite fragt Position, Unternehmen und Interessen ab (benutzerdefinierte Felder); die Missionen führen zur ersten Vorstellung im Feed und zur ersten Veranstaltung |
| Offene Community | Überspringbares Willkommen: Wer es eilig hat, geht direkt hinein, und die Karte der Ersten Schritte bleibt im Feed |

## Wer darf

| Rolle | Was sie tut |
|---|---|
| Eigentümer und Administrator | Richten die Seiten, den Modus und die Ersten Schritte ein und sehen, wie viele abgeschlossen, übersprungen haben oder ausstehen |
| Moderator und Finanzen | Filtern die Mitgliederliste nach dem Stand des Willkommens; sie ändern die Einstellungen nicht |
| Mitglied | Durchläuft das Willkommen und sieht die eigene Karte der Ersten Schritte |

Das Team (Eigentümer, Administrator, Moderator und Finanzen) durchläuft das Willkommen **nie** und sieht die Karte der Ersten Schritte nicht.

## So funktioniert es

### Die Seiten

**1 bis 5 Seiten**, in der Reihenfolge, in der die Person sie sieht. Jede Seite hat:

- **Titel** (bis zu 120 Zeichen) und **Text**, mit Formatierung.
- **Video**, optional: **Kein Video**, **Video hochladen** (bis zu 2 GB) oder **YouTube- oder Vimeo-Link**. Nur ein hochgeladenes Video kann **Erst nach dem ganzen Video weiter** haben; bei einem externen Link lässt sich das nicht verlangen.
- **Regeln**, optional: unter **Regeln akzeptieren lassen** der Text der Regeln, eine pro Zeile. Die Person kommt nur weiter mit dem Haken bei **Ich habe die Regeln gelesen und akzeptiere sie**. Die Zustimmung wird mit Datum und dem damals akzeptierten Text gespeichert, auch wenn sich die Regeln später ändern.
- **Profilfelder**, optional: bis zu 20 [benutzerdefinierte Felder](/membros/campos-customizados) pro Seite, mit denselben Prüfungen wie im Profil. Ein Pflichtfeld muss ausgefüllt sein, um weiterzukommen.

Die Person sieht die Seiten der Reihe nach (*Schritt 1 von 3*), mit **Weiter** und auf der letzten **Zur Community**; geht sie zwischendurch, macht sie dort weiter, wo sie aufgehört hat. **Als Mitglied ansehen** zeigt die Seiten so, wie ein neues Mitglied sie sieht, ohne etwas zu speichern.

### Der Modus

| Modus | Was passiert |
|---|---|
| **Pflicht** (Standard) | Die Community bleibt gesperrt, bis die Person die letzte Seite abgeschlossen hat |
| **Überspringbar** | Die Person sieht **Begrüßung überspringen**; wer überspringt, kommt hinein und wird nicht erneut gefragt |

Das Willkommen kommt **vor** *Registrierung vervollständigen* (siehe [Registrierung und Zugang](/membros/cadastro-e-entrada#die-registrierung)): Fehlt danach noch ein Pflichtfeld, folgt das Registrierungsfenster.

### Wer es durchläuft

Beim Einschalten wählst du, ob es auch für bestehende Mitglieder gilt:

- **Nicht markiert** (Standard): Nur Mitglieder, die **ab jetzt** beitreten, durchlaufen es.
- **Auch für bestehende Mitglieder**: Alle Mitglieder durchlaufen es beim nächsten Besuch.

Ausschalten lässt Ausstehende sofort hinein. **Erneutes Einschalten erreicht niemanden, der beigetreten ist, während das Willkommen aus war**: Die Zählung beginnt neu, sobald du es wieder einschaltest, es sei denn, **Auch für bestehende Mitglieder** ist markiert. Wer schon abgeschlossen oder übersprungen hat, wird nie erneut gefragt.

### Erste Schritte

Auf derselben Seite, unter den Seiten, die **Ersten Schritte**: 1 bis **6 Missionen**, jede mit dem Text, der auf der Karte steht (**So steht es auf der Karte**, bis zu 80 Zeichen), und unter **Wenn die Person** einer Aktion, die die Plattform bereits verfolgt:

| Wenn die Person | Erfüllt, wenn sie… |
|---|---|
| **das Profil vervollständigt** | ein Foto hat und alle Pflichtfelder ausgefüllt sind |
| **zum ersten Mal in einem Space postet** | im gewählten Space postet |
| **ein Formular beantwortet** | das gewählte [Formular](/espacos/formularios) beantwortet |
| **sich für ein Event anmeldet** | sich für eine Veranstaltung anmeldet (**Beliebiges Event** oder die gewählte) |
| **einen Kurs abschließt** | den gewählten Kurs abschließt |

- Jede Mission kann **Punkte** (0 bis 10.000, mit eingeschalteter [Gamification](/membros/gamificacao)) und ein **Badge** geben (siehe [Badges](/membros/engajamento#badges)). Wer alle erfüllt, kann ein **Abschluss-Badge** bekommen (**Badge, wenn alle erledigt sind**).
- Die Mission wird **innerhalb von etwa 1 Minute** nach der Aktion markiert, ohne dass die Person etwas tun muss. Die Profil-Mission wird zusätzlich geprüft, wenn die Karte geöffnet wird.
- **Was vor dem Bestehen der Mission getan wurde, zählt nicht.** Ändert sich die Aktion oder das Element einer Mission, beginnt auch ihre Zählung neu; ändern sich nur Titel, Punkte oder Badge, bleibt erfüllt, wer sie schon erfüllt hat.
- Sie gelten für Mitglieder, die nach dem Einschalten der Ersten Schritte beitreten, oder für alle mit **Auch bestehenden Mitgliedern zeigen**.

**Die Karte.** Die Person sieht nach dem Willkommen die Karte **Erste Schritte** mit dem Fortschritt (*2 von 4*) und den Punkten jeder Mission oben in der Feed-Spalte (auch bei ausgeschalteten Widgets) und auf der eigenen Mitgliederseite. Sind alle erfüllt, sieht sie den **Glückwunsch nur einmal**, bekommt das Abschluss-Badge, und die Karte verschwindet. **Ausblenden** blendet die Karte für immer aus, und danach zählt keine Mission mehr.

### Verfolgen

Die Einstellungen zeigen, wie viele Mitglieder das Willkommen **abgeschlossen**, **übersprungen** haben oder **ausstehen**, und bei den Ersten Schritten, wie viele **begonnen** (mindestens eine Mission erfüllt), **abgeschlossen** und **ausgeblendet** haben, mit der Zahl pro Mission.

In der [Mitgliederliste](/membros/gerenciar-membros) nutzt das Team den Filter **Begrüßung** (**Ausstehend**, **Abgeschlossen** oder **Übersprungen**). Die Seite jedes Mitglieds zeigt dem Team den Block **Begrüßung und erste Schritte**, mit dem Stand des Willkommens und dem Fortschritt bei den Missionen.

### Mit Workflows automatisieren

Zwei [Workflow](/notificacoes/workflows)-Auslöser im Block **Mitglieder**:

- **Hat das Willkommen abgeschlossen**: Die Person hat die letzte Seite abgeschlossen. Überspringen löst ihn nicht aus.
- **Hat die ersten Schritte abgeschlossen**: Die Person hat alle Missionen erfüllt, einmal pro Person.

Beide gehen auch an die [Webhooks](/api/eventos-de-webhook).

## Schritt für Schritt

### Willkommen mit Regeln und Video

*Rolle: Eigentümer oder Administrator.*

1. Öffne **Einstellungen › Begrüßung**.
2. Gib **Seite 1** den Titel *Willkommen in der Community*, einen kurzen Text und unter **Video** **Video hochladen**, mit **Erst nach dem ganzen Video weiter**.
3. **Seite hinzufügen**: Setze auf **Seite 2** den Haken bei **Regeln akzeptieren lassen**, schreib die Regeln und wähle die Felder *Position* und *Unternehmen* unter **Profilfelder**.
4. Lass unter **Für das Mitglied** **Pflicht** stehen. Schalte **Begrüßung aktiv** ein und entscheide, ob du **Auch für bestehende Mitglieder** markierst.
5. Prüfe mit **Als Mitglied ansehen** und speichere.

### Erste Schritte mit Abschluss-Badge

1. Schalte auf derselben Seite die **Ersten Schritte** ein und nutze **Mission hinzufügen**: *Vervollständige dein Profil* (**das Profil vervollständigt**, 50 Punkte), *Stell dich im Feed vor* (**zum ersten Mal in einem Space postet**, Space *Vorstellungen*, 50 Punkte) und *Melde dich zum nächsten Treffen an* (**sich für ein Event anmeldet**, **Beliebiges Event**).
2. Wähle unter **Badge, wenn alle erledigt sind** *Pionierin*, entscheide über **Auch bestehenden Mitgliedern zeigen** und speichere.

## Beispiel

Maria tritt der Community bei. Bevor sie einen Space sieht, schaut sie das Video bis zum Ende, akzeptiert die Regeln und füllt *Position* aus. Im Feed findet sie die Karte *Erste Schritte · 0 von 3*. Sie vervollständigt ihr Profil und postet ihre Vorstellung: Innerhalb von etwa 1 Minute zeigt die Karte *2 von 3*, und sie hat 100 Punkte. In der Woche darauf meldet sie sich zu einem Treffen an, sieht den Glückwunsch, bekommt das Badge *Pionierin*, und der Workflow mit **Hat die ersten Schritte abgeschlossen** fügt sie der Gruppe *Aktive Mitglieder* hinzu.

## Häufige Fehler und Lösungen

| Situation | Was tun |
|---|---|
| Ich habe das Willkommen eingeschaltet, und bestehende Mitglieder haben es nicht durchlaufen | Das ist der Standard. Markiere **Auch für bestehende Mitglieder** |
| Ich kann nicht verlangen, dass das Video bis zum Ende angesehen wird | Nur beim hochgeladenen Video möglich; mit einem YouTube- oder Vimeo-Link nicht |
| Ich habe es wieder eingeschaltet, und wer beigetreten ist, während es aus war, hat es nicht durchlaufen | Wieder einschalten gilt nur für neue Beitritte ab dann; markiere **Auch für bestehende Mitglieder** |
| Die Mission wurde nicht markiert | Warte etwa 1 Minute. Prüfe, ob die Aktion im gewählten Space, Formular oder Kurs war und nach dem Anlegen der Mission |
| Die Profil-Mission wird nicht markiert | Es fehlt das Foto oder ein Pflichtfeld des Profils |
| Die Mission hat keine Punkte gegeben | Die [Gamification](/membros/gamificacao) muss eingeschaltet sein |
| Ich kann es ohne Seite (oder Mission) nicht einschalten | Für das Willkommen braucht es mindestens eine Seite, für die Ersten Schritte mindestens eine Mission |

## Häufige Fragen

**Durchläuft das Team das Willkommen?**
Nein. Eigentümer, Administrator, Moderator und Finanzen gehen direkt hinein und sehen die Karte der Ersten Schritte nicht.

**Kann die Person das Willkommen noch einmal sehen?**
Nein: Nach dem Abschließen oder Überspringen wird sie nicht erneut gefragt, auch wenn du die Seiten änderst.

**Muss ich Missionen von Hand markieren?**
Nein. Jede Mission erfüllt sich durch die Nutzung, innerhalb von etwa 1 Minute.

**Kann das Mitglied die Karte ignorieren?**
Es kann sie ausblenden. Sie verschwindet für immer, und die Missionen zählen für diese Person nicht mehr.

## In der API

`GET` und `PUT /api/welcome/settings` (Eigentümer und Administrator; andere Rollen erhalten 403): die Seiten (`screens`, 1 bis 5, mit `title`, `body`, `video` mit `mediaId` und `requireFinish` oder `url`, `rules.text` und `fieldIds`), `mode` (`REQUIRED`, Standard, oder `SKIPPABLE`), `enabled` und `applyToExisting`, mit `stats` (`completed`, `skipped`, `pending`). Die Ersten Schritte laufen über dieselbe Route: `missionsEnabled`, `missionsShowExisting`, `finalBadgeId` und `missions` (1 bis 6, mit `kind` `profile_completed`, `first_post` mit `spaceId`, `form_submitted` mit `formId`, `event_registered` mit optionalem `eventId` oder `course_completed` mit `courseId`, `title`, `points` von 0 bis 10.000 und optionalem `badgeId`), mit `missionStats`. Ein Validierungsfehler kommt als 422 am Feld zurück (`screens[0].title`, `missions[1].spaceId`).

Für die Person selbst (jede Rolle): `GET /api/welcome` (der Stand, `off`, `exempt`, `pending`, `completed` oder `skipped`, die aktuelle Seite und die Seiten), `POST /api/welcome/progress` (schließt die aktuelle Seite ab: `step`, `rulesAccepted`, `videoFinished` und `fields`; eine Seite außer der Reihe gibt 409 zurück) und `POST /api/welcome/skip` (nur im überspringbaren Modus; sonst 409). Die Karte: `GET /api/welcome/missions` (`status` `off`, `exempt`, `active`, `completed` oder `dismissed`, `visible`, `celebrate`, `done` von `total` und die Missionen), `POST /api/welcome/missions/dismiss` und `POST /api/welcome/missions/celebrated` (der Glückwunsch wurde gezeigt).

`GET /auth/me` liefert `welcomePending`. `GET /api/members` filtert mit `welcome=pending|completed|skipped`, und `GET /api/members/{id}` liefert `welcome`, mit `missions`. Die Ereignisse `member.welcome_completed` (`member`, `completedAt`) und `member.onboarding_completed` (`member`, `completedAt` und `missions`, die Zahl der Missionen) gehen an Workflows und Webhooks. Siehe die [API-Referenz](/api/referencia).

## Über den Assistenten (MCP)

Lass dir das Willkommen und die Missionen zeigen oder ändern (*„schalte ein Pflicht-Willkommen mit einer Regelseite ein“*): [`get_welcome_settings`](/mcp/ferramentas-membros#get-welcome-settings) und [`update_welcome_settings`](/mcp/ferramentas-membros#update-welcome-settings), das immer nach Bestätigung fragt. Wer aussteht: [`list_members`](/mcp/ferramentas-membros#list-members) mit `welcome: pending`; der Fortschritt einer Person: [`get_member`](/mcp/ferramentas-membros#get-member).

## Verwandte Artikel

- [Registrierung und Zugang](/membros/cadastro-e-entrada)
- [Benutzerdefinierte Felder](/membros/campos-customizados)
- [Gamification](/membros/gamificacao)
- [Engagement und Badges](/membros/engajamento#badges)
- [Workflows](/notificacoes/workflows)