# Reconhecimento

> O módulo de espaço Reconhecimento, do separador Planeamento & RH. O mural em que um membro reconhece de 1 a 20 colegas em público, com um valor da comunidade opcional, reações e comentários; os valores da comunidade, o painel da equipa, os pontos de envolvimento e o e-mail para quem foi reconhecido. Os tipos (Agradecimento, Boas-vindas, Conquista…), cada um com arte e frase, e as artes próprias da comunidade.

O **Reconhecimento** é um mural de elogios entre colegas, à vista de toda a equipa: um membro agradece em público a uma ou mais pessoas o que fizeram, e quem vê o espaço lê, reage e comenta. A equipa pode ligar o elogio aos **valores da comunidade** e dar **pontos de envolvimento** a quem reconhece e a quem é reconhecido.

É um [módulo de espaço](/conceitos/modulos) do separador **Planeamento & RH** de **Adicionar Espaço**. Uma comunidade pode ter **vários** espaços de Reconhecimento, por exemplo um mural por equipa ou por área, cada um com o seu público; os valores são da comunidade inteira e valem em todos eles.

## Para que serve

| Comunidade | Como usa |
|---|---|
| RH de empresa | Reforçar os valores da comunidade com exemplos reais |
| Coworking | Agradecer a quem ajudou na mudança de sala ou organizou o evento |
| Comunidade de prática | Dar visibilidade a quem respondeu a dúvidas e ajudou os novos |

## Como funciona

### Quem faz o quê

| Quem | O que faz |
|---|---|
| Quem tem acesso ao espaço | Vê o mural, reconhece colegas, reage e comenta |
| O autor | Apaga o próprio reconhecimento |
| A equipa (proprietário, administrador, moderador e financeiro) | Apaga qualquer reconhecimento ou comentário |
| Proprietário e administrador | Registam os valores da comunidade e veem o painel |

Quem não tem acesso ao espaço não vê os reconhecimentos, nem no Feed nem pela API. Com vários espaços, cada reconhecimento fica no espaço em que foi feito e só aparece a quem tem acesso a ele.

### Reconhecer alguém

Em **Reconhecer**, a janela pede:

- **Quem quer reconhecer**: de 1 a 20 pessoas da comunidade com acesso ao espaço. Ninguém se reconhece a si próprio.
- **Valor da comunidade (opcional)**: aparece só quando há valores ativos.
- **Mensagem**: até 500 caracteres.

O reconhecimento aparece no mural e no [Feed](/espacos/feed) da secção, para quem vê o espaço; no Feed, o filtro **Reconhecimentos** mostra só esses. Cada cartão tem as reações (uma por pessoa) e os comentários, com respostas, como numa publicação.

### Tipos e artes

Cada reconhecimento tem um **tipo**, e cada tipo tem uma arte e uma frase:

| Tipo | Frase |
|---|---|
| **Agradecimento** (o padrão) | *Obrigado, a sério* |
| **Boas-vindas** | *Bem-vindo à equipa* |
| **Conquista** | *Marco alcançado* |
| **Prémio** | *Destaque* |
| **Celebração de evento** | *Arrasou no evento* |
| **Curso concluído** | *Curso concluído* |
| **Aniversário de casa** | *Mais um ano connosco* |

No **Reconhecer**, o campo **Tipo** mostra a miniatura da arte de cada tipo ligado, com **Agradecimento** já marcado. Os reconhecimentos feitos antes dos tipos aparecem como **Agradecimento**.

**O cartão abre com a arte.** No mural e no Feed, o cartão começa pela arte do tipo, uma faixa larga na proporção 3:1. Na metade esquerda da arte ficam a frase do tipo e as fotografias e os nomes de quem foi reconhecido, um nome por linha (com três pessoas ou mais, *"Ana Prado"* e *"Carla Nunes e mais 3"*); a fotografia de quem reconheceu aparece pequena, como um selo sobre a fotografia de quem recebeu. Num cartão estreito (no telemóvel), a frase e os nomes ficam logo por baixo da arte. No Feed, a arte tem altura limitada.

