# Anerkennung

> Das Bereichsmodul Anerkennung im Tab Planung & HR. Die Wand, an der ein Mitglied 1 bis 20 Kolleginnen und Kollegen öffentlich anerkennt, mit optionalem Community-Wert, Reaktionen und Kommentaren; die Community-Werte, die Übersicht des Teams, die Engagement-Punkte und die E-Mail an die Anerkannten. Die Arten (Dankeschön, Willkommen, Meilenstein…), jede mit Motiv und Satz, und eigene Motive der Community.

**Anerkennung** ist eine Wand für Lob unter Kolleginnen und Kollegen, vor dem ganzen Team: Ein Mitglied dankt einer oder mehreren Personen öffentlich für das, was sie getan haben, und wer den Bereich sieht, liest, reagiert und kommentiert. Das Team kann das Lob mit den **Community-Werten** verbinden und **Engagement-Punkte** an die vergeben, die anerkennen, und an die Anerkannten.

Es ist ein [Bereichsmodul](/conceitos/modulos) im Tab **Planung & HR** von **Bereich Hinzufügen**. Eine Community kann **mehrere** Anerkennungsbereiche haben, zum Beispiel eine Wand pro Team oder pro Abteilung, jeweils mit eigenem Publikum; die Werte gehören der ganzen Community und gelten in allen.

## Wozu es dient

| Community | Wie sie es nutzt |
|---|---|
| HR im Unternehmen | Die Community-Werte mit echten Beispielen stärken |
| Coworking | Denen danken, die beim Raumwechsel geholfen oder die Veranstaltung organisiert haben |
| Community of Practice | Sichtbar machen, wer Fragen beantwortet und Neuen geholfen hat |

## Wie es funktioniert

### Wer was tut

| Wer | Was |
|---|---|
| Wer Zugang zum Bereich hat | Sieht die Wand, erkennt an, reagiert und kommentiert |
| Der Autor | Löscht die eigene Anerkennung |
| Das Team (Inhaber, Admin, Moderator und Finanzen) | Löscht jede Anerkennung und jeden Kommentar |
| Inhaber und Admin | Legen die Community-Werte an und sehen die Übersicht |

Wer keinen Zugang zum Bereich hat, sieht die Anerkennungen nicht, weder im Feed noch über die API. Bei mehreren Bereichen bleibt jede Anerkennung in dem Bereich, in dem sie gemacht wurde, und nur wer Zugang zu diesem Bereich hat, sieht sie.

### Jemanden anerkennen

Unter **Anerkennen** fragt das Fenster nach:

- **Wen du anerkennen möchtest**: 1 bis 20 Personen der Community mit Zugang zum Bereich. Niemand erkennt sich selbst an.
- **Community-Wert (optional)**: erscheint nur, wenn es aktive Werte gibt.
- **Nachricht**: bis 500 Zeichen.

Die Anerkennung erscheint an der Wand und im [Feed](/espacos/feed) des Abschnitts, für alle, die den Bereich sehen; im Feed zeigt der Filter **Anerkennungen** nur sie. Jede Karte hat Reaktionen (eine pro Person) und Kommentare mit Antworten, wie ein Beitrag.

### Arten und Motive

Jede Anerkennung hat eine **Art**, und jede Art hat ein Motiv und einen Satz:

| Art | Satz |
|---|---|
| **Dankeschön** (Standard) | *Von Herzen danke* |
| **Willkommen** | *Willkommen im Team* |
| **Meilenstein** | *Meilenstein erreicht* |
| **Auszeichnung** | *Herausragend* |
| **Event-Lob** | *Stark beim Event* |
| **Kurs abgeschlossen** | *Kurs abgeschlossen* |
| **Firmenjubiläum** | *Ein weiteres Jahr mit uns* |

In **Anerkennen** zeigt das Feld **Art** eine Miniatur des Motivs jeder eingeschalteten Art; **Dankeschön** ist vorausgewählt. Anerkennungen von vor den Arten erscheinen als **Dankeschön**.

