# Reconhecimento

> O módulo de espaço Reconhecimento, da aba Planejamento & 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 equipe, os pontos de engajamento e o e-mail para quem foi reconhecido. Os tipos (Agradecimento, Boas-vindas, Conquista…), cada um com arte e frase, as artes próprias da comunidade, o cartão para compartilhar e o Postar no LinkedIn.

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

É um [módulo de espaço](/conceitos/modulos) da aba **Planejamento & RH** de **Adicionar Espaço**. Uma comunidade pode ter **vários** espaços de Reconhecimento, por exemplo um mural por time 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 quem ajudou na mudança de sala ou organizou o evento |
| Comunidade de prática | Dar visibilidade a quem respondeu 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 equipe (proprietário, administrador, moderador e financeiro) | Apaga qualquer reconhecimento ou comentário |
| Proprietário e administrador | Cadastram 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 para quem tem acesso a ele.

### Reconhecer alguém

Em **Reconhecer**, a janela *"Reconhecer alguém"* pede:

- **Quem você quer reconhecer**: de 1 a 20 pessoas da comunidade com acesso ao espaço. Ninguém reconhece a si mesmo.
- **Valor da comunidade (opcional)**: aparece só quando há valores ativos.
- **Mensagem**: até 500 caracteres. *"Conte o que a pessoa fez e por que fez diferença."*

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

### Tipos e artes

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

| Tipo | Frase |
|---|---|
| **Agradecimento** (o padrão) | *Obrigado de verdade* |
| **Boas-vindas** | *Boas-vindas ao time* |
| **Conquista** | *Marco alcançado* |
| **Prêmio** | *Destaque* |
| **Celebração de evento** | *Mandou bem no evento* |
| **Curso concluído** | *Curso concluído* |
| **Aniversário de casa** | *Mais um ano com a gente* |

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 card abre com a arte.** No mural e no Feed, o card começa pela arte do tipo, uma faixa larga na proporção 3:1. Na metade esquerda da arte ficam a frase do tipo, as fotos 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 foto de quem reconheceu aparece pequena, como um selo sobre a foto de quem recebeu. Num card estreito (no celular), a frase e os nomes vão logo abaixo da arte. No Feed, a arte tem altura limitada.

Abaixo da arte vem uma frase: *"**David** reconheceu **Ana Prado** por **Colaboração**"* (sem valor, sem o *"por…"*), com o nome de quem reconheceu levando à página dele. Na linha de baixo, 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, **Postar no LinkedIn**.

**O mural** fica em duas colunas quando há largura (numa tela de computador a partir de 1280 px, por exemplo) e em uma coluna no celular. Os cards de uma mesma linha têm a mesma altura, com as ações embaixo, 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 para cada 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 *"Vale para 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 mudança é salva na hora.

- **Ligar e desligar**: o tipo desligado sai do **Reconhecer**; os reconhecimentos antigos dele continuam com a arte. Pelo menos um tipo fica ligado (*"Pelo menos um tipo de reconhecimento precisa ficar ligado."*).
- **Subir 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 vão 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 **Salvar arte**. Numa arte própria, a área do texto recebe uma sombra leve (e um véu claro quando a arte é escura demais para o texto ser lido). A arte própria vale também para os reconhecimentos antigos daquele 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, inclusive os antigos.

**No Cartão e no e-mail.** O **Cartão** é um PNG de 1200 px de largura que repete o card do app: no alto, a arte em 3:1 com a frase, as fotos e os nomes (um por linha) à esquerda; abaixo, *"X reconheceu Y por {valor}"*, o dia, a mensagem como citação e o logo 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 *você 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 padrão; quem a desligou em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade) não recebe, e o rodapé desliga só essa categoria num clique. O aviso sai 10 minutos depois e conta no 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 os cadastram 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 salvo não se apaga: **desative** para tirá-lo da escolha; os reconhecimentos que já o usam continuam mostrando. 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 **do espaço aberto** e abre o **Painel** desse espaço: para o período escolhido (até 366 dias, contados no fuso da comunidade), **Reconhecimentos feitos**, **Pessoas que reconheceram** e **Pessoas reconhecidas**.

