# Riconoscimenti

> Il modulo di spazio Riconoscimenti, della scheda Pianificazione & HR. La bacheca in cui un membro riconosce in pubblico da 1 a 20 colleghi, con un valore della community facoltativo, reazioni e commenti; i valori della community, il pannello del team, i punti di coinvolgimento e l'e-mail a chi è stato riconosciuto. I tipi (Ringraziamento, Benvenuto, Traguardo…), ognuno con grafica e frase, e le grafiche proprie della community.

**Riconoscimenti** è una bacheca di elogi tra colleghi, sotto gli occhi di tutto il team: un membro ringrazia in pubblico una o più persone per quello che hanno fatto, e chi vede lo spazio legge, reagisce e commenta. Il team può collegare l'elogio ai **valori della community** e dare **punti di coinvolgimento** a chi riconosce e a chi viene riconosciuto.

È un [modulo di spazio](/conceitos/modulos) della scheda **Pianificazione & HR** di **Aggiungi Spazio**. Una community può avere **più** spazi Riconoscimenti, per esempio una bacheca per team o per area, ognuno con il suo pubblico; i valori sono di tutta la community e valgono in tutti.

## A cosa serve

| Community | Come lo usa |
|---|---|
| HR aziendale | Rafforzare i valori della community con esempi reali |
| Coworking | Ringraziare chi ha aiutato nel cambio di sala o ha organizzato l'evento |
| Comunità di pratica | Dare visibilità a chi ha risposto alle domande e aiutato i nuovi |

## Come funziona

### Chi fa cosa

| Chi | Cosa fa |
|---|---|
| Chi ha accesso allo spazio | Vede la bacheca, riconosce colleghi, reagisce e commenta |
| L'autore | Elimina il proprio riconoscimento |
| Il team (proprietario, amministratore, moderatore e finanza) | Elimina qualsiasi riconoscimento o commento |
| Proprietario e amministratore | Registrano i valori della community e vedono il pannello |

Chi non ha accesso allo spazio non vede i riconoscimenti, né nel Feed né tramite l'API. Con più spazi, ogni riconoscimento resta nello spazio in cui è stato fatto e lo vede solo chi ha accesso a quello spazio.

### Riconoscere qualcuno

In **Riconosci**, la finestra chiede:

- **Chi vuoi riconoscere**: da 1 a 20 persone della community con accesso allo spazio. Nessuno riconosce sé stesso.
- **Valore della community (facoltativo)**: compare solo quando ci sono valori attivi.
- **Messaggio**: fino a 500 caratteri.

Il riconoscimento compare nella bacheca e nel [Feed](/espacos/feed) della sezione, per chi vede lo spazio; nel Feed, il filtro **Riconoscimenti** mostra solo quelli. Ogni scheda ha le reazioni (una per persona) e i commenti, con risposte, come in un post.

### Tipi e grafiche

Ogni riconoscimento ha un **tipo**, e ogni tipo ha una grafica e una frase:

| Tipo | Frase |
|---|---|
| **Ringraziamento** (il predefinito) | *Grazie davvero* |
| **Benvenuto** | *Benvenuto nel team* |
| **Traguardo** | *Traguardo raggiunto* |
| **Premio** | *In evidenza* |
| **Celebrazione evento** | *Grande lavoro all'evento* |
| **Corso completato** | *Corso completato* |
| **Anniversario in azienda** | *Un altro anno con noi* |

In **Riconosci**, il campo **Tipo** mostra la miniatura della grafica di ogni tipo attivo, con **Ringraziamento** già selezionato. I riconoscimenti fatti prima dei tipi appaiono come **Ringraziamento**.

**La card si apre con la grafica.** In bacheca e nel Feed, la card inizia con la grafica del tipo, una fascia larga in proporzione 3:1. Nella metà sinistra della grafica ci sono la frase del tipo e le foto e i nomi di chi è stato riconosciuto, un nome per riga (con tre persone o più, *"Ana Prado"* e *"Carla Nunes e altri 3"*); la foto di chi ha riconosciuto compare piccola, come un badge sulla foto di chi ha ricevuto. In una card stretta (sul telefono), la frase e i nomi vanno subito sotto la grafica. Nel Feed, la grafica ha un'altezza limitata.