Por baixo da arte vem uma frase: *"**David** reconheceu **Ana Prado** por **Colaboração**"* (sem valor, sem o *"por…"*), com o nome de quem reconheceu a levar à página dele. Na linha seguinte, há quanto tempo e em que espaço. A mensagem vem como citação, com uma barra na cor da comunidade. Por último, as reações, **Comentar**, **Cartão** e, para quem pode, **Publicar no LinkedIn**.

**O mural** fica em duas colunas quando há largura (num ecrã de computador a partir de 1280 px, por exemplo) e numa coluna no telemóvel. Os cartões da mesma linha têm a mesma altura, com as ações em baixo, e a mensagem mostra até 4 linhas, com **Ver mais** para ler o resto (e **Ver menos** para recolher).

**As artes padrão** são as imagens 3D da Memberfy, uma por tipo, iguais em todas as comunidades: não mudam com as cores da comunidade.

**Configurar os tipos.** *Papel: proprietário ou administrador.* No menu lateral, no **…** do espaço, **Editar espaço**, e desça até **Tipos e artes**. A configuração *"Aplica-se a todos os espaços de Reconhecimento da comunidade."* Cada tipo mostra a arte atual, a frase e um botão para ligar ou desligar; cada alteração fica guardada logo.

- **Ligar e desligar**: o tipo desligado sai do **Reconhecer**; os reconhecimentos antigos desse tipo continuam com a arte. Pelo menos um tipo fica ligado (*"Pelo menos um tipo de reconhecimento tem de ficar ligado."*).
- **Carregar arte própria**: PNG, JPG ou WebP, até 5 MB, com pelo menos **1200 px** de largura. O recomendado é **1800×600** (3:1), com o desenho à direita e a metade esquerda livre: a frase e o nome ficam ali. A imagem é recortada ao centro em 3:1; a **Prévia** mostra a arte presa à direita, com a frase e um nome de exemplo à esquerda, antes de **Guardar arte**. Numa arte própria, a zona do texto recebe uma sombra leve (e um véu claro quando a arte é escura demais para o texto se ler). A arte própria vale também para os reconhecimentos antigos desse tipo. **Trocar arte** substitui a atual.
- **Voltar para a padrão**: apaga a arte própria, e o tipo volta à arte padrão em todos os reconhecimentos, incluindo os antigos.

**No Cartão e no e-mail.** O **Cartão** é um PNG com 1200 px de largura que repete o cartão da aplicação: no topo, a arte em 3:1 com a frase, as fotografias e os nomes (um por linha) à esquerda; por baixo, *"X reconheceu Y por {valor}"*, o dia, a mensagem como citação e o logótipo da comunidade. A altura acompanha o conteúdo, entre 1,91:1 e 1:1,25: uma mensagem de uma linha dá 1200×764, e uma mensagem longa vai até 8 linhas, terminando em *"…"*. O e-mail *foi reconhecido* mostra a arte e a frase do tipo no topo.

