Feedbacks
O módulo de espaço Feedbacks, da aba Planejamento & RH. Dar, pedir, responder, recusar, cancelar, agradecer e apagar feedback entre colegas, nas caixas Recebidos, Enviados e Pedidos; só quem deu e quem recebeu leem o texto, a equipe vê só os números. Temas e comportamentos dão um roteiro para pedir e escrever. O feedback sobre outra pessoa (o líder pede a colegas sobre um liderado, ou um colega conta ao líder) tem o feedback interno e a mensagem para a pessoa.
O Feedbacks é o lugar do feedback contínuo entre colegas, fora dos ciclos de avaliação: qualquer pessoa com acesso ao espaço dá um feedback a um colega ou pede o dele, em poucos segundos, e cada um guarda o histórico do que recebeu e do que deu.
É um módulo de espaço da aba Planejamento & RH de Adicionar Espaço. Uma comunidade pode ter vários espaços de Feedbacks, por exemplo um por time ou por área, cada um com o seu público.
Quem lê o quê
Só quem deu e quem recebeu leem um feedback. Ninguém mais lê o texto: nem o proprietário, nem o administrador, nem o líder da pessoa, nem o suporte da Memberfy. O mesmo vale para os pedidos: só quem pediu e quem foi pedido os veem.
- A equipe (proprietário e administrador) vê só números: quantos feedbacks, pedidos e respostas, sem texto, autor ou destinatário.
- O feedback não é anônimo: o destinatário sempre sabe quem deu.
- Os temas e comportamentos de um feedback ou pedido seguem a mesma regra: só as duas pessoas os veem; a equipe vê só a contagem por tema, nos Números.
- Nada do texto vai para o Feed, para a busca, para exportação ou para o e-mail.
- Quando o suporte da Memberfy entra na comunidade como proprietário (botão Entrar), também não lê nem mexe nos feedbacks e pedidos: só vê os Números. Ver SuperAdmin.
- A exceção é o feedback sobre outra pessoa: o Feedback interno é lido pelo autor, por quem pediu e pelo líder direto da pessoa; a pessoa lê só a Mensagem para a pessoa, se houver. Também ali a equipe vê só números.
Como funciona
As três caixas
| Aba | O que mostra |
|---|---|
| Recebidos | Os feedbacks que deram a você |
| Enviados | Os feedbacks que você deu |
| Pedidos | Pedidos para mim (os colegas que pediram o seu feedback) e Pedidos que eu fiz |
Cada feedback mora no espaço em que foi dado. Com vários espaços de Feedbacks, as caixas de um espaço mostram só os feedbacks e pedidos daquele espaço, e cada pessoa vê os seus nos espaços a que tem acesso. Perder o acesso a um espaço remove da vista o que foi dado nele. Os botões dos e-mails abrem o feedback ou o pedido no espaço dele.
Temas e comportamentos
Os temas dão um roteiro para pedir e escrever feedback. Cada tema (por exemplo, Comunicação) traz uma lista de comportamentos ("Escuta com atenção", "Mantém as pessoas informadas"). Tudo é opcional: sem tema, pedir e dar continuam como antes, em texto livre.
- O catálogo é da comunidade: vale em todos os espaços de Feedbacks dela.
- Toda comunidade começa com 5 temas, cada um com 6 comportamentos: Impacto no time, Comunicação, Entrega, Análise e tomada de decisões e Gestão de pessoas. O conjunto é criado no idioma da comunidade na primeira vez que o catálogo é aberto; depois o texto é da comunidade, e trocar o idioma não o traduz.
- O proprietário e o administrador gerenciam em Temas e comportamentos, na barra de gestão do espaço de Feedbacks: Novo tema (nome até 80 caracteres e Descrição (opcional) até 300), Novo comportamento (até 160), renomear, reordenar arrastando, Desativar e Ativar. Até 30 temas ativos e 20 comportamentos ativos por tema.
- Nada é apagado. Desativar remove o tema ou o comportamento da escolha em pedidos e feedbacks novos; os feedbacks antigos continuam mostrando o que foi escrito, e os números continuam contando.
- Moderador, financeiro e membro veem só os temas ativos, ao pedir e dar feedback.
Dar feedback
Em Dar feedback, escolha Para quem (uma pessoa por feedback, com acesso ao espaço; ninguém dá feedback a si mesmo) e escreva o Feedback, com formatação, até 5.000 caracteres. "Conte o que você observou, o efeito disso e o que sugere." O destinatário vê em Recebidos, você em Enviados.
Por tema: em vez do texto livre, escolha um ou mais temas em Ou escreva por tema, com um roteiro (opcional), até 10. Cada tema vira uma seção com três perguntas, O que você observou, Qual foi o impacto e O que sugere, e os comportamentos do tema para marcar em Comportamentos que você observou (opcional). Escreva em ao menos uma pergunta: pergunta em branco não aparece no texto, e seção sem nenhum texto sai inteira. Dá para remover uma seção ou Adicionar outro tema; remover todas volta ao texto livre. Como a pessoa vai ler mostra o texto montado, com o nome do tema e as perguntas como títulos.
Pedir feedback
Em Pedir feedback, escolha a pessoa e, se quiser, uma Mensagem (até 1.000 caracteres): "Sobre o que você gostaria de ouvir?". Em Sobre o que você quer ouvir (opcional), escolha até 10 temas e, dentro deles, comportamentos: quem responde vê Temas pedidos no pedido e recebe o roteiro com eles. O pedido vai para Pedidos dos dois e fica Pendente. Quem foi pedido pode:
- Responder: escreve o feedback, que chega ligado ao pedido ("Em resposta ao seu pedido"). O pedido fica Respondido. Se o pedido tem temas, a resposta já abre com uma seção por tema pedido, e os comportamentos pedidos aparecem marcados como pedido; dá para remover seções, adicionar outros temas ou voltar ao texto livre.
- Recusar: o pedido fica Recusado, sem e-mail, e não pode mais ser respondido.
Quem pediu pode Cancelar pedido enquanto ele está pendente (fica Cancelado, sem e-mail). Respondido, recusado ou cancelado, o pedido não muda mais. Há um pedido pendente por vez entre as mesmas duas pessoas em cada espaço; a resposta entra no espaço do pedido.
Feedback sobre outra pessoa
O líder ouve os colegas sobre alguém do seu time, e um colega conta ao líder algo sobre uma pessoa. Os dois caminhos têm duas partes:
| Parte | Quem lê | O que leva |
|---|---|---|
| Feedback interno | O autor, quem pediu (no pedido) e o líder direto da pessoa no momento em que o feedback foi escrito | O texto, livre ou por tema, com o roteiro e os comportamentos, como num feedback direto. Obrigatório |
| Mensagem para a pessoa | O autor e a própria pessoa, com o nome de quem escreveu | Um recado à pessoa, até 5.000 caracteres. Opcional: sem mensagem, a pessoa não vê nada |
- A pessoa nunca lê o feedback interno, nem sabe que foi indicada ou que alguém escreveu sobre ela: só é avisada quando há mensagem.
- Um líder novo não herda: se o líder da pessoa mudar depois, o feedback continua com quem o leu quando foi escrito.
- Não é anônimo: o líder vê o autor do interno, e a pessoa vê o autor da mensagem.
- O proprietário e o administrador que não pediram, os outros indicados e o suporte da Memberfy não leem nenhuma das partes.
Pedir sobre um liderado. Em Pedidos, clique em Pedir sobre um liderado (ou, em Pedir feedback, escolha Sobre um liderado em Sobre quem é o pedido): escolha Sobre quem e, em Quem você quer ouvir, os colegas, com a Mensagem e os temas opcionais. Pode pedir o líder direto da pessoa (definido no organograma) e o proprietário ou o administrador, sobre qualquer pessoa; o líder indireto, não. Os indicados precisam ter acesso ao espaço e não podem ser a própria pessoa nem o líder dela. Cada indicado recebe um pedido próprio, vê "Fulano pediu o seu feedback sobre Beltrano" e não sabe quem mais foi indicado.
- Limite de indicações: o contador mostra "3 de 5 indicações". O proprietário e o administrador definem o limite em Máximo de indicações por pedido, na criação e na edição do espaço: de 1 a 20; vazio volta ao padrão, 5.
- O cartão do pedido ("Você pediu feedback sobre Beltrano") mostra "2 de 5 responderam" e o status de cada indicado (Pendente, Respondido, Recusado, Cancelado); quem pediu cancela um indicado pendente sem mexer nos outros, sem e-mail.
- O indicado responde com as duas partes (o interno com o roteiro dos temas pedidos, se houver; a mensagem, opcional) ou recusa. Uma recusa fica registrada e nunca é apagada.
- Há um pedido pendente por vez do mesmo líder, sobre a mesma pessoa, ao mesmo colega.
Dar feedback sobre alguém. Em Recebidos ou Enviados, clique em Sobre alguém (ou, em Dar feedback, escolha Sobre alguém em Para quem é o feedback): escolha Sobre quem, escreva o Feedback interno e, se quiser, a Mensagem para a pessoa. Qualquer pessoa com acesso ao espaço pode, sobre um colega que também tem; o interno vai ao líder direto do colega, que o lê em Recebidos e pode Agradecer.
- Colega sem líder definido: o feedback não sai, com a mensagem "Fulana não tem líder definido; dê o feedback direto a essa pessoa ou peça ao owner ou a um admin para definir o líder". Se o líder não tem acesso ao espaço, também não sai: "O líder de Fulana não tem acesso a este espaço de Feedbacks".
- Se o líder for você, dê o feedback direto à pessoa. Ninguém dá feedback sobre si mesmo.
Nos cartões e nas listas. O feedback leva a marca Sobre Beltrano. O líder e quem pediu leem o interno ("Fulano te deu um feedback sobre Beltrano"); a pessoa vê só "Fulano te deixou uma mensagem". Recebidos, Enviados e Pedidos filtram em Todos, Diretos e Sobre outras pessoas. O autor apaga o que deu, e somem as duas partes para todos.
Os temas nos cartões
O cartão do feedback mostra Temas, com os comportamentos marcados, e o do pedido mostra Temas pedidos. Como o próprio feedback, só autor e destinatário veem esses cartões.
Agradecer e apagar
- O destinatário clica em Agradecer uma vez; o autor vê "Fulano agradeceu".
- Só o autor apaga o próprio feedback (Apagar feedback); ele some para os dois. O destinatário não apaga o do outro.
Os e-mails
Os e-mails nunca levam o texto, só quem enviou e o botão para ler no app (um e-mail pode ser encaminhado; o texto fica no app, com a regra de quem lê).
| Quando | Quem recebe |
|---|---|
| Alguém te dá um feedback | O destinatário: Fulano te deu um feedback |
| Alguém pede o seu feedback | Quem foi pedido: Fulano pediu o seu feedback |
| O seu pedido é respondido | Quem pediu |
| Alguém pede o seu feedback sobre uma pessoa | O indicado: Fulano pediu o seu feedback sobre uma pessoa do time |
| Um indicado responde | Quem pediu: Fulano respondeu o seu pedido de feedback sobre uma pessoa do time |
| Alguém dá feedback sobre uma pessoa do seu time | O líder: Fulano te enviou um feedback sobre uma pessoa do seu time |
| O feedback sobre alguém tem mensagem | A pessoa: Fulano te deixou uma mensagem |
Os e-mails também não listam os temas, e nunca levam o nome da pessoa sobre quem é o feedback (o nome fica no app). A pessoa só é avisada quando há mensagem. Recusa e cancelamento não mandam e-mail. Todos são da categoria Feedbacks, ligada por padrão; quem a desligou em E-mails desta comunidade não recebe, e o rodapé desliga só essa categoria num clique. Saem 10 minutos depois, pela fila, no idioma de quem recebe.
Os números
A barra Gerenciar feedbacks, do proprietário e do administrador, mostra os feedbacks dos últimos 30 dias, a adesão e os pedidos pendentes, e abre Números desse espaço: por período (até 366 dias, no fuso da comunidade) e por grupo, Feedbacks dados (espontâneos e respostas a pedidos), Pedidos, Pendentes, Respondidos, Recusados, Cancelados e a Adesão (quantas das pessoas com acesso ao espaço deram ao menos um). Nenhum texto, autor ou destinatário. Moderador, financeiro e membro não veem os números.
Por tema: quantos feedbacks e pedidos citaram cada tema e cada comportamento, no período. Para proteger quem recebe feedback:
- contagem de 1 ou 2 aparece como < 3; e, quando só um número de um conjunto ficaria escondido, o menor dos outros também aparece como < 3, para não dar para descobrir o escondido por subtração;
- com um grupo escolhido, o bloco não aparece: os números por tema são só do espaço inteiro (ou da comunidade), no período, nunca por grupo nem por pessoa.
Diretos e sobre outra pessoa: os números se dividem em Diretos e Sobre outra pessoa: Feedbacks dados (Espontâneos e Respostas a pedidos), Com mensagem para a pessoa e Sem mensagem, Pedidos, Indicados, Pendentes, Respondidos, Recusados e Cancelados. Nos pedidos sobre outra pessoa, os status contam cada indicado. Com um grupo escolhido, conta também o feedback sobre uma pessoa do grupo. Nunca texto, nunca por pessoa.
Exportar os números
Na janela Números, o proprietário e o administrador baixam o que está na tela em Baixar CSV ou Baixar Excel, com o período e o grupo escolhidos. O arquivo traz só números: os filtros, os totais, a adesão, os diretos e os sobre outra pessoa, e os números por tema e por comportamento, com a mesma proteção da tela (contagem de 1 ou 2 sai como < 3; com um grupo, sem o bloco por tema). Nunca texto, autor ou destinatário. Os rótulos vêm no idioma de quem baixa. Moderador, financeiro e membro não baixam. Acima de 2.000 linhas, o arquivo é preparado em segundo plano e o link para baixá-lo, válido por 72 horas, chega por e-mail a quem exportou; a tela avisa "Seu arquivo está sendo preparado; o link chega por e-mail em …". O link do e-mail abre o app e pede login: só quem pediu a exportação, e que ainda tem o papel para ela, consegue baixar. O arquivo fica disponível por 72 horas e depois é apagado. Até 2.000 linhas, o download é na hora, como antes.
Passo a passo
Criar o espaço
- No menu, abra Adicionar Espaço e escolha a aba Planejamento & RH.
- Escolha Feedbacks e clique em Próximo. Não há a pergunta "um ou vários".
- Dê nome, ícone e quem tem acesso. Quem tem acesso ao espaço é quem pode dar e receber feedback.
Pedir e responder
- Ana abre o espaço, clica em Pedir feedback, escolhe Bruno e escreve "Sobre a apresentação de ontem".
- Bruno recebe o e-mail, abre Pedidos › Pedidos para mim e clica em Responder.
- Ana recebe o aviso, lê o feedback em Recebidos e clica em Agradecer.
Ouvir os colegas sobre um liderado
- Carla, líder de Bruno, abre Pedidos › Pedir sobre um liderado, escolhe Bruno em Sobre quem e indica Ana e Diego em Quem você quer ouvir.
- Ana e Diego recebem "Carla pediu o seu feedback sobre uma pessoa do time". Ana responde com o feedback interno e deixa uma mensagem a Bruno; Diego recusa.
- Carla lê o feedback de Ana em Recebidos, marcado Sobre Bruno; o cartão do pedido mostra "1 de 2 responderam". Bruno recebe só a mensagem de Ana, com o nome dela.
Pelo assistente (MCP)
As ferramentas cobrem: listar recebidos e enviados, abrir um feedback, buscar a pessoa, dar feedback (create_feedback, com dry_run para ver antes quem recebe o aviso), agradecer, listar e abrir pedidos, pedir feedback, responder, recusar, e, com confirmação, apagar o próprio feedback e cancelar o próprio pedido. O proprietário e o administrador consultam os números (get_feedback_dashboard).
Quem abre o espaço lista os temas (list_feedback_themes); o proprietário e o administrador criam, editam, reordenam e desativam temas e comportamentos (6 ferramentas). create_feedback_request aceita themes e behaviors; create_feedback e answer_feedback_request aceitam sections (uma por tema, com as três perguntas em Markdown e os comportamentos observados), e o dry_run mostra o texto montado (body_preview). get_feedback_dashboard traz os números por tema. Com mais de um espaço de Feedbacks, o assistente pergunta em qual (space_id) ao dar, pedir e buscar pessoas; as listas sem space_id juntam os espaços que a pessoa abre, e os números sem space_id somam todos. O assistente só lê os feedbacks da própria pessoa conectada, e o texto nunca vai para o registro do que ele faz. Sobre outra pessoa: create_feedback_about_request pede sobre um liderado (a pessoa e os indicados, com dry_run para ver quem recebe o aviso e o limite); create_feedback aceita about (no lugar da pessoa que recebe) e message_to_person, e answer_feedback_request, message_to_person; as listas filtram com about; get_feedback_settings lê o limite e update_feedback_settings (proprietário e administrador) o muda. A mensagem, como o texto, nunca vai para o registro. São 23 ferramentas no total. Ver Ferramentas · Membros › Feedbacks.
get_feedback_dashboard com format: "csv" devolve os mesmos números em CSV (o Excel fica no app). Ver a receita Baixe os números de feedback em CSV. Acima de 2.000 linhas, o arquivo não volta na conversa: a resposta traz status: "queued", rows e email, e o assistente diz para qual endereço vai o e-mail com o link (válido por 72 horas).
Erros comuns e como resolver
| Situação | Por quê | O que fazer |
|---|---|---|
| Não acho o colega | Ele não tem acesso ao espaço, ou é você | Mude o acesso do espaço |
| Como administrador, não consigo ler um feedback | Só quem deu e quem recebeu leem | É assim por desenho; veja os Números |
| Um tema sumiu da escolha | Ele foi desativado | O proprietário ou o administrador o ativa em Temas e comportamentos |
| Não consigo responder um pedido | Ele foi recusado ou cancelado | Peça ou dê um feedback novo |
| "Fulana não tem líder definido" ao dar feedback sobre alguém | A pessoa não tem líder no organograma | Dê o feedback direto à pessoa, ou peça ao proprietário ou ao administrador para definir o líder |
| "Só o líder direto da pessoa, o owner ou um admin podem pedir feedback sobre ela" | Você não é o líder direto da pessoa (o líder indireto não pede) | Peça ao líder direto, ou peça feedback sobre você |
| "Indique até 5 colegas por pedido" | O pedido passou do Máximo de indicações por pedido do espaço | Indique menos colegas, ou o proprietário ou o administrador aumenta o limite |
| A pessoa não vê o feedback que dei sobre ela | Ela lê só a Mensagem para a pessoa; o interno é do líder | É assim por desenho; escreva uma mensagem se quiser que ela leia algo |
| Não acho um feedback que recebi | Ele foi dado em outro espaço de Feedbacks, ou você perdeu o acesso ao espaço dele | Abra o outro espaço |
| "Escolha o espaço de Feedbacks: 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: "feedbacks", e a comunidade pode ter vários. As rotas ficam em /api/feedbacks, com o X-CommunityId: GET /api/feedbacks?box=received|sent, POST /api/feedbacks, GET e DELETE /api/feedbacks/{id}, POST /api/feedbacks/{id}/thank, GET /api/feedbacks/people, os pedidos em GET e POST /api/feedbacks/requests (box, status), GET /api/feedbacks/requests/{id} e POST /api/feedbacks/requests/{id}/answer, /decline e /cancel, e os números em GET /api/feedbacks/dashboard (from, to, groupId, spaceId). Um feedback ou pedido que não é seu volta 404, também para o proprietário e o administrador.
Vários espaços: GET e POST /api/feedbacks, /people, GET e POST /api/feedbacks/requests e /dashboard aceitam spaceId. Com um espaço só, ele é opcional e nada muda; com vários, dar, pedir e buscar pessoas sem ele volta 422 (spaceRequired). As listas sem spaceId juntam os espaços que a pessoa abre; os números sem spaceId somam todos e devolvem spaceId: null. Feedbacks e pedidos trazem spaceId, e as rotas por id conferem o espaço do próprio item: quem não abre esse espaço recebe 403.
| Erro | Quando |
|---|---|
403 | Sem acesso ao espaço, apagar o feedback de outra pessoa, números sem ser proprietário ou administrador, ou qualquer rota pessoal (todas menos os números) numa sessão de suporte da Memberfy |
404 | Não há espaço de Feedbacks, o spaceId não é um deles, ou o feedback ou pedido não existe, não é seu ou é de um espaço apagado |
409 | Um segundo pedido pendente para a mesma pessoa no mesmo espaço, ou mudar um pedido já respondido, recusado ou cancelado |
422 | Feedback a si mesmo, a quem não tem acesso ao espaço ou de outra comunidade, texto vazio ou acima do limite, ou sem spaceId numa comunidade com vários espaços (spaceRequired) |
Temas e comportamentos: GET /api/feedbacks/themes (quem abre um espaço de Feedbacks; includeInactive para o proprietário e o administrador), POST /api/feedbacks/themes, PUT /api/feedbacks/themes/order, PUT /api/feedbacks/themes/{themeId}, POST /api/feedbacks/themes/{themeId}/behaviors, PUT /api/feedbacks/themes/{themeId}/behaviors/order e PUT /api/feedbacks/themes/{themeId}/behaviors/{behaviorId} (escrita só do proprietário e do administrador; os outros papéis recebem 403). POST /api/feedbacks/requests aceita themeIds e behaviorIds; POST /api/feedbacks e POST /api/feedbacks/requests/{id}/answer aceitam sections[] (themeId, observed, impact, suggestion, behaviorIds) no lugar de body, e a API monta o texto; POST /api/feedbacks/preview monta sem gravar. Feedbacks e pedidos trazem themes (e o feedback, requestThemes), só para as duas pessoas; o painel traz byTheme, com null no lugar das contagens de 1 e 2 e byTheme: null com groupId. body e sections juntos voltam 422 (bodyAndSections); todas as seções vazias, 422 (sectionsEmpty); tema inativo ou de outra comunidade, 422.
Sobre outra pessoa: POST /api/feedbacks/requests aceita subjectId + giverIds[] e cria um pedido por indicado, com o mesmo roundId, tudo ou nada; POST /api/feedbacks aceita subjectId no lugar de recipientId (vai ao líder direto) e messageToSubject (a mensagem para a pessoa), que POST /api/feedbacks/requests/{id}/answer também aceita. GET /api/feedbacks/settings lê e PUT /api/feedbacks/settings (proprietário e administrador) muda maxNominees (1 a 20, padrão 5). Feedbacks trazem about, subject, subjectLeader, messageToSubject e viewerRole (para a pessoa: subject, com body nulo); pedidos, about, subject e roundId; as listas aceitam about=true|false; o painel traz byKind (direct, about). Quem pede sem ser o líder direto nem da equipe: 403 (aboutDenied); indicados demais, repetidos, a pessoa ou o líder dela, sobre si mesmo, ou pessoa sem líder: 422 (tooManyNominees, nomineeRepeated, nomineeIsSubject, nomineeIsLeader, aboutSelf, subjectNoLeader, leaderNoAccess, subjectIsYourReport); indicado com pedido pendente do mesmo líder sobre a mesma pessoa: 409 (aboutPending). A pessoa, outro indicado, um líder novo e a equipe que não pediu recebem 404 no interno.
Exportar: GET /api/feedbacks/dashboard/export?format=csv|xlsx, com os mesmos from, to, groupId e spaceId do painel, só para o proprietário e o administrador (403 para os outros). O arquivo se chama feedbacks-AAAA-MM-DD_AAAA-MM-DD.