Sotto la grafica c'è una frase: *"**David** ha riconosciuto **Ana Prado** per **Collaborazione**"* (senza valore, senza il *"per…"*), con il nome di chi ha riconosciuto che porta alla sua pagina. Nella riga sotto, quanto tempo fa e in quale spazio. Il messaggio è una citazione, con una barra nel colore della community. Infine le reazioni, **Commenta**, **Card** e, per chi può, **Pubblica su LinkedIn**.

**La bacheca** è su due colonne quando c'è spazio (su uno schermo da computer da 1280 px, per esempio) e su una colonna sul telefono. Le card di una stessa riga hanno la stessa altezza, con le azioni in basso, e il messaggio mostra fino a 4 righe, con **Mostra di più** per leggere il resto (e **Mostra meno** per richiuderlo).

**Le grafiche predefinite** sono le immagini 3D di Memberfy, una per tipo, uguali in tutte le community: non cambiano con i colori della community.

**Configurare i tipi.** *Ruolo: proprietario o amministratore.* Nel menu laterale, nel **…** dello spazio, **Modifica spazio**, e scendi fino a **Tipi e grafiche**. L'impostazione *"Vale per tutti gli spazi di Riconoscimento della community."* Ogni tipo mostra la grafica attuale, la frase e un interruttore per attivarlo o disattivarlo; ogni modifica viene salvata subito.

- **Attivare e disattivare**: il tipo disattivato esce da **Riconosci**; i suoi riconoscimenti vecchi mantengono la grafica. Almeno un tipo resta attivo (*"Almeno un tipo di riconoscimento deve restare attivo."*).
- **Carica grafica propria**: PNG, JPG o WebP, fino a 5 MB, larga almeno **1200 px**. Il consigliato è **1800×600** (3:1), con il disegno a destra e la metà sinistra libera: lì vanno la frase e il nome. L'immagine viene ritagliata al centro in 3:1; l'**Anteprima** mostra la grafica ancorata a destra, con la frase e un nome di esempio a sinistra, prima di **Salva grafica**. Su una grafica propria, la zona del testo riceve un'ombra leggera (e un velo chiaro quando la grafica è troppo scura per leggere il testo). La grafica propria vale anche per i riconoscimenti vecchi di quel tipo. **Cambia grafica** sostituisce quella attuale.
- **Torna alla predefinita**: elimina la grafica propria, e il tipo torna alla grafica predefinita in tutti i riconoscimenti, anche quelli vecchi.

**Nella Card e nell'e-mail.** La **Card** è un PNG largo 1200 px che riprende la card dell'app: in alto, la grafica in 3:1 con la frase, le foto e i nomi (uno per riga) a sinistra; sotto, *"X ha riconosciuto Y per {valore}"*, il giorno, il messaggio come citazione e il logo della community. L'altezza segue il contenuto, tra 1,91:1 e 1:1,25: un messaggio di una riga dà 1200×764, e un messaggio lungo arriva a 8 righe, finendo con *"…"*. L'e-mail *sei stato riconosciuto* mostra la grafica e la frase del tipo in alto.

