Levar os resultados da avaliação de desempenho

A avaliação de desempenho roda inteira na TAI: o RH monta o ciclo (90, 180 ou 360 graus), os avaliadores respondem, o ciclo é consolidado e publicado. A integração começa quando o resultado existe — remuneração variável, plano de sucessão, people analytics e BI precisam das notas sem ninguém exportar planilha à mão.


Quando usar	Bônus e mérito calculados em outro sistema, painéis de people analytics, histórico de desempenho no seu data warehouse
Porta	Webhook assinando eventos · REST · Agente (MCP)
Você vai precisar	Módulo `DESEMPENHO`; permissão `AVALIACAO_DESEMPENHO` (ciclos e resultados) e `NINEBOX_AVALIAR` (matriz 9-Box); token JWT de um usuário de integração; dono da conta ou administrador para criar o webhook

Como funciona

RH publica o ciclo na TAI ──▶ evento TALENTOS_CICLO_PUBLICADO (cicloId)
        │
        ▼
webhook assinado ──▶ POST no seu sistema (novas tentativas por ~21 h)
        │
        ▼
seu sistema ── GET /avaliacao-desempenho/resultado/ciclo/{cicloId}/ranking ──▶ TAI
            ── GET .../por-area · .../por-competencia · .../exportar ────────▶ TAI

O ciclo passa por PREPARACAO → EM_AVALIACAO → CONSOLIDACAO → PUBLICADO (ou CANCELADO). As rotas de resultado leem avaliações consolidadas: com o ciclo ainda em coleta, elas respondem lista vazia, com aviso.

Passo a passo

Receba o aviso da publicação. Em Processos › Central de Automações, aba Webhooks, crie um Novo webhook com o endereço do seu sistema e assine Os resultados de uma avaliação são publicados (TALENTOS_CICLO_PUBLICADO) — veja Assinar eventos. O seu sistema recebe:
```
{
  "id": "evt_62107",
  "tipo": "TALENTOS_CICLO_PUBLICADO",
  "descricao": "Os resultados de uma avaliação são publicados",
  "versao": 1,
  "ocorridoEm": "2026-10-06T18:45:12.390Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": { "cicloId": 27 }
}
```
Confira a assinatura, responda 2xx na hora e leia os resultados (passos 2 a 5) numa fila sua. O evento traz só o cicloId: as notas vêm da API.

Para acompanhar o ciclo antes da publicação, os mesmos webhooks aceitam Um ciclo de avaliação é aberto (TALENTOS_CICLO_ABERTO), A coleta de um ciclo de avaliação é encerrada (TALENTOS_COLETA_ENCERRADA) e Uma avaliação é respondida (AVALIACAO_FORMULARIO_CONCLUIDO) — veja o catálogo.

Sem webhook, consulte GET /avaliacao-desempenho/ciclo de tempos em tempos: a lista traz todos os ciclos, do mais recente ao mais antigo, com status, modalidade (G90, G180, G360) e publicadoEm.
Leia a nota de cada pessoa.
```
GET /avaliacao-desempenho/resultado/ciclo/27/ranking
Authorization: Bearer $TAI_TOKEN
```
Cada linha traz avaliacaoId, avaliado, gestor, cargoNome, departamentoNome, notaFinal, notaGestor, notaAuto, gapAutoGestor, nivelDesempenhoDerivado, temDevolutiva e cienciaDada — nenhum comentário. limite restringe o número de linhas.

Leia os agregados.

Rota	Traz
`GET .../ciclo/{cicloId}/por-area?nivel=DEPARTAMENTO`	Média, gap e distribuição por nível, por área. `nivel`: `SETOR`, `DEPARTAMENTO`, `SUB_DEPARTAMENTO`, `CARGO` ou `GESTOR`
`GET .../ciclo/{cicloId}/por-competencia`	Média de cada competência, por fonte, e quantos ficaram abaixo do limiar
`GET .../ciclo/{cicloId}/distribuicao`	Quantos em cada nível, a curva das notas e o gap de percepção
`GET .../ciclo/{cicloId}/exportar`	Planilha `.xlsx` com as abas Pessoas, Competências, Áreas e Sobre

O prefixo é /avaliacao-desempenho/resultado. Linhas de área com pouca gente vêm com poucosDados: true e um aviso pronto.

Monte o histórico. Para a série de uma pessoa entre ciclos publicados:
```
GET /avaliacao-desempenho/resultado/colaborador/1043/historico
```
Leve o 9-Box, se o ciclo usa. A grade do ciclo, com as pessoas de cada quadrante:
```
GET /nine-box/matriz?cicloId=27
```
Filtros opcionais: setorId, departamentoId, cargoId, gestorId. Para o histórico de posição de uma pessoa, GET /nine-box/matriz/colaborador/{colaboradorId}/historico. Para saber das mudanças sem reler a grade, assine Um colaborador muda de quadrante no 9-Box (NINEBOX_POSICAO_MOVIDA, com colaboradorId, cicloId e origem) e Uma sessão de calibração é encerrada (NINEBOX_CALIBRACAO_ENCERRADA).

Automatize

Rotina	O que faz	Começa ligada?
Lembrete da avaliação de desempenho (`avdesempenho-lembrete`)	Todo dia, lembra os avaliadores com avaliação pendente no ciclo aberto	Sim
Cadência de registros (`talentos-registro-cadencia`)	Lembra o gestor dos registros de acompanhamento de competência na cadência configurada	Sim
Rodada do radar de retenção (`radar-rodada`)	Toda semana, recalcula o risco de saída de cada colaborador	Sim

Para cobrar avaliadores fora da rotina, POST /avaliacao-desempenho/ciclo/{id}/lembrar lembra agora quem ainda não avaliou (no máximo um lembrete por pessoa por dia), e GET /avaliacao-desempenho/ciclo/{id}/acompanhamento mostra quem falta, por avaliador.

Pelo seu agente de IA

“Como o departamento Comercial foi no último ciclo de avaliação, por competência? Compare com o ciclo anterior.”

O agente lê ciclos e agregados. Abrir e consolidar ciclo, concluir avaliação, registrar devolutiva e mover alguém no 9-Box são atos de confirmação forte: o MCP não os executa — eles ficam na plataforma, com autoria de quem decide. Veja Escrita e segurança.

Cuidados

Comentários não saem por aqui. Ranking, agregados e planilha trazem números e níveis; o texto que um avaliador escreveu sobre um colega fica na plataforma.
Fontes anônimas são agregadas. Pares, liderados e clientes internos aparecem como média e contagem, nunca com nome; abaixo do mínimo da fonte (3 por padrão), a fonte inteira é suprimida no resultado individual.
Republicação não avisa. Um ciclo pode ser reaberto (POST .../ciclo/{id}/reabrir) e publicado de novo, mas o evento sai uma vez por ciclo: a segunda publicação não gera outro aviso. Se o seu sistema guarda os resultados, confira publicadoEm na lista de ciclos de tempos em tempos e, quando mudar, substitua os dados daquele cicloId em vez de somar.
Quem vê o quê. Ranking, agregados e planilha cobrem o ciclo inteiro para quem tem AVALIACAO_DESEMPENHO. A matriz 9-Box e o histórico individual são recortados pelo alcance do usuário (a grade informa o recorte em alcance): use um usuário de integração com acesso de RH.
A planilha é binária: trate a resposta de /exportar como arquivo — veja Datas e formatos.

Referência gerada do contrato da API em 30 de outubro de 2026. taitecnologia.com · Termos de uso · Privacidade