### Os pontos de engajamento

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 der pontos a elas. Para ninguém subir no engajamento 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 reconhecendo a mesma pessoa de novo em menos de 7 dias não conta de novo).

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

### 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 aparecendo, marcado *inativo*.

### O cartão para compartilhar

No card do reconhecimento, **Cartão** baixa uma imagem PNG com as cores e o logo da comunidade, quem reconheceu, quem foi reconhecido, o valor e a mensagem, para compartilhar 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 equipe (proprietário, administrador, moderador e financeiro). Um reconhecimento apagado não gera cartão (*"Este reconhecimento não está mais disponível."*).

### Postar 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 equipe continua baixando o cartão dos outros, mas não posta o reconhecimento de outra pessoa.

- **No celular**, abre a janela de compartilhar do sistema com a imagem do cartão e o texto já pronto; é só escolher o LinkedIn.
- **No computador**, baixa o cartão, copia o texto e abre o LinkedIn numa aba nova: *"Cartão baixado e texto copiado. No LinkedIn, cole o texto e anexe a imagem."* Se o navegador bloquear a aba, o aviso traz o link **Abrir o LinkedIn**.

O texto muda com quem posta. 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 a aba **Planejamento & RH**.
2. Escolha **Reconhecimento** e clique em **Próximo**. Não há a pergunta "um ou vários".
3. Dê nome, ícone e quem tem acesso, como em qualquer espaço. Se quiser, cadastre já os valores da comunidade.
4. Para um mural por time ou por área, crie outro espaço de Reconhecimento e dê a ele o público certo. Os valores da comunidade já cadastrados valem nele também.

### Reconhecer um colega

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

## Exemplo

A líder de atendimento reconhece Ana e Bruno com o valor *Cliente no centro*: *"Resolveram o problema da integração num sábado, sem ninguém pedir."* O time reage com 👏 e comenta. Com 5 pontos em **Reconhecer um colega** e 10 em **Ser reconhecido**, a líder ganha 5 e cada um dos dois ganha 10. Ana e 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, buscar 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 cadastram, editam, reordenam e desativam valores e veem o painel. Com mais de um espaço de Reconhecimento, o assistente pergunta em qual (`space_id`) ao reconhecer e ao buscar pessoas; a lista sem `space_id` junta os espaços que a pessoa abre, e o painel sem `space_id` soma todos. Ver [Ferramentas · Membros › Reconhecimento](/mcp/ferramentas-membros#reconhecimento).

`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 pode baixá-lo. Cada reconhecimento traz `hasCustomArt`, `canShare` (pode pegar o cartão) e `canPostToLinkedIn` (só o autor e quem foi reconhecido): o assistente só sugere postar no LinkedIn quando ele 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. Sem arte própria, `artUrl` é a arte padrão do tipo, a mesma em todas as comunidades. O proprietário e o administrador ligam e desligam tipos com `update_recognition_type` (desligar pede confirmação), sobem uma arte própria com `upload_recognition_type_art` (por URL ou imagem, em 3:1, com pelo menos 1200 px de largura; a primeira arte do tipo sobe direto, e trocar uma arte própria que já existe pede confirmação) e voltam à padrão com `remove_recognition_type_art` (pede confirmação).

## Erros comuns e como resolver

| Situação | Por quê | O que fazer |
|---|---|---|
| Não acho a pessoa ao reconhecer | Ela não tem acesso ao espaço, ou é você | Mude o acesso do espaço |
| O campo de valor não aparece | Não há valor ativo | Cadastre 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 de um"* (API ou assistente) | Há vários espaços e o pedido não disse qual | Informe 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 engajamento, 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 espaço só, ele é opcional e nada muda; com vários, criar e buscar pessoas sem ele volta `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 conferem 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 equipe, 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 a si mesmo, 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 equipe, e `404` para reconhecimento apagado. Cada reconhecimento traz `canDownloadCard`, `canShare` (a mesma 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` sobe a arte (campo `art`; a imagem é regravada em 1800×600, recortada ao centro, 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)
- [Engajamento](/espacos/ranking)
- [Gamificação](/membros/gamificacao)
- [Módulos](/conceitos/modulos)
- [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)