**Nei workflow.** Il trigger di riconoscimento ricevuto (`recognition.received`) porta il tipo del riconoscimento nel campo opzionale `type` (`APPRECIATION`, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` o `WORK_ANNIVERSARY`). Vedi [Workflow](/notificacoes/workflows).

### L'e-mail a chi è stato riconosciuto

Ogni persona riconosciuta riceve un'e-mail con l'autore, il messaggio e il pulsante per aprire il riconoscimento, nella sua lingua e con il colore della community. L'e-mail è della categoria **Riconoscimenti**, attiva per impostazione predefinita; chi l'ha disattivata in [E-mail di questa community](/notificacoes/emails-desta-comunidade) non la riceve, e il piè di pagina disattiva solo quella categoria con un clic. L'avviso parte 10 minuti dopo e conta nel limite di 3 avvisi per persona al giorno. Non c'è e-mail per il resto della community.

### I valori della community

I valori (per esempio *Collaborazione*, *Responsabilità del risultato*, *Il cliente al centro*) sono **facoltativi**. Il proprietario e l'amministratore li registrano creando lo spazio o dopo, in **Gestisci riconoscimenti › Valori della community**: nome (fino a 80 caratteri), descrizione facoltativa (fino a 300), l'ordine e se è **attivo**. Fino a 30. Un valore salvato non si elimina: **disattivalo** per toglierlo dalla scelta; i riconoscimenti che già lo usano continuano a mostrarlo. Senza valori attivi, il campo non compare quando si riconosce.

I valori sono **della community**: lo stesso elenco vale in tutti gli spazi Riconoscimenti, e ciò che cambi in uno cambia in tutti. La finestra dei valori lo dice: *"I valori sono della community: lo stesso elenco vale in tutti gli spazi Riconoscimenti."*

### Il pannello

La barra **Gestisci riconoscimenti**, del proprietario e dell'amministratore, mostra i riconoscimenti degli ultimi 30 giorni e apre il **Pannello**: per il periodo scelto (fino a 366 giorni, contati nel fuso orario della community), **Riconoscimenti fatti**, **Persone che hanno riconosciuto** e **Persone riconosciute**. Con più spazi, la barra e la dashboard mostrano lo spazio aperto.

### I punti di coinvolgimento

In **Membri › Gamification**, due nuove azioni: **Riconoscere un collega** (per l'autore) ed **Essere riconosciuti** (per ogni persona riconosciuta). Partono entrambe da **0**: contano solo se il proprietario assegna loro dei punti. Perché nessuno salga in classifica per volume o per accordo:

- chi riconosce guadagna i punti di **Riconoscere un collega** per **al massimo 3 riconoscimenti al giorno**;
- chi viene riconosciuto guadagna i punti di **Essere riconosciuti** **una volta a settimana per ogni autore** (lo stesso collega che riconosce di nuovo la stessa persona entro 7 giorni non conta di nuovo).

Oltre il limite, il riconoscimento viene pubblicato normalmente, solo senza punti. Eliminare un riconoscimento toglie esattamente i punti che ha dato. I giorni seguono il fuso orario della community. Vedi [Coinvolgimento](/espacos/ranking) e [Gamification](/membros/gamificacao). I limiti contano i riconoscimenti di tutti gli spazi insieme.

### Filtrare e contare per valore

Nella bacheca, **Filtra per valore** mostra solo i riconoscimenti di un valore della community, oppure quelli **Senza valore**; **Vedi tutti** torna all'intera bacheca. Chiunque abbia accesso allo spazio usa il filtro.

Nel **Pannello**, il blocco **Per valore** mostra quanti riconoscimenti ha ricevuto ogni valore nel periodo (e quelli senza valore) e le 5 persone più riconosciute in ciascuno. Un valore disattivato con riconoscimenti nel periodo continua a comparire, segnato *inattivo*.

### La card da condividere

Sulla scheda del riconoscimento, **Card** scarica un'immagine PNG con i colori e il logo della community, chi ha riconosciuto, chi è stato riconosciuto, il valore e il messaggio, da condividere fuori dalla community. La card non contiene e-mail né nulla oltre a ciò che la bacheca già mostra.

Il pulsante compare per chi ha dato il riconoscimento, per chi è stato riconosciuto e per il team (proprietario, amministratore, moderatore e finanza). Un riconoscimento eliminato non genera la card (*"Questo riconoscimento non è più disponibile."*).

### Pubblica su LinkedIn

Il pulsante di LinkedIn, accanto a **Card**, compare solo per **chi ha dato** il riconoscimento e per **chi è stato riconosciuto**. Il team continua a scaricare la card degli altri, ma non pubblica il riconoscimento di un'altra persona.

- **Sul telefono**, apre la finestra di condivisione del sistema con l'immagine della card e il testo già pronto; basta scegliere LinkedIn.
- **Sul computer**, scarica la card, copia il testo e apre LinkedIn in una nuova scheda: *"Card scaricata e testo copiato. Su LinkedIn, incolla il testo e allega l'immagine."* Se il browser blocca la scheda, l'avviso porta il link **Apri LinkedIn**.

Il testo cambia in base a chi pubblica. Chi ha ricevuto: *"Ho ricevuto un riconoscimento da {mittente} nella community {community}: “{frase}”"*. Chi ha dato: *"Ho riconosciuto {nomi} nella community {community}: “{frase}”"*.

## Passo passo

### Creare lo spazio

1. Nel menu, apri **Aggiungi Spazio** e scegli la scheda **Pianificazione & HR**.
2. Scegli **Riconoscimenti** e clicca su **Avanti**. Non c'è la domanda "uno o più".
3. Dagli nome, icona e chi ha accesso, come a qualsiasi spazio. Se vuoi, registra subito i valori della community.
4. Per una bacheca per team o per area, crea un altro spazio Riconoscimenti e dagli il pubblico giusto. I valori della community già inseriti valgono anche lì.

### Riconoscere un collega

1. Apri lo spazio e clicca su **Riconosci**.
2. Scrivi il nome di uno o più colleghi, scegli un valore (se c'è) e scrivi il messaggio.
3. Clicca su **Riconosci**. La scheda compare in cima alla bacheca.

## Esempio

La responsabile dell'assistenza riconosce Ana e Bruno con il valore *Il cliente al centro*: *"Hanno risolto il problema dell'integrazione di sabato, senza che nessuno lo chiedesse."* Il team reagisce con 👏 e commenta. Con 5 punti su **Riconoscere un collega** e 10 su **Essere riconosciuti**, la responsabile guadagna 5 e ciascuno dei due 10. Ana e Bruno ricevono l'e-mail.

## Con l'assistente (MCP)

Sono 14 strumenti: elencare la bacheca (`list_recognitions`, con filtro per persona), aprire un riconoscimento con i commenti, cercare chi può essere riconosciuto, **riconoscere** (`create_recognition`, con `dry_run` per vedere prima chi riceve l'e-mail), reagire, commentare, vedere i valori ed eliminare un riconoscimento o un commento, con conferma. Il proprietario e l'amministratore registrano, modificano, riordinano e disattivano anche i valori e vedono il pannello. Vedi [Strumenti · Membri › Riconoscimenti](/mcp/ferramentas-membros#riconoscimenti). Con più di uno spazio Riconoscimenti, l'assistente chiede quale (`space_id`) quando riconosce e cerca persone; l'elenco senza `space_id` unisce gli spazi che la persona apre, e la dashboard senza `space_id` li somma tutti.

`list_recognitions` filtra per valore (`value`: nome, id o `none` per quelli senza valore), `get_recognition_dashboard` porta il blocco per valore e `get_recognition_card` restituisce la card come immagine a chi può scaricarla. Ogni riconoscimento porta `hasCustomArt`, `canShare` (può ottenere la card) e `canPostToLinkedIn` (solo l'autore e chi è stato riconosciuto): l'assistente suggerisce di pubblicare su LinkedIn solo quando è vero.

**Tipi e grafiche.** `list_recognition_types`, per chi apre lo spazio, elenca i sette tipi con etichetta, frase, grafica e se sono attivi. `create_recognition` accetta `type` (`appreciation`, `welcome`, `milestone`, `award`, `event`, `graduation` o `work_anniversary`; senza, Ringraziamento), e il `dry_run` mostra tipo, frase e grafica; `list_recognitions` filtra per `type`; `get_recognition` porta il tipo e la grafica. Il proprietario e l'amministratore attivano e disattivano i tipi con `update_recognition_type` (disattivare chiede conferma), caricano una grafica propria con `upload_recognition_type_art` (da URL o immagine; la prima grafica propria del tipo si carica subito, e sostituire una grafica propria già presente chiede conferma) e tornano alla predefinita con `remove_recognition_type_art` (chiede conferma). La grafica propria è 3:1, larga almeno 1200 px; senza, `artUrl` è la grafica predefinita del tipo, la stessa in tutte le community.

## Errori comuni e come risolverli

| Situazione | Perché | Cosa fare |
|---|---|---|
| Non trovo la persona quando riconosco | Non ha accesso allo spazio, o sei tu | Cambia l'accesso dello spazio |
| Il campo del valore non compare | Non c'è nessun valore attivo | Registrane o attivane uno in **Valori della community** |
| Nessuno ha guadagnato punti | Le due azioni sono a 0 | Assegna punti in **Membri › Gamification** |
| *"Scegli lo spazio Riconoscimenti: questa community ne ha più di uno"* (API o assistente) | Ci sono più spazi e la richiesta non ha detto quale | Indica lo spazio (`spaceId` nell'API, `space_id` nell'assistente) |

## Nell'API

Lo spazio è `module: "recognition"`, e la community può averne più di uno. Le rotte sono in `/api/recognitions`, con l'`X-CommunityId`: `GET` e `POST /api/recognitions`, `GET /api/recognitions/{id}`, `DELETE /api/recognitions/{id}`, `PUT` e `DELETE /api/recognitions/{id}/reaction`, `GET` e `POST /api/recognitions/{id}/comments`, `DELETE /api/recognitions/{id}/comments/{commentId}`, `GET /api/recognitions/people`, `GET /api/recognitions/dashboard` (`from`, `to`, `spaceId`) e i valori in `GET` e `POST /api/recognitions/values`, `PUT /api/recognitions/values/{valueId}` e `PUT /api/recognitions/values/order`. Nel Feed, il tipo è `recognition`; nel coinvolgimento, le azioni sono `GIVE_RECOGNITION` e `RECEIVE_RECOGNITION`.

**Più spazi**: `GET` e `POST /api/recognitions`, `/people`, `/values` e `/dashboard` accettano `spaceId`. Con un solo spazio è facoltativo e non cambia nulla; con più spazi, creare e cercare persone senza di esso restituisce `422` (`spaceRequired`). Gli elenchi senza `spaceId` uniscono gli spazi che la persona apre, e ogni riconoscimento porta il suo `spaceId`; la dashboard senza `spaceId` li somma tutti e restituisce `spaceId: null`. Le rotte per id controllano lo spazio del riconoscimento stesso. I valori sono gli stessi in ogni spazio.

| Errore | Quando |
|---|---|
| `403` | Senza accesso allo spazio, eliminare il riconoscimento di un altro senza essere del team, valori o pannello senza essere proprietario o amministratore |
| `404` | Non c'è uno spazio Riconoscimenti, lo `spaceId` non è uno di essi, o il riconoscimento non esiste (o è di uno spazio eliminato) |
| `422` | Riconoscere sé stessi, più di 20 persone, persona senza accesso allo spazio o di un'altra community, messaggio oltre 500 caratteri, o senza `spaceId` in una community con più spazi (`spaceRequired`) |

**Per valore e card**: `GET /api/recognitions` accetta `valueId` (un id o `none`); `GET /api/recognitions/dashboard` porta `byValue` (ogni valore con `recognitions` e `topPeople`); `GET /api/recognitions/{id}/card` restituisce il PNG, con `403` (`cardDenied`) per chi non l'ha dato, non è stato riconosciuto e non è del team, e `404` per un riconoscimento eliminato. Ogni riconoscimento porta `canDownloadCard`, `canShare` (la regola della card), `canPostToLinkedIn` (`canShare` e chi chiede è l'autore o uno dei riconosciuti) e `hasCustomArt` (la grafica è quella propria della community). La card è larga 1200 px e alta quanto il contenuto (da 1200×629 a 1200×1500).

**Tipi e grafiche**: `POST /api/recognitions` accetta `type` (`APPRECIATION`, il predefinito, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` o `WORK_ANNIVERSARY`), e `GET /api/recognitions` filtra per `type`. Ogni riconoscimento, in bacheca e nel Feed, porta `recognitionType`, `typeLabel`, `typePhrase` e `artUrl` (la grafica propria o la predefinita, già risolta). `GET /api/recognitions/types` elenca i tipi per chi apre lo spazio; `PUT /api/recognitions/types/{type}` attiva e disattiva, `POST /api/recognitions/types/{type}/art` carica la grafica (campo `art`; l'immagine viene ricodificata in 1800×600, senza metadati) e `DELETE /api/recognitions/types/{type}/art` torna alla predefinita, solo proprietario e amministratore (gli altri: `403`). Tipo inesistente o disattivato quando si riconosce, disattivare l'ultimo tipo attivo, o grafica in un altro formato, oltre 5 MB o larga meno di 1200 px: `400`, con il messaggio tradotto.

## Correlati

- [Feedback](/espacos/feedbacks)
- [Coinvolgimento](/espacos/ranking)
- [Gamification](/membros/gamificacao)
- [Moduli](/conceitos/modulos)
- [E-mail di questa community](/notificacoes/emails-desta-comunidade)