**Die Karte beginnt mit dem Motiv.** In der Pinnwand und im Feed beginnt die Karte mit dem Motiv der Art, einem breiten Banner im Format 3:1. In der linken Hälfte des Motivs stehen der Satz der Art sowie Fotos und Namen der anerkannten Personen, ein Name pro Zeile (ab drei Personen *"Ana Prado"* und *"Carla Nunes und 3 weitere"*); das Foto der Person, die anerkannt hat, erscheint klein als Abzeichen auf dem Foto der anerkannten Person. Auf einer schmalen Karte (am Handy) stehen Satz und Namen direkt unter dem Motiv. Im Feed ist die Höhe des Motivs begrenzt.

Unter dem Motiv steht ein Satz: *"**David** hat **Ana Prado** für **Zusammenarbeit** anerkannt"* (ohne Wert entfällt das *"für…"*); der Name der Person, die anerkannt hat, führt zu ihrer Seite. In der Zeile darunter, wie lange es her ist und in welchem Bereich. Die Nachricht steht als Zitat, mit einem Balken in der Farbe der Community. Zuletzt die Reaktionen, **Kommentieren**, **Karte** und, für wen es erlaubt ist, **Auf LinkedIn posten**.

**Die Pinnwand** hat zwei Spalten, wenn genug Platz ist (zum Beispiel auf einem Computerbildschirm ab 1280 px), und eine Spalte am Handy. Karten in derselben Reihe sind gleich hoch, mit den Aktionen unten, und die Nachricht zeigt bis zu 4 Zeilen, mit **Mehr anzeigen** für den Rest (und **Weniger anzeigen** zum Einklappen).

**Die Standardmotive** sind die 3D-Bilder von Memberfy, eines pro Art, in allen Communities gleich: Sie ändern sich nicht mit den Farben der Community.

**Arten einrichten.** *Rolle: Owner oder Admin.* Im Seitenmenü über das **…** des Bereichs **Bereich bearbeiten** öffnen und zu **Arten und Motive** scrollen. Die Einstellung *"Gilt für alle Anerkennungsbereiche der Community."* Jede Art zeigt ihr aktuelles Motiv, ihren Satz und einen Schalter zum Ein- und Ausschalten; jede Änderung wird sofort gespeichert.

- **Ein- und ausschalten**: Eine ausgeschaltete Art verschwindet aus **Anerkennen**; ihre älteren Anerkennungen behalten das Motiv. Mindestens eine Art bleibt eingeschaltet (*"Mindestens eine Anerkennungsart muss eingeschaltet bleiben."*).
- **Eigenes Motiv hochladen**: PNG, JPG oder WebP, bis 5 MB, mindestens **1200 px** breit. Empfohlen sind **1800×600** (3:1), mit dem Motiv rechts und der linken Hälfte frei: Dort stehen Satz und Name. Das Bild wird mittig auf 3:1 zugeschnitten; die **Vorschau** zeigt das Motiv rechtsbündig, mit dem Satz und einem Beispielnamen links, bevor du **Motiv speichern** klickst. Auf einem eigenen Motiv bekommt der Textbereich einen leichten Schatten (und einen hellen Schleier, wenn das Motiv zu dunkel ist, um den Text zu lesen). Ein eigenes Motiv gilt auch für ältere Anerkennungen dieser Art. **Motiv ersetzen** tauscht das aktuelle aus.
- **Zurück zum Standard**: löscht das eigene Motiv, und die Art nutzt wieder das Standardmotiv, bei allen Anerkennungen, auch älteren.

**Auf der Karte und in der E-Mail.** Die **Karte** ist ein PNG mit 1200 px Breite, das die Karte der App wiedergibt: oben das Motiv in 3:1 mit Satz, Fotos und Namen (einer pro Zeile) links; darunter *"X hat Y für {Wert} anerkannt"*, der Tag, die Nachricht als Zitat und das Logo der Community. Die Höhe folgt dem Inhalt, zwischen 1,91:1 und 1:1,25: Eine einzeilige Nachricht ergibt 1200×764, eine lange Nachricht geht bis zu 8 Zeilen und endet mit *"…"*. Die E-Mail *Du wurdest anerkannt* zeigt Motiv und Satz der Art ganz oben.

