# Reconocimiento

> El módulo de espacio Reconocimiento, de la pestaña Planificación y RR. HH. El muro en el que un miembro reconoce en público a entre 1 y 20 colegas, con un valor de la comunidad opcional, reacciones y comentarios; los valores de la comunidad, el panel del equipo, los puntos de participación y el correo para quien fue reconocido. Los tipos (Agradecimiento, Bienvenida, Logro…), cada uno con su arte y su frase, y las artes propias de la comunidad.

El **Reconocimiento** es un muro de elogios entre colegas, a la vista de todo el equipo: un miembro agradece en público a una o más personas lo que hicieron, y quien ve el espacio lee, reacciona y comenta. El equipo puede vincular el elogio a los **valores de la comunidad** y dar **puntos de participación** a quien reconoce y a quien es reconocido.

Es un [módulo de espacio](/conceitos/modulos) de la pestaña **Planificación y RR. HH.** de **Añadir Espacio**. Una comunidad puede tener **varios** espacios de Reconocimiento, por ejemplo un muro por equipo o por área, cada uno con su público; los valores son de toda la comunidad y valen en todos ellos.

## Para qué sirve

| Comunidad | Cómo lo usa |
|---|---|
| RR. HH. de empresa | Reforzar los valores de la comunidad con ejemplos reales |
| Coworking | Agradecer a quien ayudó en el cambio de sala u organizó el evento |
| Comunidad de práctica | Dar visibilidad a quien respondió dudas y ayudó a los nuevos |

## Cómo funciona

### Quién hace qué

| Quién | Qué hace |
|---|---|
| Quien tiene acceso al espacio | Ve el muro, reconoce a colegas, reacciona y comenta |
| El autor | Borra su propio reconocimiento |
| El equipo (propietario, administrador, moderador y financiero) | Borra cualquier reconocimiento o comentario |
| Propietario y administrador | Registran los valores de la comunidad y ven el panel |

Quien no tiene acceso al espacio no ve los reconocimientos, ni en el Feed ni por la API. Con varios espacios, cada reconocimiento se queda en el espacio donde se hizo y solo lo ve quien tiene acceso a ese espacio.

### Reconocer a alguien

En **Reconocer**, la ventana pide:

- **A quién quieres reconocer**: de 1 a 20 personas de la comunidad con acceso al espacio. Nadie se reconoce a sí mismo.
- **Valor de la comunidad (opcional)**: aparece solo cuando hay valores activos.
- **Mensaje**: hasta 500 caracteres.

El reconocimiento aparece en el muro y en el [Feed](/espacos/feed) de la sección, para quien ve el espacio; en el Feed, el filtro **Reconocimientos** muestra solo esos. Cada tarjeta tiene las reacciones (una por persona) y los comentarios, con respuestas, como en una publicación.

### Tipos y artes

Cada reconocimiento tiene un **tipo**, y cada tipo tiene un arte y una frase:

| Tipo | Frase |
|---|---|
| **Agradecimiento** (el predeterminado) | *Gracias de verdad* |
| **Bienvenida** | *Bienvenida al equipo* |
| **Logro** | *Hito alcanzado* |
| **Premio** | *Destacado* |
| **Celebración de evento** | *Lo hiciste genial en el evento* |
| **Curso completado** | *Curso completado* |
| **Aniversario en la empresa** | *Un año más con nosotros* |

En **Reconocer**, el campo **Tipo** muestra la miniatura del arte de cada tipo activado, con **Agradecimiento** ya marcado. Los reconocimientos hechos antes de los tipos aparecen como **Agradecimiento**.

**La tarjeta abre con el arte.** En el muro y en el Feed, la tarjeta empieza por el arte del tipo, una franja ancha en proporción 3:1. En la mitad izquierda del arte van la frase del tipo y las fotos y los nombres de quien fue reconocido, un nombre por línea (con tres personas o más, *"Ana Prado"* y *"Carla Nunes y 3 más"*); la foto de quien reconoció aparece pequeña, como un sello sobre la foto de quien recibió. En una tarjeta estrecha (en el móvil), la frase y los nombres van justo debajo del arte. En el Feed, el arte tiene la altura limitada.

