Reconhecimento

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

#Como funciona

#Quem faz o quê

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

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.

#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 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 e Gamificação. 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. 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

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

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
• Envolvimento
• Gamificação
• Módulos
• E-mails desta comunidade