**In Workflows.** Der Auslöser für eine erhaltene Anerkennung (`recognition.received`) liefert die Art im optionalen Feld `type` (`APPRECIATION`, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` oder `WORK_ANNIVERSARY`). Siehe [Workflows](/notificacoes/workflows).

### Die E-Mail an die Anerkannten

Jede anerkannte Person bekommt eine E-Mail mit dem Autor, der Nachricht und der Schaltfläche zur Anerkennung, in ihrer Sprache und in der Farbe der Community. Die E-Mail gehört zur Kategorie **Anerkennungen**, standardmäßig an; wer sie unter [E-Mails dieser Community](/notificacoes/emails-desta-comunidade) ausgeschaltet hat, bekommt sie nicht, und die Fußzeile schaltet mit einem Klick nur diese Kategorie aus. Der Hinweis geht 10 Minuten später raus und zählt zum Limit von 3 Hinweisen pro Person und Tag. Der Rest der Community bekommt keine E-Mail.

### Die Community-Werte

Die Werte (zum Beispiel *Zusammenarbeit*, *Verantwortung*, *Kunde im Mittelpunkt*) sind **optional**. Inhaber und Admin legen sie beim Anlegen des Bereichs oder später an, unter **Anerkennungen verwalten › Community-Werte**: Name (bis 80 Zeichen), optionale Beschreibung (bis 300), Reihenfolge und ob er **aktiv** ist. Bis zu 30. Ein gespeicherter Wert lässt sich nicht löschen: **Deaktiviere** ihn, um ihn aus der Auswahl zu nehmen; Anerkennungen, die ihn schon nutzen, zeigen ihn weiter. Ohne aktive Werte erscheint das Feld beim Anerkennen nicht.

Die Werte gehören der **Community**: Dieselbe Liste gilt in allen Anerkennungsbereichen, und was du in einem änderst, ändert sich in allen. Das Werte-Fenster sagt es: *"Die Werte gehören der Community: Dieselbe Liste gilt in allen Anerkennungs-Bereichen."*

### Die Übersicht

Die Leiste **Anerkennungen verwalten**, für Inhaber und Admin, zeigt die Anerkennungen der letzten 30 Tage und öffnet die **Übersicht**: für den gewählten Zeitraum (bis 366 Tage, in der Zeitzone der Community) **Anerkennungen**, **Personen, die anerkannt haben** und **Anerkannte Personen**. Bei mehreren Bereichen zeigen die Leiste und das Dashboard den geöffneten Bereich.

### Engagement-Punkte

Unter **Mitglieder › Gamification** gibt es zwei neue Aktionen: **Eine Kollegin oder einen Kollegen anerkennen** (für den Autor) und **Anerkannt werden** (für jede anerkannte Person). Beide starten bei **0**: Sie zählen nur, wenn der Inhaber ihnen Punkte gibt. Damit niemand durch Masse oder Absprache aufsteigt:

- wer anerkennt, bekommt die Punkte für **höchstens 3 Anerkennungen pro Tag**;
- wer anerkannt wird, bekommt die Punkte **einmal pro Woche und Autor** (dieselbe Person, die dieselbe Person innerhalb von 7 Tagen erneut anerkennt, zählt nicht noch einmal).

Über dem Limit wird die Anerkennung ganz normal veröffentlicht, nur ohne Punkte. Das Löschen einer Anerkennung nimmt genau die Punkte zurück, die sie gegeben hat. Die Tage folgen der Zeitzone der Community. Siehe [Engagement](/espacos/ranking) und [Gamification](/membros/gamificacao). Die Limits zählen die Anerkennungen aller Bereiche zusammen.

### Nach Wert filtern und zählen

Auf der Wand zeigt **Nach Wert filtern** nur die Anerkennungen eines Community-Werts oder die **Ohne Wert**; **Alle anzeigen** führt zur ganzen Wand zurück. Alle mit Zugang zum Bereich nutzen den Filter.

In der **Übersicht** zeigt der Block **Nach Wert**, wie viele Anerkennungen jeder Wert im Zeitraum bekommen hat (und die ohne Wert), und die 5 am häufigsten anerkannten Personen je Wert. Ein deaktivierter Wert mit Anerkennungen im Zeitraum erscheint weiter, markiert als *inaktiv*.

### Die Karte zum Teilen

Auf der Karte der Anerkennung lädt **Karte** ein PNG-Bild mit den Farben und dem Logo der Community herunter, mit der anerkennenden Person, den Anerkannten, dem Wert und der Nachricht, zum Teilen außerhalb der Community. Die Karte enthält keine E-Mail und nichts über das hinaus, was die Wand schon zeigt.

Die Schaltfläche erscheint für die Person, die anerkannt hat, für die Anerkannten und für das Team (Eigentümer, Administrator, Moderator und Finanzen). Eine gelöschte Anerkennung erzeugt keine Karte (*„Diese Anerkennung ist nicht mehr verfügbar."*).

### Auf LinkedIn posten

Die LinkedIn-Schaltfläche neben **Karte** erscheint nur für die Person, **die anerkannt hat**, und für die **Anerkannten**. Das Team kann die Karte anderer weiterhin herunterladen, postet aber nicht die Anerkennung einer anderen Person.

- **Am Handy** öffnet sie das Teilen-Menü des Systems mit dem Bild der Karte und dem fertigen Text; du wählst nur noch LinkedIn.
- **Am Computer** lädt sie die Karte herunter, kopiert den Text und öffnet LinkedIn in einem neuen Tab: *„Karte heruntergeladen und Text kopiert. Füge auf LinkedIn den Text ein und hänge das Bild an."* Blockiert der Browser den Tab, bringt der Hinweis den Link **LinkedIn öffnen**.

Der Text hängt davon ab, wer postet. Anerkannte Person: *„Ich habe eine Anerkennung von {Absender} in der Community {Community} erhalten: „{Satz}“"*. Absender: *„Ich habe {Namen} in der Community {Community} anerkannt: „{Satz}“"*.

## Schritt für Schritt

### Den Bereich anlegen

1. Öffne im Menü **Bereich Hinzufügen** und wähle den Tab **Planung & HR**.
2. Wähle **Anerkennung** und klicke auf **Weiter**. Die Frage "einer oder mehrere" gibt es nicht.
3. Gib Name, Symbol und Zugang an, wie bei jedem Bereich. Wenn du willst, lege gleich die Community-Werte an.
4. Für eine Wand pro Team oder pro Abteilung leg einen weiteren Anerkennungsbereich an und gib ihm das passende Publikum. Die schon angelegten Community-Werte gelten auch dort.

### Jemanden anerkennen

1. Öffne den Bereich und klicke auf **Anerkennen**.
2. Gib den Namen einer oder mehrerer Personen ein, wähle einen Wert (falls vorhanden) und schreib die Nachricht.
3. Klicke auf **Anerkennen**. Die Karte erscheint oben an der Wand.

## Beispiel

Die Support-Leiterin erkennt Ana und Bruno mit dem Wert *Kunde im Mittelpunkt* an: *"Sie haben das Integrationsproblem an einem Samstag gelöst, ohne dass jemand gefragt hat."* Das Team reagiert mit 👏 und kommentiert. Mit 5 Punkten für das Anerkennen und 10 für **Anerkannt werden** bekommt die Leiterin 5 und die beiden je 10. Ana und Bruno bekommen die E-Mail.

## Mit dem Assistenten (MCP)

Es gibt 14 Tools: die Wand listen (`list_recognitions`, mit Filter nach Person), eine Anerkennung mit Kommentaren öffnen, suchen, wer anerkannt werden kann, **anerkennen** (`create_recognition`, mit `dry_run`, um vorher zu sehen, wer die E-Mail bekommt), reagieren, kommentieren, die Werte sehen und eine Anerkennung oder einen Kommentar löschen, mit Bestätigung. Inhaber und Admin legen außerdem Werte an, bearbeiten, ordnen und deaktivieren sie und sehen die Übersicht. Siehe [Tools · Mitglieder › Anerkennung](/mcp/ferramentas-membros#anerkennung). Bei mehr als einem Anerkennungsbereich fragt der Assistent, in welchem (`space_id`), wenn er anerkennt und Personen sucht; die Liste ohne `space_id` fasst die Bereiche zusammen, die die Person öffnet, und das Dashboard ohne `space_id` zählt alle zusammen.

`list_recognitions` filtert nach Wert (`value`: Name, ID oder `none` für die ohne Wert), `get_recognition_dashboard` bringt den Block nach Wert, und `get_recognition_card` gibt die Karte als Bild an alle zurück, die sie herunterladen dürfen. Jede Anerkennung bringt `hasCustomArt`, `canShare` (darf die Karte abrufen) und `canPostToLinkedIn` (nur Autor und Anerkannte): Der Assistent schlägt LinkedIn nur vor, wenn das wahr ist.

**Arten und Motive**. `list_recognition_types` listet für alle, die den Bereich öffnen, die sieben Arten mit Bezeichnung, Satz, Motiv und ob sie eingeschaltet sind. `create_recognition` nimmt `type` an (`appreciation`, `welcome`, `milestone`, `award`, `event`, `graduation` oder `work_anniversary`; ohne Angabe Dankeschön), und der `dry_run` zeigt Art, Satz und Motiv; `list_recognitions` filtert nach `type`; `get_recognition` liefert Art und Motiv. Owner und Admin schalten Arten mit `update_recognition_type` ein und aus (Ausschalten fragt nach Bestätigung), laden mit `upload_recognition_type_art` ein eigenes Motiv hoch (per URL oder Bild; das erste eigene Motiv einer Art geht direkt hoch, das Ersetzen eines vorhandenen eigenen Motivs fragt nach Bestätigung) und kehren mit `remove_recognition_type_art` zum Standard zurück (fragt nach Bestätigung). Ein eigenes Motiv ist 3:1, mindestens 1200 px breit; ohne eigenes Motiv ist `artUrl` das Standardmotiv der Art, in allen Communities gleich.

## Häufige Fehler und Lösungen

| Situation | Warum | Was tun |
|---|---|---|
| Ich finde die Person beim Anerkennen nicht | Sie hat keinen Zugang zum Bereich, oder du bist es | Den Zugang des Bereichs ändern |
| Das Wertefeld erscheint nicht | Es gibt keinen aktiven Wert | Unter **Community-Werte** einen anlegen oder aktivieren |
| Niemand hat Punkte bekommen | Beide Aktionen stehen auf 0 | Punkte unter **Mitglieder › Gamification** vergeben |
| *"Wähle den Anerkennungs-Bereich: Diese Community hat mehr als einen"* (API oder Assistent) | Es gibt mehrere Bereiche, und die Anfrage hat keinen genannt | Gib den Bereich an (`spaceId` in der API, `space_id` beim Assistenten) |

## In der API

Der Bereich ist `module: "recognition"`, und die Community kann mehrere haben. Die Routen liegen unter `/api/recognitions`, mit `X-CommunityId`: `GET` und `POST /api/recognitions`, `GET /api/recognitions/{id}`, `DELETE /api/recognitions/{id}`, `PUT` und `DELETE /api/recognitions/{id}/reaction`, `GET` und `POST /api/recognitions/{id}/comments`, `DELETE /api/recognitions/{id}/comments/{commentId}`, `GET /api/recognitions/people`, `GET /api/recognitions/dashboard` (`from`, `to`, `spaceId`) und die Werte unter `GET` und `POST /api/recognitions/values`, `PUT /api/recognitions/values/{valueId}` und `PUT /api/recognitions/values/order`. Im Feed ist der Typ `recognition`; beim Engagement sind die Aktionen `GIVE_RECOGNITION` und `RECEIVE_RECOGNITION`.

**Mehrere Bereiche**: `GET` und `POST /api/recognitions`, `/people`, `/values` und `/dashboard` akzeptieren `spaceId`. Bei nur einem Bereich ist es optional, und nichts ändert sich; bei mehreren gibt Anlegen und Personensuche ohne es `422` (`spaceRequired`) zurück. Listen ohne `spaceId` fassen die Bereiche zusammen, die die Person öffnet, und jede Anerkennung trägt ihre `spaceId`; das Dashboard ohne `spaceId` zählt alle zusammen und gibt `spaceId: null` zurück. Die Routen per ID prüfen den Bereich der Anerkennung selbst. Die Werte sind in jedem Bereich dieselben.

| Fehler | Wann |
|---|---|
| `403` | Kein Zugang zum Bereich, die Anerkennung einer anderen Person löschen, ohne im Team zu sein, Werte oder Übersicht ohne Inhaber oder Admin zu sein |
| `404` | Es gibt keinen Anerkennungsbereich, die `spaceId` ist keiner davon, oder die Anerkennung existiert nicht (oder gehört zu einem gelöschten Bereich) |
| `422` | Sich selbst anerkennen, mehr als 20 Personen, eine Person ohne Zugang zum Bereich oder aus einer anderen Community, Nachricht über 500 Zeichen, oder keine `spaceId` in einer Community mit mehreren Bereichen (`spaceRequired`) |

**Nach Wert und Karte**: `GET /api/recognitions` nimmt `valueId` an (eine ID oder `none`); `GET /api/recognitions/dashboard` bringt `byValue` (jeder Wert mit `recognitions` und `topPeople`); `GET /api/recognitions/{id}/card` gibt das PNG zurück, mit `403` (`cardDenied`) für alle, die nicht anerkannt haben, nicht anerkannt wurden und nicht zum Team gehören, und `404` für eine gelöschte Anerkennung. Jede Anerkennung bringt `canDownloadCard`, `canShare` (die Regel der Karte), `canPostToLinkedIn` (`canShare` und die anfragende Person ist Autor oder eine der Anerkannten) und `hasCustomArt` (das Motiv ist das eigene der Community). Die Karte ist 1200 px breit und so hoch wie ihr Inhalt (von 1200×629 bis 1200×1500).

**Arten und Motive**: `POST /api/recognitions` nimmt `type` an (`APPRECIATION`, der Standard, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` oder `WORK_ANNIVERSARY`), und `GET /api/recognitions` filtert nach `type`. Jede Anerkennung trägt in der Pinnwand und im Feed `recognitionType`, `typeLabel`, `typePhrase` und `artUrl` (das eigene oder das Standardmotiv, bereits aufgelöst). `GET /api/recognitions/types` listet die Arten für alle, die den Bereich öffnen; `PUT /api/recognitions/types/{type}` schaltet ein und aus, `POST /api/recognitions/types/{type}/art` lädt das Motiv hoch (Feld `art`; das Bild wird auf 1800×600 ohne Metadaten neu gespeichert) und `DELETE /api/recognitions/types/{type}/art` stellt den Standard wieder her, nur Owner und Admin (alle anderen: `403`). Unbekannte oder ausgeschaltete Art beim Anerkennen, Ausschalten der letzten eingeschalteten Art oder ein Motiv in anderem Format, über 5 MB oder unter 1200 px Breite: `400`, mit übersetzter Meldung.

## Verwandte Artikel

- [Feedback](/espacos/feedbacks)
- [Engagement](/espacos/ranking)
- [Gamification](/membros/gamificacao)
- [Module](/conceitos/modulos)
- [E-Mails dieser Community](/notificacoes/emails-desta-comunidade)