**Em workflows.** O gatilho de reconhecimento recebido (`recognition.received`) traz o tipo do reconhecimento no campo opcional `type` (`APPRECIATION`, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` ou `WORK_ANNIVERSARY`). Ver [Workflows](/notificacoes/workflows).

### O e-mail para quem foi reconhecido

Cada pessoa reconhecida recebe um e-mail com o autor, a mensagem e o botão para abrir o reconhecimento, no idioma dela e com a cor da comunidade. O e-mail é da categoria **Reconhecimentos**, ligada por omissão; quem a desligou em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade) não recebe, e o rodapé desliga só essa categoria com um clique. O aviso sai 10 minutos depois e conta para o limite de 3 avisos por pessoa por dia. Não há e-mail para o resto da comunidade.

### Os valores da comunidade

Os valores (por exemplo, *Colaboração*, *Dono do resultado*, *Cliente no centro*) são **opcionais**. O proprietário e o administrador registam-nos ao criar o espaço ou depois, em **Gerenciar reconhecimentos › Valores da comunidade**: nome (até 80 caracteres), descrição opcional (até 300), a ordem e se está **ativo**. São até 30. Um valor guardado não se apaga: **desative-o** para o tirar da escolha; os reconhecimentos que já o usam continuam a mostrá-lo. Sem valores ativos, o campo não aparece ao reconhecer.

Os valores são **da comunidade**: a mesma lista vale em todos os espaços de Reconhecimento, e o que se muda num deles muda em todos. A janela de valores avisa: *"Os valores são da comunidade: a mesma lista vale em todos os espaços de Reconhecimento."*

### O painel

A barra **Gerenciar reconhecimentos**, do proprietário e do administrador, mostra os reconhecimentos dos últimos 30 dias e abre o **Painel**: para o período escolhido (até 366 dias, contados no fuso horário da comunidade), **Reconhecimentos feitos**, **Pessoas que reconheceram** e **Pessoas reconhecidas**. Com vários espaços, a barra e o painel mostram o espaço aberto.

### Os pontos de envolvimento

Em **Membros › Gamificação**, duas ações novas: **Reconhecer um colega** (para o autor) e **Ser reconhecido** (para cada pessoa reconhecida). As duas começam com **0**: só contam se o proprietário lhes der pontos. Para ninguém subir no envolvimento por volume ou por combinação:

- quem reconhece ganha os pontos de **Reconhecer um colega** em **até 3 reconhecimentos por dia**;
- quem é reconhecido ganha os pontos de **Ser reconhecido** **uma vez por semana de cada autor** (o mesmo colega a reconhecer a mesma pessoa outra vez em menos de 7 dias não conta de novo).

Passado o limite, o reconhecimento é publicado normalmente, só sem os pontos. Apagar um reconhecimento retira exatamente os pontos que ele deu. Os dias seguem o fuso horário da comunidade. Ver [Envolvimento](/espacos/ranking) e [Gamificação](/membros/gamificacao). Os limites contam os reconhecimentos de todos os espaços em conjunto.

### Filtrar e contar por valor

No mural, **Filtrar por valor** mostra só os reconhecimentos de um valor da comunidade, ou os **Sem valor**; **Ver todos** volta ao mural inteiro. Qualquer pessoa com acesso ao espaço usa o filtro.

No **Painel**, o bloco **Por valor** mostra quantos reconhecimentos cada valor recebeu no período (e os sem valor) e as 5 pessoas mais reconhecidas em cada um. Um valor desativado com reconhecimentos no período continua a aparecer, marcado *inativo*.

### O cartão para partilhar

No cartão do reconhecimento, **Cartão** descarrega uma imagem PNG com as cores e o logótipo da comunidade, quem reconheceu, quem foi reconhecido, o valor e a mensagem, para partilhar fora da comunidade. O cartão não traz e-mail nem nada além do que o mural já mostra.

O botão aparece para quem deu o reconhecimento, para quem foi reconhecido e para a equipa (proprietário, administrador, moderador e financeiro). Um reconhecimento apagado não gera cartão (*"Este reconhecimento já não está disponível."*).

### Publicar no LinkedIn

O botão do LinkedIn, ao lado de **Cartão**, aparece só para **quem deu** o reconhecimento e para **quem foi reconhecido**. A equipa continua a descarregar o cartão dos outros, mas não publica o reconhecimento de outra pessoa.

- **No telemóvel**, abre a janela de partilha do sistema com a imagem do cartão e o texto já pronto; basta escolher o LinkedIn.
- **No computador**, descarrega o cartão, copia o texto e abre o LinkedIn num separador novo: *"Cartão descarregado e texto copiado. No LinkedIn, cole o texto e anexe a imagem."* Se o navegador bloquear o separador, o aviso traz a ligação **Abrir o LinkedIn**.

O texto muda consoante quem publica. Quem recebeu: *"Recebi um reconhecimento de {quem reconheceu} na comunidade {comunidade}: “{frase}”"*. Quem deu: *"Reconheci {nomes} na comunidade {comunidade}: “{frase}”"*.

## Passo a passo

### Criar o espaço

1. No menu, abra **Adicionar Espaço** e escolha o separador **Planeamento & RH**.
2. Escolha **Reconhecimento** e clique em **Seguinte**. Não há a pergunta "um ou vários".
3. Dê nome, ícone e quem tem acesso, como em qualquer espaço. Se quiser, registe já os valores da comunidade.
4. Para um mural por equipa ou por área, crie outro espaço de Reconhecimento e dê-lhe o público certo. Os valores da comunidade já registados valem nele também.

### Reconhecer um colega

1. Abra o espaço e clique em **Reconhecer**.
2. Escreva o nome de um ou mais colegas, escolha um valor (se houver) e escreva a mensagem.
3. Clique em **Reconhecer**. O cartão aparece no topo do mural.

## Exemplo

A responsável pelo apoio ao cliente reconhece a Ana e o Bruno com o valor *Cliente no centro*: *"Resolveram o problema da integração num sábado, sem ninguém pedir."* A equipa reage com 👏 e comenta. Com 5 pontos em **Reconhecer um colega** e 10 em **Ser reconhecido**, a responsável ganha 5 e cada um dos dois ganha 10. A Ana e o Bruno recebem o e-mail.

## Pelo assistente (MCP)

São 14 ferramentas: listar o mural (`list_recognitions`, com filtro por pessoa), abrir um reconhecimento com os comentários, procurar quem pode ser reconhecido, **reconhecer** (`create_recognition`, com `dry_run` para ver antes quem recebe o e-mail), reagir, comentar, ver os valores, e apagar um reconhecimento ou um comentário, com confirmação. O proprietário e o administrador também registam, editam, reordenam e desativam valores e veem o painel. Ver [Ferramentas · Membros › Reconhecimento](/mcp/ferramentas-membros#reconhecimento). Com mais do que um espaço de Reconhecimento, o assistente pergunta em qual (`space_id`) ao reconhecer e ao procurar pessoas; a lista sem `space_id` junta os espaços que a pessoa abre, e o painel sem `space_id` soma todos.

`list_recognitions` filtra por valor (`value`: nome, id ou `none` para os sem valor), `get_recognition_dashboard` traz o bloco por valor e `get_recognition_card` devolve o cartão em imagem para quem o pode descarregar. Cada reconhecimento traz `hasCustomArt`, `canShare` (pode obter o cartão) e `canPostToLinkedIn` (só o autor e quem foi reconhecido): o assistente só sugere publicar no LinkedIn quando vem verdadeiro.

**Tipos e artes**. `list_recognition_types`, para quem abre o espaço, lista os sete tipos com o rótulo, a frase, a arte e se estão ligados. `create_recognition` aceita `type` (`appreciation`, `welcome`, `milestone`, `award`, `event`, `graduation` ou `work_anniversary`; sem ele, Agradecimento), e o `dry_run` mostra o tipo, a frase e a arte; `list_recognitions` filtra por `type`; `get_recognition` traz o tipo e a arte. O proprietário e o administrador ligam e desligam tipos com `update_recognition_type` (desligar pede confirmação), carregam uma arte própria com `upload_recognition_type_art` (por URL ou imagem; a primeira arte do tipo sobe diretamente, e trocar uma arte própria que já existe pede confirmação) e voltam à padrão com `remove_recognition_type_art` (pede confirmação). A arte própria é 3:1, com pelo menos 1200 px de largura; sem ela, `artUrl` é a arte padrão do tipo, a mesma em todas as comunidades.

## Erros comuns e como resolver

| Situação | Porquê | O que fazer |
|---|---|---|
| Não encontro a pessoa ao reconhecer | Ela não tem acesso ao espaço, ou é o próprio | Mude o acesso do espaço |
| O campo de valor não aparece | Não há valor ativo | Registe ou ative um em **Valores da comunidade** |
| Ninguém ganhou pontos | As duas ações estão com 0 | Dê pontos em **Membros › Gamificação** |
| *"Escolha o espaço de Reconhecimento: esta comunidade tem mais do que um"* (API ou assistente) | Há vários espaços e o pedido não disse qual | Indique o espaço (`spaceId` na API, `space_id` no assistente) |

## Na API

O espaço é `module: "recognition"`, e a comunidade pode ter vários. As rotas ficam em `/api/recognitions`, com o `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 os valores em `GET` e `POST /api/recognitions/values`, `PUT /api/recognitions/values/{valueId}` e `PUT /api/recognitions/values/order`. No Feed, o tipo é `recognition`; no envolvimento, as ações são `GIVE_RECOGNITION` e `RECEIVE_RECOGNITION`.

**Vários espaços**: `GET` e `POST /api/recognitions`, `/people`, `/values` e `/dashboard` aceitam `spaceId`. Com um só espaço, é opcional e nada muda; com vários, criar e procurar pessoas sem ele devolve `422` (`spaceRequired`). As listas sem `spaceId` juntam os espaços que a pessoa abre, e cada reconhecimento traz o seu `spaceId`; o painel sem `spaceId` soma todos e devolve `spaceId: null`. As rotas por id verificam o espaço do próprio reconhecimento. Os valores são os mesmos em qualquer espaço.

| Erro | Quando |
|---|---|
| `403` | Sem acesso ao espaço, apagar o reconhecimento de outra pessoa sem ser da equipa, valores ou painel sem ser proprietário ou administrador |
| `404` | Não há espaço de Reconhecimento, o `spaceId` não é um deles, ou o reconhecimento não existe (ou é de um espaço apagado) |
| `422` | Reconhecer-se a si próprio, mais de 20 pessoas, pessoa sem acesso ao espaço ou de outra comunidade, mensagem acima de 500 caracteres, ou sem `spaceId` numa comunidade com vários espaços (`spaceRequired`) |

**Por valor e cartão**: `GET /api/recognitions` aceita `valueId` (um id ou `none`); `GET /api/recognitions/dashboard` traz `byValue` (cada valor com `recognitions` e `topPeople`); `GET /api/recognitions/{id}/card` devolve o PNG, com `403` (`cardDenied`) para quem não deu, não recebeu e não é da equipa, e `404` para um reconhecimento apagado. Cada reconhecimento traz `canDownloadCard`, `canShare` (a regra do cartão), `canPostToLinkedIn` (`canShare` e quem pede é o autor ou um dos reconhecidos) e `hasCustomArt` (a arte é a própria da comunidade). O cartão tem 1200 px de largura e a altura do conteúdo (de 1200×629 a 1200×1500).

**Tipos e artes**: `POST /api/recognitions` aceita `type` (`APPRECIATION`, o padrão, `WELCOME`, `MILESTONE`, `AWARD`, `EVENT`, `GRADUATION` ou `WORK_ANNIVERSARY`), e `GET /api/recognitions` filtra por `type`. Cada reconhecimento, no mural e no Feed, traz `recognitionType`, `typeLabel`, `typePhrase` e `artUrl` (a arte própria ou a padrão, já resolvida). `GET /api/recognitions/types` lista os tipos para quem abre o espaço; `PUT /api/recognitions/types/{type}` liga e desliga, `POST /api/recognitions/types/{type}/art` carrega a arte (campo `art`; a imagem é regravada em 1800×600, sem metadados) e `DELETE /api/recognitions/types/{type}/art` volta à padrão, só proprietário e administrador (os outros: `403`). Tipo inexistente ou desligado ao reconhecer, desligar o último tipo ligado, ou arte fora do formato, acima de 5 MB ou com menos de 1200 px de largura: `400`, com a mensagem traduzida.

## Relacionados

- [Feedbacks](/espacos/feedbacks)
- [Envolvimento](/espacos/ranking)
- [Gamificação](/membros/gamificacao)
- [Módulos](/conceitos/modulos)
- [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)