Debajo del arte viene una frase: *"**David** reconoció a **Ana Prado** por **Colaboración**"* (sin valor, sin el *"por…"*), con el nombre de quien reconoció llevando a su página. En la línea siguiente, hace cuánto y en qué espacio. El mensaje va como cita, con una barra del color de la comunidad. Por último, las reacciones, **Comentar**, **Tarjeta** y, para quien puede, **Publicar en LinkedIn**.

**El muro** va en dos columnas cuando hay ancho (en una pantalla de ordenador desde 1280 px, por ejemplo) y en una columna en el móvil. Las tarjetas de una misma fila tienen la misma altura, con las acciones abajo, y el mensaje muestra hasta 4 líneas, con **Ver más** para leer el resto (y **Ver menos** para recogerlo).

**Las artes predeterminadas** son las imágenes 3D de Memberfy, una por tipo, iguales en todas las comunidades: no cambian con los colores de la comunidad.

**Configurar los tipos.** *Rol: propietario o administrador.* En el menú lateral, en el **…** del espacio, **Editar espacio**, y baja hasta **Tipos y artes**. La configuración *"Vale para todos los espacios de Reconocimiento de la comunidad."* Cada tipo muestra el arte actual, la frase y un interruptor para activarlo o desactivarlo; cada cambio se guarda al momento.

- **Activar y desactivar**: el tipo desactivado sale de **Reconocer**; sus reconocimientos antiguos conservan el arte. Al menos un tipo queda activado (*"Al menos un tipo de reconocimiento debe quedar activado."*).
- **Subir arte propio**: PNG, JPG o WebP, hasta 5 MB, con al menos **1200 px** de ancho. Lo recomendado es **1800×600** (3:1), con el dibujo a la derecha y la mitad izquierda libre: la frase y el nombre van ahí. La imagen se recorta al centro en 3:1; la **Vista previa** muestra el arte pegado a la derecha, con la frase y un nombre de ejemplo a la izquierda, antes de **Guardar arte**. En un arte propio, la zona del texto recibe una sombra suave (y un velo claro cuando el arte es demasiado oscuro para leer el texto). El arte propio vale también para los reconocimientos antiguos de ese tipo. **Cambiar arte** reemplaza el actual.
- **Volver al predeterminado**: borra el arte propio, y el tipo vuelve al arte predeterminado en todos los reconocimientos, incluso los antiguos.

**En la Tarjeta y en el correo.** La **Tarjeta** es un PNG de 1200 px de ancho que repite la tarjeta de la app: arriba, el arte en 3:1 con la frase, las fotos y los nombres (uno por línea) a la izquierda; debajo, *"X reconoció a Y por {valor}"*, el día, el mensaje como cita y el logo de la comunidad. La altura sigue al contenido, entre 1,91:1 y 1:1,25: un mensaje de una línea da 1200×764, y un mensaje largo llega a 8 líneas, terminando en *"…"*. El correo *te reconocieron* muestra el arte y la frase del tipo arriba.

