Acompanhar feedback e reuniões 1:1

Feedback e reuniões 1:1 acontecem na TAI, entre pessoas: quem escreve o feedback é quem assina, e quem conduz a 1:1 é o gestor. O que sai para outros sistemas são os indicadores — quantas pessoas recebem feedback, quantos gestores fazem 1:1, quem está esquecido — e o mural de elogios públicos, que pode aparecer na intranet ou numa TV da empresa.

Quando usar	Painel de people analytics, metas de liderança (gestor que dá feedback e faz 1:1), mural de reconhecimento fora da TAI
Porta	REST · Webhook assinando eventos · Agente (MCP)
Você vai precisar	Módulo DESEMPENHO; permissão FEEDBACK (painel de feedback) e REUNIAO (painel de 1:1); para o mural, qualquer usuário do módulo; token JWT de um usuário de integração

Como funciona

seu BI ── GET /feedback/painel/indicadores?dias=90 ─────▶ TAI  (totais, adesão, por área, série mensal)
seu BI ── GET /feedback/painel/sem-feedback?dias=45 ────▶ TAI  (quem está sem feedback)
seu BI ── GET /reuniao/painel/adesao?dias=90 ───────────▶ TAI  (1:1 marcadas × realizadas, por área)
seu BI ── GET /reuniao/painel/sem-reuniao ──────────────▶ TAI  (quem está há mais tempo sem 1:1)
intranet ─ GET /feedback/mural?dias=30 ─────────────────▶ TAI  (elogios públicos)

Passo a passo

1. Indicadores de feedback. dias é a janela (padrão 90, até 730).

   GET /feedback/painel/indicadores?dias=90
   Authorization: Bearer $TAI_TOKEN

   Traz total, elogios, desenvolvimento, publicos, privados, privadosGestor, pessoasComFeedback e percentualPessoasComFeedback, gestoresQueDeram e adesaoGestores, pedidos e pedidosRespondidos, além das listas porArea, competencias e serieMensal.

2. Quem está sem feedback.

   GET /feedback/painel/sem-feedback?dias=45

   Uma linha por pessoa sem feedback recebido há mais de dias (padrão 45), com ultimoRecebidoEm, diasSemFeedback e gestorNome.

3. Adesão às 1:1.

   GET /reuniao/painel/adesao?dias=90

   Traz agendadas, realizadas, naoRealizadas, canceladas, adesaoPct, gestoresComRecorrencia, pessoasSemRecorrencia e a lista areas. Para quem está esquecido, GET /reuniao/painel/sem-reuniao devolve pessoa, gestor, ultimaRealizadaEm, diasSemReuniao e temRecorrencia.

4. Mural de elogios. Só elogios marcados como públicos, os mais recentes primeiro:

   GET /feedback/mural?page=0&size=20&dias=30

   Filtros opcionais: departamentoId e competenciaId. Cada item traz autor, destinatario, texto, competencias e reacoes. Com o mural desligado na política de feedback da empresa, a lista vem vazia.

Feedback escrito em outro canal

POST /feedback registra um feedback em nome de quem está autenticado — o autor é o dono do token. Um usuário de integração enviando por todo mundo assinaria todos os feedbacks; por isso o caminho para quem quer dar feedback de outra ferramenta (o chat da empresa, um assistente de IA) é o agente de cada pessoa, conectado com a credencial dela.

O corpo, para referência:

{
  "destinatarioId": 1051,
  "tipo": "ELOGIO",
  "modelo": "LIVRE",
  "visibilidade": "PUBLICO",
  "texto": "A apresentação para o cliente ficou impecável.",
  "competenciaIds": [3]
}

tipo é ELOGIO ou DESENVOLVIMENTO; modelo é LIVRE, SCI (situacao, comportamento, impacto) ou PARAR_CONTINUAR_COMECAR (parar, continuar, comecar); visibilidade é PUBLICO (mural, só para elogio), PRIVADO ou PRIVADO_GESTOR. A pessoa que recebe é avisada por e-mail.

Receber cada fato no seu sistema

Os painéis respondem “como estamos”; para saber de cada fato na hora, assine os eventos num webhook:

Evento	dados
Um feedback é enviado (FEEDBACK_ENVIADO)	feedbackId, colaboradorId, remetenteId, visibilidade, tipo, pedidoId
Um feedback é pedido (FEEDBACK_PEDIDO_SOLICITADO), respondido (FEEDBACK_PEDIDO_RESPONDIDO), recusado (FEEDBACK_PEDIDO_RECUSADO)	pedidoId, colaboradorId, solicitanteId, destinatarioId
Uma 1:1 é agendada (REUNIAO_AGENDADA), encerrada (REUNIAO_REALIZADA), não acontece (REUNIAO_NAO_REALIZADA), cancelada (REUNIAO_CANCELADA)	reuniaoId, colaboradorId, gestorId, serieId, dataPrevista

Os eventos de feedback levam ids e o tipo, nunca o texto. Um mural na intranet que se atualiza sozinho, por exemplo, assina FEEDBACK_ENVIADO e, quando visibilidade é PUBLICO, relê GET /feedback/mural. Para avisar o gestor no chat da empresa a cada 1:1 que não aconteceu, use um fluxo automatizado com o evento e o bloco Chamar outro sistema — veja Da TAI para o seu sistema.

Automatize

Rotina	O que faz	Começa ligada?
Lembrete de pedidos de feedback (feedback-pedido-lembrete)	Todo dia, lembra quem recebeu um pedido de feedback e ainda não respondeu, e expira os pedidos vencidos	Sim
Feedback do gestor (feedback-nudge-gestor)	Toda semana, lembra o gestor de dar feedback à equipe quando passa tempo demais sem registro	Sim

As duas ficam em Processos › Central de Automações › Rotinas dos módulos. A política (prazos, mural, visibilidades permitidas) fica em Desempenho → Feedback e reconhecimento → Configurações.

Pelo seu agente de IA

“Mande um elogio público para a Ana Ribeiro pela apresentação de ontem, citando a competência Comunicação.”

Com escopo de escrita, o agente da própria pessoa registra o feedback em nome dela — o cliente de IA pede aprovação antes. Somente leitura, um gestor pode perguntar “quem do meu time está há mais de 30 dias sem feedback?”. Veja Escrita e segurança.

Cuidados

• Feedback privado não sai como texto. Nos painéis entram contagens; o conteúdo de um feedback privado só é lido por quem a política permite.
• Ler marca como lido. GET /feedback/recebidos marca os feedbacks do próprio usuário como lidos — não use essa rota numa integração de leitura em massa.
• Limites por dia. Cada pessoa tem um máximo de feedbacks por dia (definido na política da empresa) e um máximo por destinatário; o mesmo texto para a mesma pessoa em 24 horas é recusado como repetido. Esses 400 explicam o motivo na mensagem.
• Feedback enviado só muda em 24 horas e enquanto não foi lido (PUT e DELETE em /feedback/{id}).
• Painel não é extrato. Os indicadores são agregados da janela pedida; para séries, guarde uma leitura por dia ou use serieMensal.