Reconocimiento

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

#Cómo funciona

#Quién hace qué

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

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.

#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 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 y Gamificación. 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. 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

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

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
• Participación
• Gamificación
• Módulos
• Correos de esta comunidad