**En workflows.** El disparador de reconocimiento recibido (`recognition.received`) trae el tipo del reconocimiento en el campo opcional `type` (`APPRECIATION`, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` o `WORK_ANNIVERSARY`). Ver [Workflows](/notificacoes/workflows).

### El correo para quien fue reconocido

Cada persona reconocida recibe un correo con el autor, el mensaje y el botón para abrir el reconocimiento, en su idioma y con el color de la comunidad. El correo es de la categoría **Reconocimientos**, activada por defecto; quien la desactivó en [Correos de esta comunidad](/notificacoes/emails-desta-comunidade) no lo recibe, y el pie desactiva solo esa categoría con un clic. El aviso sale 10 minutos después y cuenta en el límite de 3 avisos por persona al día. No hay correo para el resto de la comunidad.

### Los valores de la comunidad

Los valores (por ejemplo, *Colaboración*, *Dueño del resultado*, *El cliente en el centro*) son **opcionales**. El propietario y el administrador los registran al crear el espacio o después, en **Gestionar reconocimientos › Valores de la comunidad**: nombre (hasta 80 caracteres), descripción opcional (hasta 300), el orden y si está **activo**. Son hasta 30. Un valor guardado no se borra: **desactívalo** para sacarlo de la elección; los reconocimientos que ya lo usan siguen mostrándolo. Sin valores activos, el campo no aparece al reconocer.

Los valores son **de la comunidad**: la misma lista vale en todos los espacios de Reconocimiento, y lo que se cambia en uno cambia en todos. La ventana de valores lo avisa: *"Los valores son de la comunidad: la misma lista vale en todos los espacios de Reconocimiento."*

### El panel

La barra **Gestionar reconocimientos**, del propietario y del administrador, muestra los reconocimientos de los últimos 30 días y abre el **Panel**: para el período elegido (hasta 366 días, contados en la zona horaria de la comunidad), **Reconocimientos hechos**, **Personas que reconocieron** y **Personas reconocidas**. Con varios espacios, la barra y el panel muestran el espacio abierto.

### Los puntos de participación

En **Miembros › Gamificación**, dos acciones nuevas: **Reconocer a un colega** (para el autor) y **Ser reconocido** (para cada persona reconocida). Las dos empiezan en **0**: solo cuentan si el propietario les da puntos. Para que nadie suba en la participación por volumen o por acuerdo:

- quien reconoce gana los puntos de **Reconocer a un colega** en **hasta 3 reconocimientos al día**;
- quien es reconocido gana los puntos de **Ser reconocido** **una vez por semana de cada autor** (el mismo colega reconociendo a la misma persona otra vez en menos de 7 días no cuenta de nuevo).

Pasado el límite, el reconocimiento se publica normalmente, solo que sin los puntos. Borrar un reconocimiento retira exactamente los puntos que dio. Los días siguen la zona horaria de la comunidad. Ver [Participación](/espacos/ranking) y [Gamificación](/membros/gamificacao). Los límites cuentan los reconocimientos de todos los espacios juntos.

### Filtrar y contar por valor

En el muro, **Filtrar por valor** muestra solo los reconocimientos de un valor de la comunidad, o los **Sin valor**; **Ver todos** vuelve al muro completo. Cualquier persona con acceso al espacio usa el filtro.

En el **Panel**, el bloque **Por valor** muestra cuántos reconocimientos recibió cada valor en el período (y los sin valor) y las 5 personas más reconocidas en cada uno. Un valor desactivado con reconocimientos en el período sigue apareciendo, marcado *inactivo*.

### La tarjeta para compartir

En la tarjeta del reconocimiento, **Tarjeta** descarga una imagen PNG con los colores y el logo de la comunidad, quién reconoció, a quién se reconoció, el valor y el mensaje, para compartir fuera de la comunidad. La tarjeta no lleva correo ni nada más de lo que el muro ya muestra.

El botón aparece para quien dio el reconocimiento, para quien fue reconocido y para el equipo (propietario, administrador, moderador y finanzas). Un reconocimiento borrado no genera tarjeta (*"Este reconocimiento ya no está disponible."*).

### Publicar en LinkedIn

El botón de LinkedIn, junto a **Tarjeta**, aparece solo para **quien dio** el reconocimiento y para **quien fue reconocido**. El equipo sigue descargando la tarjeta de los demás, pero no publica el reconocimiento de otra persona.

- **En el móvil**, abre la ventana de compartir del sistema con la imagen de la tarjeta y el texto listo; basta con elegir LinkedIn.
- **En el ordenador**, descarga la tarjeta, copia el texto y abre LinkedIn en una pestaña nueva: *"Tarjeta descargada y texto copiado. En LinkedIn, pega el texto y adjunta la imagen."* Si el navegador bloquea la pestaña, el aviso trae el enlace **Abrir LinkedIn**.

El texto cambia según quién publica. Quien recibió: *"Recibí un reconocimiento de {quien reconoció} en la comunidad {comunidad}: “{frase}”"*. Quien dio: *"Reconocí a {nombres} en la comunidad {comunidad}: “{frase}”"*.

## Paso a paso

### Crear el espacio

1. En el menú, abre **Añadir Espacio** y elige la pestaña **Planificación y RR. HH.**
2. Elige **Reconocimiento** y haz clic en **Siguiente**. No hay la pregunta "uno o varios".
3. Dale nombre, icono y quién tiene acceso, como a cualquier espacio. Si quieres, registra ya los valores de la comunidad.
4. Para un muro por equipo o por área, crea otro espacio de Reconocimiento y dale el público adecuado. Los valores de la comunidad ya registrados valen también en él.

### Reconocer a un colega

1. Abre el espacio y haz clic en **Reconocer**.
2. Escribe el nombre de uno o más colegas, elige un valor (si hay) y escribe el mensaje.
3. Haz clic en **Reconocer**. La tarjeta aparece arriba del muro.

## Ejemplo

La responsable de atención reconoce a Ana y a Bruno con el valor *El cliente en el centro*: *"Resolvieron el problema de la integración un sábado, sin que nadie lo pidiera."* El equipo reacciona con 👏 y comenta. Con 5 puntos en **Reconocer a un colega** y 10 en **Ser reconocido**, la responsable gana 5 y cada uno de los dos gana 10. Ana y Bruno reciben el correo.

## Con el asistente (MCP)

Son 14 herramientas: listar el muro (`list_recognitions`, con filtro por persona), abrir un reconocimiento con los comentarios, buscar a quién se puede reconocer, **reconocer** (`create_recognition`, con `dry_run` para ver antes quién recibe el correo), reaccionar, comentar, ver los valores y borrar un reconocimiento o un comentario, con confirmación. El propietario y el administrador también registran, editan, reordenan y desactivan valores y ven el panel. Ver [Herramientas · Miembros › Reconocimiento](/mcp/ferramentas-membros#reconocimiento). Con más de un espacio de Reconocimiento, el asistente pregunta en cuál (`space_id`) al reconocer y al buscar personas; la lista sin `space_id` junta los espacios que la persona abre, y el panel sin `space_id` los suma todos.

`list_recognitions` filtra por valor (`value`: nombre, id o `none` para los sin valor), `get_recognition_dashboard` trae el bloque por valor y `get_recognition_card` devuelve la tarjeta como imagen para quien puede descargarla. Cada reconocimiento trae `hasCustomArt`, `canShare` (puede obtener la tarjeta) y `canPostToLinkedIn` (solo el autor y quien fue reconocido): el asistente solo sugiere publicar en LinkedIn cuando viene verdadero.

**Tipos y artes**. `list_recognition_types`, para quien abre el espacio, lista los siete tipos con la etiqueta, la frase, el arte y si están activados. `create_recognition` acepta `type` (`appreciation`, `welcome`, `milestone`, `award`, `event`, `graduation` o `work_anniversary`; sin él, Agradecimiento), y el `dry_run` muestra el tipo, la frase y el arte; `list_recognitions` filtra por `type`; `get_recognition` trae el tipo y el arte. El propietario y el administrador activan y desactivan tipos con `update_recognition_type` (desactivar pide confirmación), suben un arte propio con `upload_recognition_type_art` (por URL o imagen; el primer arte propio del tipo se sube directo, y reemplazar un arte propio que ya existe pide confirmación) y vuelven al predeterminado con `remove_recognition_type_art` (pide confirmación). El arte propio es 3:1, con al menos 1200 px de ancho; sin él, `artUrl` es el arte predeterminado del tipo, el mismo en todas las comunidades.

## Errores comunes y cómo resolverlos

| Situación | Por qué | Qué hacer |
|---|---|---|
| No encuentro a la persona al reconocer | No tiene acceso al espacio, o eres tú | Cambia el acceso del espacio |
| El campo de valor no aparece | No hay ningún valor activo | Registra o activa uno en **Valores de la comunidad** |
| Nadie ganó puntos | Las dos acciones están en 0 | Da puntos en **Miembros › Gamificación** |
| *"Elige el espacio de Reconocimiento: esta comunidad tiene más de uno"* (API o asistente) | Hay varios espacios y la petición no dijo cuál | Indica el espacio (`spaceId` en la API, `space_id` en el asistente) |

## En la API

El espacio es `module: "recognition"`, y la comunidad puede tener varios. Las rutas están en `/api/recognitions`, con el `X-CommunityId`: `GET` y `POST /api/recognitions`, `GET /api/recognitions/{id}`, `DELETE /api/recognitions/{id}`, `PUT` y `DELETE /api/recognitions/{id}/reaction`, `GET` y `POST /api/recognitions/{id}/comments`, `DELETE /api/recognitions/{id}/comments/{commentId}`, `GET /api/recognitions/people`, `GET /api/recognitions/dashboard` (`from`, `to`, `spaceId`) y los valores en `GET` y `POST /api/recognitions/values`, `PUT /api/recognitions/values/{valueId}` y `PUT /api/recognitions/values/order`. En el Feed, el tipo es `recognition`; en la participación, las acciones son `GIVE_RECOGNITION` y `RECEIVE_RECOGNITION`.

**Varios espacios**: `GET` y `POST /api/recognitions`, `/people`, `/values` y `/dashboard` aceptan `spaceId`. Con un solo espacio es opcional y nada cambia; con varios, crear y buscar personas sin él devuelve `422` (`spaceRequired`). Las listas sin `spaceId` juntan los espacios que la persona abre, y cada reconocimiento trae su `spaceId`; el panel sin `spaceId` los suma todos y devuelve `spaceId: null`. Las rutas por id comprueban el espacio del propio reconocimiento. Los valores son los mismos en cualquier espacio.

| Error | Cuándo |
|---|---|
| `403` | Sin acceso al espacio, borrar el reconocimiento de otra persona sin ser del equipo, valores o panel sin ser propietario o administrador |
| `404` | No hay espacio de Reconocimiento, el `spaceId` no es uno de ellos, o el reconocimiento no existe (o es de un espacio borrado) |
| `422` | Reconocerse a sí mismo, más de 20 personas, persona sin acceso al espacio o de otra comunidad, mensaje de más de 500 caracteres, o sin `spaceId` en una comunidad con varios espacios (`spaceRequired`) |

**Por valor y tarjeta**: `GET /api/recognitions` acepta `valueId` (un id o `none`); `GET /api/recognitions/dashboard` trae `byValue` (cada valor con `recognitions` y `topPeople`); `GET /api/recognitions/{id}/card` devuelve el PNG, con `403` (`cardDenied`) para quien no lo dio, no fue reconocido y no es del equipo, y `404` para un reconocimiento borrado. Cada reconocimiento trae `canDownloadCard`, `canShare` (la regla de la tarjeta), `canPostToLinkedIn` (`canShare` y quien pide es el autor o uno de los reconocidos) y `hasCustomArt` (el arte es el propio de la comunidad). La tarjeta tiene 1200 px de ancho y la altura del contenido (de 1200×629 a 1200×1500).

**Tipos y artes**: `POST /api/recognitions` acepta `type` (`APPRECIATION`, el predeterminado, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` o `WORK_ANNIVERSARY`), y `GET /api/recognitions` filtra por `type`. Cada reconocimiento, en el muro y en el Feed, trae `recognitionType`, `typeLabel`, `typePhrase` y `artUrl` (el arte propio o el predeterminado, ya resuelto). `GET /api/recognitions/types` lista los tipos para quien abre el espacio; `PUT /api/recognitions/types/{type}` activa y desactiva, `POST /api/recognitions/types/{type}/art` sube el arte (campo `art`; la imagen se regraba en 1800×600, sin metadatos) y `DELETE /api/recognitions/types/{type}/art` vuelve al predeterminado, solo propietario y administrador (los demás: `403`). Tipo inexistente o desactivado al reconocer, desactivar el último tipo activado, o arte en otro formato, de más de 5 MB o con menos de 1200 px de ancho: `400`, con el mensaje traducido.

## Relacionados

- [Feedback](/espacos/feedbacks)
- [Participación](/espacos/ranking)
- [Gamificación](/membros/gamificacao)
- [Módulos](/conceitos/modulos)
- [Correos de esta comunidad](/notificacoes/emails-desta-comunidade)