Reconhecimento

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

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

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.

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

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

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

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

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