Riconoscimenti

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 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

#Come funziona

#Chi fa cosa

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 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:

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.

#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 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 e Gamification. 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. 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

#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.

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
• Coinvolgimento
• Gamification
• Moduli
• E-mail di questa community